# 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?](/docs/mcp/what-is-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?](/docs/mcp/what-is-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](/docs/mcp/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`:

```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](/docs/mcp/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](/docs/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](/docs/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:

```bash
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](/docs/mcp/custom-client).

## 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?](/docs/mcp/what-is-mcp)
- [Configuração do Claude Desktop](/docs/mcp/claude-desktop)
- [MCP Troubleshooting](/docs/mcp/troubleshooting)