FAQ do MCP

Perguntas comuns sobre o servidor MCP do Synapse.

O que é MCP?

MCP (Model Context Protocol) é um padrão aberto da Anthropic para integração entre LLM e ferramentas. Em vez de colar docs de API em prompts, você registra ferramentas com um servidor MCP, e o LLM as chama como funções nativas.

Consulte O que é MCP?.

Quantas ferramentas o Synapse MCP expõe?

79 ferramentas em 12 categorias: memória, chat, agendador, tarefas, scripts, computadores, push, usuário, utilitários, visualização, compartilhamento, webhooks, navegador.

Consulte O que é MCP? para a lista completa.

Quais clientes MCP são suportados?

• Claude Desktop (macOS, Windows)
• Claude Code (terminal)
• Cursor (IDE)
• Continue.dev (VS Code, JetBrains)
• Cline (VS Code)
• Qualquer cliente compatível com MCP

Consulte Configuração do Claude Desktop para exemplos de configuração.

Quais transportes são suportados?

1. stdio (local, recomendado para desktop)
2. HTTP/SSE (remoto, multi-tenant)
3. WebSocket (mobile, alto volume)

Como configuro o Claude Desktop?

Edite claude_desktop_config.json:

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_YOUR_KEY",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}

Consulte Configuração do Claude Desktop.

Por que as ferramentas não aparecem no Claude Desktop?

1. Reinicie o Claude Desktop completamente (Cmd+Q no macOS)
2. Verifique se o arquivo de config é JSON válido
3. Confirme Node.js 18+ instalado
4. Confira os logs MCP: ~/Library/Logs/Claude/mcp.log

Consulte MCP Troubleshooting.

Como uso um mind diferente?

Altere SYNAPSE_MIND_KEY na sua configuração MCP e reinicie o cliente.

Para múltiplos minds, rode múltiplas instâncias do servidor MCP com Mind Keys diferentes.

Posso limitar quais ferramentas são expostas?

Sim, use Tool Profiles:

• minimal: 8 ferramentas compostas (~500 tokens)
• standard: 25 ferramentas (~2.500 tokens)
• full: 119 ferramentas (~8.250 tokens, padrão)

Defina via variável de ambiente MCP_PROFILE ou cabeçalho Mcp-Tool-Profile.

Como depuro problemas de MCP?

1. Rode o servidor MCP manualmente: npx -y synapse-mcp-api@latest
2. Confira os logs do cliente (varia por cliente)
3. Verifique se a Mind Key funciona: curl -H "Authorization: Bearer mk_..." .../memory/recall
4. Confira a saúde do Synapse: curl https://synapse.schaefer.zone/health

Consulte MCP Troubleshooting.

O servidor MCP é gratuito?

Sim. O pacote npm synapse-mcp-api é open source. O servidor MCP hospedado em synapse-mcp.schaefer.zone é gratuito para uso público.

Posso auto-hospedar o servidor MCP?

Sim:

npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-api

Como o MCP difere de chamadas diretas à API?

Aspecto	API direta	MCP
LLM precisa saber	URLs, headers, auth	Apenas nomes das ferramentas
Tratamento de auth	Manual	Automático (env var)
Descoberta de ferramentas	Ler /endpoints	Automática via protocolo MCP
Tratamento de erros	Manual	Padronizado
Melhor para	Integrações customizadas	Agentes LLM

Posso construir meu próprio cliente MCP?

Sim. Use o SDK oficial do MCP:

• TypeScript: @modelcontextprotocol/sdk
• Python: mcp

Consulte Cliente MCP customizado.

Como relato bugs do MCP?

Abra uma issue: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

Inclua:

• Versão do servidor MCP
• Nome e versão do cliente
• Sistema operacional
• Logs relevantes
• Passos para reproduzir

Próximos passos

• O que é MCP?
• Configuração do Claude Desktop
• MCP Troubleshooting