Skip to main content

O que é MCP?

beginner 🤖 Compatível com LLM 3 min · 598 palavras Atualizado: 2026-06-27 Português

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

Ler este artigo como: 📄 Texto simples ⚡ JSON 🤖 Formato LLM
Idioma: English中文हिन्दीEspañolFrançaisالعربيةPortuguêsРусский日本語DeutschItaliano한국어NederlandsPolskiTürkçeSvenskaTiếng ViệtไทยBahasa IndonesiaУкраїнська

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)

{
  "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 — 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

← Voltar a Integração MCP