{"title":"FAQ do MCP","slug":"mcp-faq","category":"faq","summary":"Perguntas comuns sobre integração MCP — ferramentas, transportes, troubleshooting.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":481,"read_minutes":2,"lang":"pt","translated":true,"requested_lang":"pt","content_markdown":"\n# FAQ do MCP\n\nPerguntas comuns sobre o servidor MCP do Synapse.\n\n## O que é MCP?\n\nMCP (Model Context Protocol) é um padrão aberto da Anthropic para integração\nentre LLM e ferramentas. Em vez de colar docs de API em prompts, você registra\nferramentas com um servidor MCP, e o LLM as chama como funções nativas.\n\nConsulte [O que é MCP?](/docs/mcp/what-is-mcp).\n\n## Quantas ferramentas o Synapse MCP expõe?\n\n**79 ferramentas** em 12 categorias: memória, chat, agendador, tarefas,\nscripts, computadores, push, usuário, utilitários, visualização,\ncompartilhamento, webhooks, navegador.\n\nConsulte [O que é MCP?](/docs/mcp/what-is-mcp) para a lista completa.\n\n## Quais clientes MCP são suportados?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (terminal)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- Qualquer cliente compatível com MCP\n\nConsulte [Configuração do Claude Desktop](/docs/mcp/claude-desktop) para\nexemplos de configuração.\n\n## Quais transportes são suportados?\n\n1. **stdio** (local, recomendado para desktop)\n2. **HTTP/SSE** (remoto, multi-tenant)\n3. **WebSocket** (mobile, alto volume)\n\n## Como configuro o Claude Desktop?\n\nEdite `claude_desktop_config.json`:\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_YOUR_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\nConsulte [Configuração do Claude Desktop](/docs/mcp/claude-desktop).\n\n## Por que as ferramentas não aparecem no Claude Desktop?\n\n1. **Reinicie o Claude Desktop completamente** (Cmd+Q no macOS)\n2. **Verifique se o arquivo de config é JSON válido**\n3. **Confirme Node.js 18+** instalado\n4. **Confira os logs MCP**: `~/Library/Logs/Claude/mcp.log`\n\nConsulte [MCP Troubleshooting](/docs/mcp/troubleshooting).\n\n## Como uso um mind diferente?\n\nAltere `SYNAPSE_MIND_KEY` na sua configuração MCP e reinicie o cliente.\n\nPara múltiplos minds, rode múltiplas instâncias do servidor MCP com Mind Keys\ndiferentes.\n\n## Posso limitar quais ferramentas são expostas?\n\nSim, use **Tool Profiles**:\n\n- `minimal`: 8 ferramentas compostas (~500 tokens)\n- `standard`: 25 ferramentas (~2.500 tokens)\n- `full`: 119 ferramentas (~8.250 tokens, padrão)\n\nDefina via variável de ambiente `MCP_PROFILE` ou cabeçalho `Mcp-Tool-Profile`.\n\n## Como depuro problemas de MCP?\n\n1. **Rode o servidor MCP manualmente**: `npx -y synapse-mcp-api@latest`\n2. **Confira os logs do cliente** (varia por cliente)\n3. **Verifique se a Mind Key funciona**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Confira a saúde do Synapse**: `curl https://synapse.schaefer.zone/health`\n\nConsulte [MCP Troubleshooting](/docs/mcp/troubleshooting).\n\n## O servidor MCP é gratuito?\n\nSim. O pacote npm `synapse-mcp-api` é open source. O servidor MCP hospedado em\n`synapse-mcp.schaefer.zone` é gratuito para uso público.\n\n## Posso auto-hospedar o servidor MCP?\n\nSim:\n\n```bash\nnpm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api\n```\n\n## Como o MCP difere de chamadas diretas à API?\n\n| Aspecto | API direta | MCP |\n|---------|-----------|-----|\n| LLM precisa saber | URLs, headers, auth | Apenas nomes das ferramentas |\n| Tratamento de auth | Manual | Automático (env var) |\n| Descoberta de ferramentas | Ler /endpoints | Automática via protocolo MCP |\n| Tratamento de erros | Manual | Padronizado |\n| Melhor para | Integrações customizadas | Agentes LLM |\n\n## Posso construir meu próprio cliente MCP?\n\nSim. Use o SDK oficial do MCP:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\nConsulte [Cliente MCP customizado](/docs/mcp/custom-client).\n\n## Como relato bugs do MCP?\n\nAbra uma issue: \n\nInclua:\n\n- Versão do servidor MCP\n- Nome e versão do cliente\n- Sistema operacional\n- Logs relevantes\n- Passos para reproduzir\n\n## Próximos passos\n\n- [O que é MCP?](/docs/mcp/what-is-mcp)\n- [Configuração do Claude Desktop](/docs/mcp/claude-desktop)\n- [MCP Troubleshooting](/docs/mcp/troubleshooting)\n","content_html":"

FAQ do MCP

\n

Perguntas comuns sobre o servidor MCP do Synapse.

\n

O que é MCP?

\n

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

\n

Consulte O que é MCP?.

\n

Quantas ferramentas o Synapse MCP expõe?

\n

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

\n

Consulte O que é MCP? para a lista completa.

\n

Quais clientes MCP são suportados?

\n\n

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

\n

Quais transportes são suportados?

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

Como configuro o Claude Desktop?

\n

Edite claude_desktop_config.json:

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

Consulte Configuração do Claude Desktop.

\n

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

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

Consulte MCP Troubleshooting.

\n

Como uso um mind diferente?

\n

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

\n

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

\n

Posso limitar quais ferramentas são expostas?

\n

Sim, use Tool Profiles:

\n\n

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

\n

Como depuro problemas de MCP?

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

Consulte MCP Troubleshooting.

\n

O servidor MCP é gratuito?

\n

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

\n

Posso auto-hospedar o servidor MCP?

\n

Sim:

\n
npm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api

Como o MCP difere de chamadas diretas à API?

\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
AspectoAPI diretaMCP
LLM precisa saberURLs, headers, authApenas nomes das ferramentas
Tratamento de authManualAutomático (env var)
Descoberta de ferramentasLer /endpointsAutomática via protocolo MCP
Tratamento de errosManualPadronizado
Melhor paraIntegrações customizadasAgentes LLM
\n

Posso construir meu próprio cliente MCP?

\n

Sim. Use o SDK oficial do MCP:

\n\n

Consulte Cliente MCP customizado.

\n

Como relato bugs do MCP?

\n

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

\n

Inclua:

\n\n

Próximos passos

\n\n","urls":{"html":"/docs/faq/mcp-faq","text":"/docs/faq/mcp-faq?format=text","json":"/docs/faq/mcp-faq?format=json","llm":"/docs/faq/mcp-faq?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}