{"title":"O que é MCP?","slug":"what-is-mcp","category":"mcp","summary":"Model Context Protocol permite que LLMs chamem ferramentas externas. O Synapse expõe 79 ferramentas via servidor MCP oficial.","audience":["human","llm"],"tags":["mcp","intro","overview"],"difficulty":"beginner","updated":"2026-06-27","word_count":598,"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":"pt","translated":true,"requested_lang":"pt","content_markdown":"\n# O que é MCP?\n\nO **Model Context Protocol (MCP)** é um padrão aberto da Anthropic (2024) que\npermite aos LLMs chamar ferramentas externas de forma estruturada. Em vez de\ncolar docs de API no prompt, você registra ferramentas com o servidor MCP, e o\nLLM as chama conforme necessário — como function calling, mas padronizado e\nagnóstico de cliente.\n\n## Servidor MCP do Synapse\n\nO Synapse traz um servidor MCP oficial (`synapse-mcp-api` no npm) que expõe\n**79 ferramentas** cobrindo todos os recursos do Synapse:\n\n| Categoria | Ferramentas | Contagem |\n|-----------|-------------|----------|\n| 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 |\n| Chat | poll, reply, status, history, unread, send, upload | 7 |\n| Agendador | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |\n| Tarefas | task_list, task_get, task_create, task_update | 4 |\n| Scripts | script_list, script_get, script_info, script_store, script_delete | 5 |\n| Computadores | 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| Usuário/Mind | register, login, minds_list, mind_create, mind_delete | 5 |\n| Utilitários | time, calc, random | 3 |\n| Visualização | graph, tags, compact | 3 |\n| Compartilhamento | share, list, revoke | 3 |\n| Webhooks | register, list, get, update, delete | 5 |\n| Navegador | new, navigate, click, type, screenshot, close | 6 |\n| **Total** | | **79+** |\n\n## Como 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. Você configura seu cliente LLM (Claude Desktop, Cursor, etc.) para usar o servidor MCP do Synapse\n2. O cliente inicia o servidor MCP (via `npx -y synapse-mcp-api@latest`)\n3. O servidor MCP conecta-se à API do Synapse usando sua Mind Key\n4. O LLM vê todas as 79 ferramentas como funções nativas que pode chamar\n5. Quando o LLM precisa lembrar algo, ele chama `memory_store` — o servidor MCP traduz isso para `POST /memory` no Synapse\n\n## Transportes\n\nO servidor MCP do Synapse suporta três transportes:\n\n### stdio (local, recomendado para desktop)\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 seu cliente MCP a:\n\n```\nURL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY\n```\n\n### WebSocket (mobile, alto volume)\n\n```\nURL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY\n```\n\n## Tool Profiles (v1.4.0)\n\nPara reduzir o overhead de tokens para LLMs menores, o servidor MCP suporta\ntrês tool profiles:\n\n| Profile | Ferramentas | Tokens | Melhor para |\n|---------|-------------|--------|-------------|\n| `minimal` | 8 (dispatch composto) | ~500 | LLMs auto-hospedados com contexto ≤8k |\n| `standard` | 25 (nomeadas) | ~2.500 | LLMs médios (Claude Haiku, GPT-3.5) |\n| `full` | 119 (todas) | ~8.250 | LLMs grandes (Claude Sonnet/Opus, GPT-4) — padrão |\n\nControle via:\n\n- Env var: `MCP_PROFILE=minimal|standard|full`\n- Cabeçalho: `Mcp-Tool-Profile: minimal|standard|full`\n\n## Clientes suportados\n\n- [Claude Desktop](/docs/mcp/claude-desktop) — app desktop da Anthropic\n- [Claude Code](/docs/mcp/claude-code) — agente de codificação em terminal\n- [Cursor](/docs/mcp/cursor) — IDE com IA\n- [Continue.dev](/docs/mcp/continue) — assistente de codificação IA open-source\n- [Cline](/docs/mcp/claude-code) — extensão do VS Code\n- Qualquer cliente compatível com MCP\n\n## Por que usar MCP em vez de API direta?\n\n| Abordagem | Prós | Contras |\n|-----------|------|---------|\n| API direta | Simples, sem camada extra | LLM precisa saber URLs, headers, auth |\n| MCP | LLM vê ferramentas nativas, sem memorizar URL | Processo extra de servidor MCP |\n\nPara a maioria dos casos de uso de agentes LLM, MCP é a melhor escolha — o LLM\nnão precisa lembrar caminhos de API ou padrões de auth.\n\n## Próximos passos\n\n- [Configuração do Claude Desktop](/docs/mcp/claude-desktop) — config em 2 minutos\n- [Configuração do Claude Code](/docs/mcp/claude-code) — integração com terminal\n- [Cliente MCP customizado](/docs/mcp/custom-client) — construa o seu\n","content_html":"

O que é MCP?

\n

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

\n

Servidor MCP do Synapse

\n

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CategoriaFerramentasContagem
Memóriarecall, 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-export22
Chatpoll, reply, status, history, unread, send, upload7
Agendadorcron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete8
Tarefastask_list, task_get, task_create, task_update4
Scriptsscript_list, script_get, script_info, script_store, script_delete5
Computadorescomputer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete9
Pushvapid_public_key, subscribe, unsubscribe, test4
Usuário/Mindregister, login, minds_list, mind_create, mind_delete5
Utilitáriostime, calc, random3
Visualizaçãograph, tags, compact3
Compartilhamentoshare, list, revoke3
Webhooksregister, list, get, update, delete5
Navegadornew, navigate, click, type, screenshot, close6
Total79+
\n

Como funciona

\n
┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘
    \n
  1. Você configura seu cliente LLM (Claude Desktop, Cursor, etc.) para usar o servidor MCP do Synapse
    2. \n
  2. O cliente inicia o servidor MCP (via npx -y synapse-mcp-api@latest)
    3. \n
  3. O servidor MCP conecta-se à API do Synapse usando sua Mind Key
    4. \n
  4. O LLM vê todas as 79 ferramentas como funções nativas que pode chamar
    5. \n
  5. Quando o LLM precisa lembrar algo, ele chama memory_store — o servidor MCP traduz isso para POST /memory no Synapse
    6. \n
\n

Transportes

\n

O servidor MCP do Synapse suporta três transportes:

\n

stdio (local, recomendado para desktop)

\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}

HTTP/SSE (remoto, multi-tenant)

\n

Conecte seu cliente MCP a:

\n
URL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY

WebSocket (mobile, alto volume)

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

Tool Profiles (v1.4.0)

\n

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ProfileFerramentasTokensMelhor para
minimal8 (dispatch composto)~500LLMs auto-hospedados com contexto ≤8k
standard25 (nomeadas)~2.500LLMs médios (Claude Haiku, GPT-3.5)
full119 (todas)~8.250LLMs grandes (Claude Sonnet/Opus, GPT-4) — padrão
\n

Controle via:

\n\n

Clientes suportados

\n\n

Por que usar MCP em vez de API direta?

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
AbordagemPrósContras
API diretaSimples, sem camada extraLLM precisa saber URLs, headers, auth
MCPLLM vê ferramentas nativas, sem memorizar URLProcesso extra de servidor MCP
\n

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

\n

Próximos passos

\n\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"]}