{"title":"Qu'est-ce que MCP ?","slug":"what-is-mcp","category":"mcp","summary":"Le Model Context Protocol permet aux LLM d'appeler des outils externes. Synapse expose 79 outils via le serveur MCP officiel.","audience":["human","llm"],"tags":["mcp","intro","overview"],"difficulty":"beginner","updated":"2026-06-27","word_count":624,"read_minutes":3,"llm_context":"MCP = Model Context Protocol (Anthropic, 2024). Open standard for LLM-tool integration.\nSynapse has official MCP server: synapse-mcp-api (npm package, npx -y synapse-mcp-api@latest)\n79 tools exposed: 22 memory, 7 chat, 8 scheduler, 4 tasks, 5 scripts, 9 computers, 4 push, 5 user, 3 utility\n3 transports: stdio (local), HTTP/SSE (remote), WebSocket (mobile)\nSupported clients: Claude Desktop, Claude Code, Cursor, Continue, Cline, any MCP-compatible client\nTool Profiles (v1.4.0): minimal (8 tools), standard (25), full (119) — controlled via MCP_PROFILE env or Mcp-Tool-Profile header\n","lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Qu'est-ce que MCP ?\n\nLe **Model Context Protocol (MCP)** est un standard ouvert d'Anthropic (2024) qui\npermet aux LLM d'appeler des outils externes de manière structurée. Au lieu de coller\nla documentation de l'API dans le prompt, vous enregistrez des outils auprès du\nserveur MCP, et le LLM les appelle au besoin — comme du function calling, mais\nstandardisé et indépendant du client.\n\n## Serveur MCP Synapse\n\nSynapse fournit un serveur MCP officiel (`synapse-mcp-api` sur npm) qui expose\n**79 outils** couvrant toutes les fonctionnalités Synapse :\n\n| Catégorie | Outils | Nombre |\n|----------|-------|-------|\n| Memory | recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export | 22 |\n| Chat | poll, reply, status, history, unread, send, upload | 7 |\n| Scheduler | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |\n| Tasks | task_list, task_get, task_create, task_update | 4 |\n| Scripts | script_list, script_get, script_info, script_store, script_delete | 5 |\n| Computers | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |\n| Push | vapid_public_key, subscribe, unsubscribe, test | 4 |\n| User/Mind | register, login, minds_list, mind_create, mind_delete | 5 |\n| Utility | time, calc, random | 3 |\n| Visualization | graph, tags, compact | 3 |\n| Sharing | share, list, revoke | 3 |\n| Webhooks | register, list, get, update, delete | 5 |\n| Browser | new, navigate, click, type, screenshot, close | 6 |\n| **Total** | | **79+** |\n\n## Comment ça marche\n\n```\n┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘\n```\n\n1. Vous configurez votre client LLM (Claude Desktop, Cursor, etc.) pour utiliser le serveur MCP Synapse\n2. Le client démarre le serveur MCP (via `npx -y synapse-mcp-api@latest`)\n3. Le serveur MCP se connecte à l'API Synapse en utilisant votre Mind Key\n4. Le LLM voit les 79 outils comme des fonctions natives qu'il peut appeler\n5. Quand le LLM a besoin de se souvenir de quelque chose, il appelle `memory_store` — le serveur MCP traduit cela en `POST /memory` sur Synapse\n\n## Transports\n\nLe serveur MCP Synapse prend en charge trois transports :\n\n### stdio (local, recommandé pour desktop)\n\n```json\n{\n  \"mcpServers\": {\n    \"synapse\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n      \"env\": {\n        \"SYNAPSE_MIND_KEY\": \"mk_...\",\n        \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n      }\n    }\n  }\n}\n```\n\n### HTTP/SSE (distant, multi-tenant)\n\nConnectez votre client MCP à :\n\n```\nURL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY\n```\n\n### WebSocket (mobile, haut volume)\n\n```\nURL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY\n```\n\n## Tool Profiles (v1.4.0)\n\nPour réduire la surcharge de tokens pour les LLM plus petits, le serveur MCP prend en\ncharge trois profils d'outils :\n\n| Profil | Outils | Tokens | Idéal pour |\n|---------|-------|--------|----------|\n| `minimal` | 8 (dispatch composite) | ~500 | LLM auto-hébergés avec ≤8k de contexte |\n| `standard` | 25 (nommés) | ~2 500 | LLM de taille moyenne (Claude Haiku, GPT-3.5) |\n| `full` | 119 (tous) | ~8 250 | Grands LLM (Claude Sonnet/Opus, GPT-4) — par défaut |\n\nContrôlez via :\n\n- Variable d'env : `MCP_PROFILE=minimal|standard|full`\n- En-tête : `Mcp-Tool-Profile: minimal|standard|full`\n\n## Clients pris en charge\n\n- [Claude Desktop](/docs/mcp/claude-desktop) — application desktop d'Anthropic\n- [Claude Code](/docs/mcp/claude-code) — agent de codage terminal\n- [Cursor](/docs/mcp/cursor) — IDE alimenté par IA\n- [Continue.dev](/docs/mcp/continue) — assistant de codage IA open source\n- [Cline](/docs/mcp/claude-code) — extension VS Code\n- Tout client compatible MCP\n\n## Pourquoi utiliser MCP plutôt que l'API directe ?\n\n| Approche | Avantages | Inconvénients |\n|----------|------|------|\n| API directe | Simple, pas de couche supplémentaire | Le LLM doit connaître les URLs, en-têtes, auth |\n| MCP | Le LLM voit des outils natifs, pas de mémorisation d'URL | Processus serveur MCP supplémentaire |\n\nPour la plupart des cas d'usage d'agents LLM, MCP est le meilleur choix — le LLM n'a\npas besoin de mémoriser les chemins d'API ou les schémas d'auth.\n\n## Prochaines étapes\n\n- [Configuration Claude Desktop](/docs/mcp/claude-desktop) — config en 2 minutes\n- [Configuration Claude Code](/docs/mcp/claude-code) — intégration terminal\n- [Client MCP personnalisé](/docs/mcp/custom-client) — construisez le vôtre\n","content_html":"<h1>Qu&#39;est-ce que MCP ?</h1>\n<p>Le <strong>Model Context Protocol (MCP)</strong> est un standard ouvert d&#39;Anthropic (2024) qui\npermet aux LLM d&#39;appeler des outils externes de manière structurée. Au lieu de coller\nla documentation de l&#39;API dans le prompt, vous enregistrez des outils auprès du\nserveur MCP, et le LLM les appelle au besoin — comme du function calling, mais\nstandardisé et indépendant du client.</p>\n<h2>Serveur MCP Synapse</h2>\n<p>Synapse fournit un serveur MCP officiel (<code>synapse-mcp-api</code> sur npm) qui expose\n<strong>79 outils</strong> couvrant toutes les fonctionnalités Synapse :</p>\n<table>\n<thead>\n<tr>\n<th>Catégorie</th>\n<th>Outils</th>\n<th>Nombre</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Memory</td>\n<td>recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export</td>\n<td>22</td>\n</tr>\n<tr>\n<td>Chat</td>\n<td>poll, reply, status, history, unread, send, upload</td>\n<td>7</td>\n</tr>\n<tr>\n<td>Scheduler</td>\n<td>cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete</td>\n<td>8</td>\n</tr>\n<tr>\n<td>Tasks</td>\n<td>task_list, task_get, task_create, task_update</td>\n<td>4</td>\n</tr>\n<tr>\n<td>Scripts</td>\n<td>script_list, script_get, script_info, script_store, script_delete</td>\n<td>5</td>\n</tr>\n<tr>\n<td>Computers</td>\n<td>computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete</td>\n<td>9</td>\n</tr>\n<tr>\n<td>Push</td>\n<td>vapid_public_key, subscribe, unsubscribe, test</td>\n<td>4</td>\n</tr>\n<tr>\n<td>User/Mind</td>\n<td>register, login, minds_list, mind_create, mind_delete</td>\n<td>5</td>\n</tr>\n<tr>\n<td>Utility</td>\n<td>time, calc, random</td>\n<td>3</td>\n</tr>\n<tr>\n<td>Visualization</td>\n<td>graph, tags, compact</td>\n<td>3</td>\n</tr>\n<tr>\n<td>Sharing</td>\n<td>share, list, revoke</td>\n<td>3</td>\n</tr>\n<tr>\n<td>Webhooks</td>\n<td>register, list, get, update, delete</td>\n<td>5</td>\n</tr>\n<tr>\n<td>Browser</td>\n<td>new, navigate, click, type, screenshot, close</td>\n<td>6</td>\n</tr>\n<tr>\n<td><strong>Total</strong></td>\n<td></td>\n<td><strong>79+</strong></td>\n</tr>\n</tbody></table>\n<h2>Comment ça marche</h2>\n<pre><code class=\"hljs language-plaintext\">┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘</code></pre><ol>\n<li>Vous configurez votre client LLM (Claude Desktop, Cursor, etc.) pour utiliser le serveur MCP Synapse</li>\n<li>Le client démarre le serveur MCP (via <code>npx -y synapse-mcp-api@latest</code>)</li>\n<li>Le serveur MCP se connecte à l&#39;API Synapse en utilisant votre Mind Key</li>\n<li>Le LLM voit les 79 outils comme des fonctions natives qu&#39;il peut appeler</li>\n<li>Quand le LLM a besoin de se souvenir de quelque chose, il appelle <code>memory_store</code> — le serveur MCP traduit cela en <code>POST /memory</code> sur Synapse</li>\n</ol>\n<h2>Transports</h2>\n<p>Le serveur MCP Synapse prend en charge trois transports :</p>\n<h3>stdio (local, recommandé pour desktop)</h3>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;mcpServers&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n    <span class=\"hljs-attr\">&quot;synapse&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;command&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;npx&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;args&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-string\">&quot;-y&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-string\">&quot;synapse-mcp-api@latest&quot;</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;env&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_MIND_KEY&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_...&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_URL&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span>\n      <span class=\"hljs-punctuation\">}</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><h3>HTTP/SSE (distant, multi-tenant)</h3>\n<p>Connectez votre client MCP à :</p>\n<pre><code class=\"hljs language-plaintext\">URL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY</code></pre><h3>WebSocket (mobile, haut volume)</h3>\n<pre><code class=\"hljs language-plaintext\">URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY</code></pre><h2>Tool Profiles (v1.4.0)</h2>\n<p>Pour réduire la surcharge de tokens pour les LLM plus petits, le serveur MCP prend en\ncharge trois profils d&#39;outils :</p>\n<table>\n<thead>\n<tr>\n<th>Profil</th>\n<th>Outils</th>\n<th>Tokens</th>\n<th>Idéal pour</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>minimal</code></td>\n<td>8 (dispatch composite)</td>\n<td>~500</td>\n<td>LLM auto-hébergés avec ≤8k de contexte</td>\n</tr>\n<tr>\n<td><code>standard</code></td>\n<td>25 (nommés)</td>\n<td>~2 500</td>\n<td>LLM de taille moyenne (Claude Haiku, GPT-3.5)</td>\n</tr>\n<tr>\n<td><code>full</code></td>\n<td>119 (tous)</td>\n<td>~8 250</td>\n<td>Grands LLM (Claude Sonnet/Opus, GPT-4) — par défaut</td>\n</tr>\n</tbody></table>\n<p>Contrôlez via :</p>\n<ul>\n<li>Variable d&#39;env : <code>MCP_PROFILE=minimal|standard|full</code></li>\n<li>En-tête : <code>Mcp-Tool-Profile: minimal|standard|full</code></li>\n</ul>\n<h2>Clients pris en charge</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Claude Desktop</a> — application desktop d&#39;Anthropic</li>\n<li><a href=\"/docs/mcp/claude-code\">Claude Code</a> — agent de codage terminal</li>\n<li><a href=\"/docs/mcp/cursor\">Cursor</a> — IDE alimenté par IA</li>\n<li><a href=\"/docs/mcp/continue\">Continue.dev</a> — assistant de codage IA open source</li>\n<li><a href=\"/docs/mcp/claude-code\">Cline</a> — extension VS Code</li>\n<li>Tout client compatible MCP</li>\n</ul>\n<h2>Pourquoi utiliser MCP plutôt que l&#39;API directe ?</h2>\n<table>\n<thead>\n<tr>\n<th>Approche</th>\n<th>Avantages</th>\n<th>Inconvénients</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>API directe</td>\n<td>Simple, pas de couche supplémentaire</td>\n<td>Le LLM doit connaître les URLs, en-têtes, auth</td>\n</tr>\n<tr>\n<td>MCP</td>\n<td>Le LLM voit des outils natifs, pas de mémorisation d&#39;URL</td>\n<td>Processus serveur MCP supplémentaire</td>\n</tr>\n</tbody></table>\n<p>Pour la plupart des cas d&#39;usage d&#39;agents LLM, MCP est le meilleur choix — le LLM n&#39;a\npas besoin de mémoriser les chemins d&#39;API ou les schémas d&#39;auth.</p>\n<h2>Prochaines étapes</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Configuration Claude Desktop</a> — config en 2 minutes</li>\n<li><a href=\"/docs/mcp/claude-code\">Configuration Claude Code</a> — intégration terminal</li>\n<li><a href=\"/docs/mcp/custom-client\">Client MCP personnalisé</a> — construisez le vôtre</li>\n</ul>\n","urls":{"html":"/docs/mcp/what-is-mcp","text":"/docs/mcp/what-is-mcp?format=text","json":"/docs/mcp/what-is-mcp?format=json","llm":"/docs/mcp/what-is-mcp?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}