# O que é MCP?

O **Model Context Protocol (MCP)** é um padrão aberto da Anthropic (2024) que
permite aos LLMs chamar ferramentas externas de forma estruturada. Em vez de
colar docs de API no prompt, você registra ferramentas com o servidor MCP, e o
LLM as chama conforme necessário — como function calling, mas padronizado e
agnóstico de cliente.

## Servidor MCP do Synapse

O Synapse traz um servidor MCP oficial (`synapse-mcp-api` no npm) que expõe
**79 ferramentas** cobrindo todos os recursos do Synapse:

| Categoria | Ferramentas | Contagem |
|-----------|-------------|----------|
| Memória | 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 |
| Agendador | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |
| Tarefas | task_list, task_get, task_create, task_update | 4 |
| Scripts | script_list, script_get, script_info, script_store, script_delete | 5 |
| Computadores | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |
| Push | vapid_public_key, subscribe, unsubscribe, test | 4 |
| Usuário/Mind | register, login, minds_list, mind_create, mind_delete | 5 |
| Utilitários | time, calc, random | 3 |
| Visualização | graph, tags, compact | 3 |
| Compartilhamento | share, list, revoke | 3 |
| Webhooks | register, list, get, update, delete | 5 |
| Navegador | new, navigate, click, type, screenshot, close | 6 |
| **Total** | | **79+** |

## Como funciona

```
┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
```

1. Você configura seu cliente LLM (Claude Desktop, Cursor, etc.) para usar o servidor MCP do Synapse
2. O cliente inicia o servidor MCP (via `npx -y synapse-mcp-api@latest`)
3. O servidor MCP conecta-se à API do Synapse usando sua Mind Key
4. O LLM vê todas as 79 ferramentas como funções nativas que pode chamar
5. Quando o LLM precisa lembrar algo, ele chama `memory_store` — o servidor MCP traduz isso para `POST /memory` no Synapse

## Transportes

O servidor MCP do Synapse suporta três transportes:

### stdio (local, recomendado para desktop)

```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 seu cliente MCP a:

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

### WebSocket (mobile, alto volume)

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

## Tool Profiles (v1.4.0)

Para reduzir o overhead de tokens para LLMs menores, o servidor MCP suporta
três tool profiles:

| Profile | Ferramentas | Tokens | Melhor para |
|---------|-------------|--------|-------------|
| `minimal` | 8 (dispatch composto) | ~500 | LLMs auto-hospedados com contexto ≤8k |
| `standard` | 25 (nomeadas) | ~2.500 | LLMs médios (Claude Haiku, GPT-3.5) |
| `full` | 119 (todas) | ~8.250 | LLMs grandes (Claude Sonnet/Opus, GPT-4) — padrão |

Controle via:

- Env var: `MCP_PROFILE=minimal|standard|full`
- Cabeçalho: `Mcp-Tool-Profile: minimal|standard|full`

## Clientes suportados

- [Claude Desktop](/docs/mcp/claude-desktop) — app desktop da Anthropic
- [Claude Code](/docs/mcp/claude-code) — agente de codificação em terminal
- [Cursor](/docs/mcp/cursor) — IDE com IA
- [Continue.dev](/docs/mcp/continue) — assistente de codificação IA open-source
- [Cline](/docs/mcp/claude-code) — extensão do VS Code
- Qualquer cliente compatível com MCP

## Por que usar MCP em vez de API direta?

| Abordagem | Prós | Contras |
|-----------|------|---------|
| API direta | Simples, sem camada extra | LLM precisa saber URLs, headers, auth |
| MCP | LLM vê ferramentas nativas, sem memorizar URL | Processo extra de servidor MCP |

Para a maioria dos casos de uso de agentes LLM, MCP é a melhor escolha — o LLM
não precisa lembrar caminhos de API ou padrões de auth.

## Próximos passos

- [Configuração do Claude Desktop](/docs/mcp/claude-desktop) — config em 2 minutos
- [Configuração do Claude Code](/docs/mcp/claude-code) — integração com terminal
- [Cliente MCP customizado](/docs/mcp/custom-client) — construa o seu