MCP no Claude Desktop

Claude Desktop é o aplicativo desktop da Anthropic para macOS e Windows. Com o servidor MCP do Synapse configurado, Claude ganha acesso nativo a todas as 79 ferramentas do Synapse — pode armazenar memórias, recuperá-las, gerenciar tarefas, conversar com você e mais.

Pré-requisitos

• App Claude Desktop (macOS ou Windows)
• Node.js 18+ instalado (node --version)
• Sua Mind Key do Synapse

Passo 1: abra o arquivo de config

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Se o arquivo não existir, crie-o.

Passo 2: adicione o servidor MCP do Synapse

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

Passo 3: reinicie o Claude Desktop

1. Saia totalmente do Claude Desktop (Cmd+Q no macOS, não apenas feche a janela)
2. Reabra o Claude Desktop
3. Inicie um novo chat
4. Procure pelo ícone 🔌 no canto inferior esquerdo — deve dizer "79 tools"

Passo 4: teste

Em um novo chat, digite:

memory_recall aufrufen

Claude deve chamar a ferramenta memory_recall e responder com um resumo das suas memórias armazenadas (ou "No memories yet" se seu mind estiver vazio).

Ferramentas disponíveis (seleção)

Lista completa: O que é MCP?

Troubleshooting

Nenhuma ferramenta aparece no Claude Desktop

1. Verifique a versão do Node.js: node --version (deve ser ≥ 18)
2. Confira se o arquivo de config é JSON válido (sem vírgulas no final)
3. Reinicie totalmente o Claude Desktop (Cmd+Q, não apenas feche)
4. Confira os logs do Claude Desktop: ~/Library/Logs/Claude/mcp.log (macOS)

Erro "Mind Key invalid"

• Verifique se SYNAPSE_MIND_KEY começa com mk_
• Obtenha uma nova key via POST /minds (requer JWT de /login)
• Sem aspas ao redor da key no JSON

npx não encontrado

• Instale Node.js 18+: https://nodejs.org/
• Reinicie o terminal após instalar
• No macOS com Homebrew: brew install node

Ferramentas aparecem, mas chamadas falham

• Verifique se SYNAPSE_URL é alcançável: curl https://synapse.schaefer.zone/health
• Verifique se sua Mind Key funciona: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Consulte MCP Troubleshooting

Tool Profiles (economize tokens)

Se você está usando um LLM menor ou quer economizar tokens de contexto, defina um tool profile:

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

Profiles: minimal (8 ferramentas), standard (25), full (119, padrão).

Próximos passos

• Configuração do Claude Code
• Configuração do Cursor
• MCP Troubleshooting