# O que é MCP?
SUMMARY: Model Context Protocol permite que LLMs chamem ferramentas externas. O Synapse expõe 79 ferramentas via servidor MCP oficial.

KEY CONTEXT:
MCP = Model Context Protocol (Anthropic, 2024). Open standard for LLM-tool integration.
Synapse has official MCP server: synapse-mcp-api (npm package, npx -y synapse-mcp-api@latest)
79 tools exposed: 22 memory, 7 chat, 8 scheduler, 4 tasks, 5 scripts, 9 computers, 4 push, 5 user, 3 utility
3 transports: stdio (local), HTTP/SSE (remote), WebSocket (mobile)
Supported clients: Claude Desktop, Claude Code, Cursor, Continue, Cline, any MCP-compatible client
Tool Profiles (v1.4.0): minimal (8 tools), standard (25), full (119) — controlled via MCP_PROFILE env or Mcp-Tool-Profile header

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 ( 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 | cronlist, croncreate, crondelete, crontoggle, varlist, varget, varset, vardelete | 8 |
| Tarefas | tasklist, taskget, taskcreate, taskupdate | 4 |
| Scripts | scriptlist, scriptget, scriptinfo, scriptstore, scriptdelete | 5 |
| Computadores | computerlist, computerget, installcode, screenshot, commandqueue, commandstatus, commandslist, disable, delete | 9 |
| Push | vapidpublickey, subscribe, unsubscribe, test | 4 |
| Usuário/Mind | register, login, mindslist, mindcreate, minddelete | 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
[CODE BLOCK]
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 )
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  — o servidor MCP traduz isso para  no Synapse
Transportes
O servidor MCP do Synapse suporta três transportes:
stdio (local, recomendado para desktop)
[CODE BLOCK]
HTTP/SSE (remoto, multi-tenant)
Conecte seu cliente MCP a:
[CODE BLOCK]
WebSocket (mobile, alto volume)
[CODE BLOCK]
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 |
|---------|-------------|--------|-------------|
|  | 8 (dispatch composto) | 500 | LLMs auto-hospedados com contexto ≤8k |
|  | 25 (nomeadas) | 2.500 | LLMs médios (Claude Haiku, GPT-3.5) |
|  | 119 (todas) | 8.250 | LLMs grandes (Claude Sonnet/Opus, GPT-4) — padrão |
Controle via:
- Env var: 
- Cabeçalho: 
Clientes suportados
- Claude Desktop — app desktop da Anthropic
- Claude Code — agente de codificação em terminal
- Cursor — IDE com IA
- Continue.dev — assistente de codificação IA open-source
- Cline — 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 — config em 2 minutos
- Configuração do Claude Code — integração com terminal
- Cliente MCP customizado — construa o seu