# 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

```json
{
  "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"
      }
    }
  }
}
```

> [!TIP]
> Se você já tem outros servidores MCP configurados, basta adicionar o bloco
> `"synapse"` dentro do objeto `"mcpServers"` existente.

## 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)

| Ferramenta | Descrição |
|------------|-----------|
| `memory_recall` | Recuperar todas as memórias |
| `memory_store` | Armazenar uma nova memória |
| `memory_search` | Buscar memórias |
| `task_list` | Listar tarefas |
| `task_create` | Criar uma tarefa |
| `chat_poll` | Verificar novas mensagens |
| `chat_reply` | Responder a uma mensagem |
| `browser_new` | Abrir uma aba do navegador |
| `computer_list` | Listar computadores registrados |

Lista completa: [O que é MCP?](/docs/mcp/what-is-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](/docs/mcp/troubleshooting)

## Tool Profiles (economize tokens)

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

```json
{
  "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](/docs/mcp/claude-code)
- [Configuração do Cursor](/docs/mcp/cursor)
- [MCP Troubleshooting](/docs/mcp/troubleshooting)