Skip to main content

¿Qué es MCP?

Model Context Protocol permite a los LLMs llamar a herramientas externas. Synapse expone 79 herramientas vía servidor MCP oficial.


¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar abierto de Anthropic (2024) que permite a los LLMs llamar a herramientas externas de forma estructurada. En lugar de pegar documentación de la API en el prompt, registra herramientas con el servidor MCP, y el LLM las llama según sea necesario — como function calling, pero estandarizado e independiente del cliente.

Servidor MCP de Synapse

Synapse distribuye un servidor MCP oficial (synapse-mcp-api en npm) que expone 79 herramientas que cubren todas las características de Synapse:

Categoría Herramientas Cantidad
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
Chat poll, reply, status, history, unread, send, upload 7
Scheduler cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete 8
Tasks task_list, task_get, task_create, task_update 4
Scripts script_list, script_get, script_info, script_store, script_delete 5
Computers computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete 9
Push vapid_public_key, subscribe, unsubscribe, test 4
User/Mind register, login, minds_list, mind_create, mind_delete 5
Utility time, calc, random 3
Visualization graph, tags, compact 3
Sharing share, list, revoke 3
Webhooks register, list, get, update, delete 5
Browser new, navigate, click, type, screenshot, close 6
Total 79+

Cómo funciona

┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
  1. Configura su cliente LLM (Claude Desktop, Cursor, etc.) para usar el servidor MCP de Synapse
  2. El cliente arranca el servidor MCP (vía npx -y synapse-mcp-api@latest)
  3. El servidor MCP se conecta a la API de Synapse usando su Mind Key
  4. El LLM ve las 79 herramientas como funciones nativas que puede llamar
  5. Cuando el LLM necesita recordar algo, llama a memory_store — el servidor MCP lo traduce a POST /memory en Synapse

Transportes

El servidor MCP de Synapse admite tres transportes:

stdio (local, recomendado para escritorio)

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_...",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}

HTTP/SSE (remoto, multi-tenant)

Conecte su cliente MCP a:

URL: https://synapse-mcp.schaefer.zone/sse
Headers: Authorization: Bearer YOUR_MIND_KEY

WebSocket (móvil, alto volumen)

URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY

Tool Profiles (v1.4.0)

Para reducir el overhead de tokens en LLMs más pequeños, el servidor MCP admite tres tool profiles:

Profile Herramientas Tokens Mejor para
minimal 8 (dispatch compuesto) ~500 LLMs autoalojados con ≤8k de contexto
standard 25 (con nombre) ~2,500 LLMs medianos (Claude Haiku, GPT-3.5)
full 119 (todas) ~8,250 LLMs grandes (Claude Sonnet/Opus, GPT-4) — predeterminado

Controle mediante:

  • Variable de entorno: MCP_PROFILE=minimal|standard|full
  • Cabecera: Mcp-Tool-Profile: minimal|standard|full

Clientes compatibles

  • Claude Desktop — app de escritorio de Anthropic
  • Claude Code — agente de codificación de terminal
  • Cursor — IDE con IA
  • Continue.dev — asistente de codificación con IA de código abierto
  • Cline — extensión de VS Code
  • Cualquier cliente compatible con MCP

¿Por qué usar MCP en lugar de la API directa?

Enfoque Pros Contras
API directa Sencillo, sin capa extra El LLM necesita conocer URLs, cabeceras, auth
MCP El LLM ve herramientas nativas, sin memorizar URLs Proceso de servidor MCP adicional

Para la mayoría de casos de uso de agentes LLM, MCP es la mejor opción — el LLM no necesita recordar rutas de API ni patrones de auth.

Próximos pasos