MCP in Claude Desktop

Claude Desktop is de desktop-app van Anthropic voor macOS en Windows. Met de Synapse MCP-server geconfigureerd krijgt Claude native toegang tot alle 79 Synapse- tools — het kan herinneringen opslaan, ophalen, taken beheren, met u chatten, en meer.

Vereisten

• Claude Desktop-app (macOS of Windows)
• Node.js 18+ geïnstalleerd (node --version)
• Uw Synapse Mind Key

Stap 1: Open het configuratiebestand

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

Als het bestand niet bestaat, maak het dan aan.

Stap 2: Voeg Synapse MCP-server toe

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

Stap 3: Herstart Claude Desktop

1. Sluit Claude Desktop volledig (Cmd+Q op macOS, niet alleen venster sluiten)
2. Heropen Claude Desktop
3. Start een nieuwe chat
4. Zoek naar het 🔌-plug-icoon linksonder — het zou "79 tools" moeten zeggen

Stap 4: Test het

In een nieuwe chat, typ:

memory_recall aufrufen

Claude zou de memory_recall-tool moeten aanroepen en reageren met een samenvatting van uw opgeslagen herinneringen (of "No memories yet" als uw mind leeg is).

Beschikbare tools (selectie)

Volledige lijst: Wat is MCP?

Troubleshooting

Geen tools verschijnen in Claude Desktop

1. Verifieer Node.js-versie: node --version (moet ≥ 18 zijn)
2. Controleer dat het configuratiebestand geldige JSON is (geen afsluitende komma's)
3. Herstart Claude Desktop volledig (Cmd+Q, niet alleen sluiten)
4. Controleer Claude Desktop-logs: ~/Library/Logs/Claude/mcp.log (macOS)

"Mind Key invalid"-fout

• Verifieer dat SYNAPSE_MIND_KEY begint met mk_
• Krijg een verse sleutel via POST /minds (vereist JWT van /login)
• Geen aanhalingstekens rond de sleutel in de JSON

npx niet gevonden

• Installeer Node.js 18+: https://nodejs.org/
• Herstart terminal na installatie
• Op macOS met Homebrew: brew install node

Tools worden getoond maar aanroepen falen

• Controleer dat SYNAPSE_URL bereikbaar is: curl https://synapse.schaefer.zone/health
• Verifieer dat uw Mind Key werkt: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Zie MCP Troubleshooting

Tool-profielen (bespaar tokens)

Als u een kleinere LLM gebruikt of context-tokens wilt besparen, stel een tool-profiel in:

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

Profielen: minimal (8 tools), standard (25), full (119, standaard).

Volgende stappen

• Claude Code-setup
• Cursor-setup
• MCP Troubleshooting