# ¿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)

```json
{
  "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](/docs/mcp/claude-desktop) — app de escritorio de Anthropic
- [Claude Code](/docs/mcp/claude-code) — agente de codificación de terminal
- [Cursor](/docs/mcp/cursor) — IDE con IA
- [Continue.dev](/docs/mcp/continue) — asistente de codificación con IA de código abierto
- [Cline](/docs/mcp/claude-code) — 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

- [Configuración de Claude Desktop](/docs/mcp/claude-desktop) — config en 2 minutos
- [Configuración de Claude Code](/docs/mcp/claude-code) — integración con terminal
- [Cliente MCP personalizado](/docs/mcp/custom-client) — construya el suyo