{"title":"¿Qué es MCP?","slug":"what-is-mcp","category":"mcp","summary":"Model Context Protocol permite a los LLMs llamar a herramientas externas. Synapse expone 79 herramientas vía servidor MCP oficial.","audience":["human","llm"],"tags":["mcp","intro","overview"],"difficulty":"beginner","updated":"2026-06-27","word_count":612,"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":"es","translated":true,"requested_lang":"es","content_markdown":"\n# ¿Qué es MCP?\n\nEl **Model Context Protocol (MCP)** es un estándar abierto de Anthropic (2024)\nque permite a los LLMs llamar a herramientas externas de forma estructurada. En\nlugar de pegar documentación de la API en el prompt, registra herramientas con\nel servidor MCP, y el LLM las llama según sea necesario — como function\ncalling, pero estandarizado e independiente del cliente.\n\n## Servidor MCP de Synapse\n\nSynapse distribuye un servidor MCP oficial (`synapse-mcp-api` en npm) que\nexpone **79 herramientas** que cubren todas las características de Synapse:\n\n| Categoría | Herramientas | Cantidad |\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## Cómo funciona\n\n```\n┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘\n```\n\n1. Configura su cliente LLM (Claude Desktop, Cursor, etc.) para usar el servidor MCP de Synapse\n2. El cliente arranca el servidor MCP (vía `npx -y synapse-mcp-api@latest`)\n3. El servidor MCP se conecta a la API de Synapse usando su Mind Key\n4. El LLM ve las 79 herramientas como funciones nativas que puede llamar\n5. Cuando el LLM necesita recordar algo, llama a `memory_store` — el servidor MCP lo traduce a `POST /memory` en Synapse\n\n## Transportes\n\nEl servidor MCP de Synapse admite tres transportes:\n\n### stdio (local, recomendado para escritorio)\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 (remoto, multi-tenant)\n\nConecte su cliente MCP a:\n\n```\nURL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY\n```\n\n### WebSocket (móvil, alto volumen)\n\n```\nURL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY\n```\n\n## Tool Profiles (v1.4.0)\n\nPara reducir el overhead de tokens en LLMs más pequeños, el servidor MCP admite\ntres tool profiles:\n\n| Profile | Herramientas | Tokens | Mejor para |\n|---------|-------|--------|----------|\n| `minimal` | 8 (dispatch compuesto) | ~500 | LLMs autoalojados con ≤8k de contexto |\n| `standard` | 25 (con nombre) | ~2,500 | LLMs medianos (Claude Haiku, GPT-3.5) |\n| `full` | 119 (todas) | ~8,250 | LLMs grandes (Claude Sonnet/Opus, GPT-4) — predeterminado |\n\nControle mediante:\n\n- Variable de entorno: `MCP_PROFILE=minimal|standard|full`\n- Cabecera: `Mcp-Tool-Profile: minimal|standard|full`\n\n## Clientes compatibles\n\n- [Claude Desktop](/docs/mcp/claude-desktop) — app de escritorio de Anthropic\n- [Claude Code](/docs/mcp/claude-code) — agente de codificación de terminal\n- [Cursor](/docs/mcp/cursor) — IDE con IA\n- [Continue.dev](/docs/mcp/continue) — asistente de codificación con IA de código abierto\n- [Cline](/docs/mcp/claude-code) — extensión de VS Code\n- Cualquier cliente compatible con MCP\n\n## ¿Por qué usar MCP en lugar de la API directa?\n\n| Enfoque | Pros | Contras |\n|----------|------|------|\n| API directa | Sencillo, sin capa extra | El LLM necesita conocer URLs, cabeceras, auth |\n| MCP | El LLM ve herramientas nativas, sin memorizar URLs | Proceso de servidor MCP adicional |\n\nPara la mayoría de casos de uso de agentes LLM, MCP es la mejor opción — el\nLLM no necesita recordar rutas de API ni patrones de auth.\n\n## Próximos pasos\n\n- [Configuración de Claude Desktop](/docs/mcp/claude-desktop) — config en 2 minutos\n- [Configuración de Claude Code](/docs/mcp/claude-code) — integración con terminal\n- [Cliente MCP personalizado](/docs/mcp/custom-client) — construya el suyo\n","content_html":"<h1>¿Qué es MCP?</h1>\n<p>El <strong>Model Context Protocol (MCP)</strong> es un estándar abierto de Anthropic (2024)\nque permite a los LLMs llamar a herramientas externas de forma estructurada. En\nlugar de pegar documentación de la API en el prompt, registra herramientas con\nel servidor MCP, y el LLM las llama según sea necesario — como function\ncalling, pero estandarizado e independiente del cliente.</p>\n<h2>Servidor MCP de Synapse</h2>\n<p>Synapse distribuye un servidor MCP oficial (<code>synapse-mcp-api</code> en npm) que\nexpone <strong>79 herramientas</strong> que cubren todas las características de Synapse:</p>\n<table>\n<thead>\n<tr>\n<th>Categoría</th>\n<th>Herramientas</th>\n<th>Cantidad</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>Cómo funciona</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>Configura su cliente LLM (Claude Desktop, Cursor, etc.) para usar el servidor MCP de Synapse</li>\n<li>El cliente arranca el servidor MCP (vía <code>npx -y synapse-mcp-api@latest</code>)</li>\n<li>El servidor MCP se conecta a la API de Synapse usando su Mind Key</li>\n<li>El LLM ve las 79 herramientas como funciones nativas que puede llamar</li>\n<li>Cuando el LLM necesita recordar algo, llama a <code>memory_store</code> — el servidor MCP lo traduce a <code>POST /memory</code> en Synapse</li>\n</ol>\n<h2>Transportes</h2>\n<p>El servidor MCP de Synapse admite tres transportes:</p>\n<h3>stdio (local, recomendado para escritorio)</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 (remoto, multi-tenant)</h3>\n<p>Conecte su cliente MCP a:</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 (móvil, alto volumen)</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>Para reducir el overhead de tokens en LLMs más pequeños, el servidor MCP admite\ntres tool profiles:</p>\n<table>\n<thead>\n<tr>\n<th>Profile</th>\n<th>Herramientas</th>\n<th>Tokens</th>\n<th>Mejor para</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>minimal</code></td>\n<td>8 (dispatch compuesto)</td>\n<td>~500</td>\n<td>LLMs autoalojados con ≤8k de contexto</td>\n</tr>\n<tr>\n<td><code>standard</code></td>\n<td>25 (con nombre)</td>\n<td>~2,500</td>\n<td>LLMs medianos (Claude Haiku, GPT-3.5)</td>\n</tr>\n<tr>\n<td><code>full</code></td>\n<td>119 (todas)</td>\n<td>~8,250</td>\n<td>LLMs grandes (Claude Sonnet/Opus, GPT-4) — predeterminado</td>\n</tr>\n</tbody></table>\n<p>Controle mediante:</p>\n<ul>\n<li>Variable de entorno: <code>MCP_PROFILE=minimal|standard|full</code></li>\n<li>Cabecera: <code>Mcp-Tool-Profile: minimal|standard|full</code></li>\n</ul>\n<h2>Clientes compatibles</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Claude Desktop</a> — app de escritorio de Anthropic</li>\n<li><a href=\"/docs/mcp/claude-code\">Claude Code</a> — agente de codificación de terminal</li>\n<li><a href=\"/docs/mcp/cursor\">Cursor</a> — IDE con IA</li>\n<li><a href=\"/docs/mcp/continue\">Continue.dev</a> — asistente de codificación con IA de código abierto</li>\n<li><a href=\"/docs/mcp/claude-code\">Cline</a> — extensión de VS Code</li>\n<li>Cualquier cliente compatible con MCP</li>\n</ul>\n<h2>¿Por qué usar MCP en lugar de la API directa?</h2>\n<table>\n<thead>\n<tr>\n<th>Enfoque</th>\n<th>Pros</th>\n<th>Contras</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>API directa</td>\n<td>Sencillo, sin capa extra</td>\n<td>El LLM necesita conocer URLs, cabeceras, auth</td>\n</tr>\n<tr>\n<td>MCP</td>\n<td>El LLM ve herramientas nativas, sin memorizar URLs</td>\n<td>Proceso de servidor MCP adicional</td>\n</tr>\n</tbody></table>\n<p>Para la mayoría de casos de uso de agentes LLM, MCP es la mejor opción — el\nLLM no necesita recordar rutas de API ni patrones de auth.</p>\n<h2>Próximos pasos</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Configuración de Claude Desktop</a> — config en 2 minutos</li>\n<li><a href=\"/docs/mcp/claude-code\">Configuración de Claude Code</a> — integración con terminal</li>\n<li><a href=\"/docs/mcp/custom-client\">Cliente MCP personalizado</a> — construya el suyo</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"]}