{"title":"MCP no Claude Desktop","slug":"claude-desktop","category":"mcp","summary":"Conecte o Synapse ao Claude Desktop em 2 minutos. Claude recebe 79 ferramentas do Synapse nativamente.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":421,"read_minutes":2,"llm_context":"Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n %APPDATA%\\Claude\\claude_desktop_config.json (Windows)\nMCP server command: npx -y synapse-mcp-api@latest\nEnv vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)\nAfter config: restart Claude Desktop, check for 🔌 icon with \"79 tools\"\nTest: type \"memory_recall aufrufen\" in a new chat\nTroubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting\n","lang":"pt","translated":true,"requested_lang":"pt","content_markdown":"\n# MCP no Claude Desktop\n\nClaude Desktop é o aplicativo desktop da Anthropic para macOS e Windows. Com o\nservidor MCP do Synapse configurado, Claude ganha acesso nativo a todas as 79\nferramentas do Synapse — pode armazenar memórias, recuperá-las, gerenciar\ntarefas, conversar com você e mais.\n\n## Pré-requisitos\n\n- App Claude Desktop (macOS ou Windows)\n- Node.js 18+ instalado (`node --version`)\n- Sua Mind Key do Synapse\n\n## Passo 1: abra o arquivo de config\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nSe o arquivo não existir, crie-o.\n\n## Passo 2: adicione o servidor MCP do Synapse\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_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n> [!TIP]\n> Se você já tem outros servidores MCP configurados, basta adicionar o bloco\n> `\"synapse\"` dentro do objeto `\"mcpServers\"` existente.\n\n## Passo 3: reinicie o Claude Desktop\n\n1. Saia totalmente do Claude Desktop (Cmd+Q no macOS, não apenas feche a janela)\n2. Reabra o Claude Desktop\n3. Inicie um novo chat\n4. Procure pelo ícone 🔌 no canto inferior esquerdo — deve dizer \"79 tools\"\n\n## Passo 4: teste\n\nEm um novo chat, digite:\n\n```\nmemory_recall aufrufen\n```\n\nClaude deve chamar a ferramenta `memory_recall` e responder com um resumo das\nsuas memórias armazenadas (ou \"No memories yet\" se seu mind estiver vazio).\n\n## Ferramentas disponíveis (seleção)\n\n| Ferramenta | Descrição |\n|------------|-----------|\n| `memory_recall` | Recuperar todas as memórias |\n| `memory_store` | Armazenar uma nova memória |\n| `memory_search` | Buscar memórias |\n| `task_list` | Listar tarefas |\n| `task_create` | Criar uma tarefa |\n| `chat_poll` | Verificar novas mensagens |\n| `chat_reply` | Responder a uma mensagem |\n| `browser_new` | Abrir uma aba do navegador |\n| `computer_list` | Listar computadores registrados |\n\nLista completa: [O que é MCP?](/docs/mcp/what-is-mcp)\n\n## Troubleshooting\n\n### Nenhuma ferramenta aparece no Claude Desktop\n\n1. Verifique a versão do Node.js: `node --version` (deve ser ≥ 18)\n2. Confira se o arquivo de config é JSON válido (sem vírgulas no final)\n3. Reinicie totalmente o Claude Desktop (Cmd+Q, não apenas feche)\n4. Confira os logs do Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### Erro \"Mind Key invalid\"\n\n- Verifique se `SYNAPSE_MIND_KEY` começa com `mk_`\n- Obtenha uma nova key via `POST /minds` (requer JWT de `/login`)\n- Sem aspas ao redor da key no JSON\n\n### npx não encontrado\n\n- Instale Node.js 18+: \n- Reinicie o terminal após instalar\n- No macOS com Homebrew: `brew install node`\n\n### Ferramentas aparecem, mas chamadas falham\n\n- Verifique se `SYNAPSE_URL` é alcançável: `curl https://synapse.schaefer.zone/health`\n- Verifique se sua Mind Key funciona: `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- Consulte [MCP Troubleshooting](/docs/mcp/troubleshooting)\n\n## Tool Profiles (economize tokens)\n\nSe você está usando um LLM menor ou quer economizar tokens de contexto, defina\num tool profile:\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_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n \"MCP_PROFILE\": \"standard\"\n }\n }\n }\n}\n```\n\nProfiles: `minimal` (8 ferramentas), `standard` (25), `full` (119, padrão).\n\n## Próximos passos\n\n- [Configuração do Claude Code](/docs/mcp/claude-code)\n- [Configuração do Cursor](/docs/mcp/cursor)\n- [MCP Troubleshooting](/docs/mcp/troubleshooting)\n","content_html":"

MCP no Claude Desktop

\n

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

\n

Pré-requisitos

\n\n

Passo 1: abra o arquivo de config

\n\n

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

\n

Passo 2: adicione o servidor MCP do Synapse

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}
Se você já tem outros servidores MCP configurados, basta adicionar o bloco\n`\"synapse\"` dentro do objeto `\"mcpServers\"` existente.

Passo 3: reinicie o Claude Desktop

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

Passo 4: teste

\n

Em um novo chat, digite:

\n
memory_recall aufrufen

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

\n

Ferramentas disponíveis (seleção)

\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\n\n\n\n\n\n\n\n\n\n
FerramentaDescrição
memory_recallRecuperar todas as memórias
memory_storeArmazenar uma nova memória
memory_searchBuscar memórias
task_listListar tarefas
task_createCriar uma tarefa
chat_pollVerificar novas mensagens
chat_replyResponder a uma mensagem
browser_newAbrir uma aba do navegador
computer_listListar computadores registrados
\n

Lista completa: O que é MCP?

\n

Troubleshooting

\n

Nenhuma ferramenta aparece no Claude Desktop

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

Erro "Mind Key invalid"

\n\n

npx não encontrado

\n\n

Ferramentas aparecem, mas chamadas falham

\n\n

Tool Profiles (economize tokens)

\n

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

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

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

\n

Próximos passos

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