MCP in Claude Desktop

Claude Desktop ist Anthropics Desktop-App für macOS und Windows. Mit dem konfigurierten Synapse-MCP-Server erhält Claude nativen Zugriff auf alle 79 Synapse-Tools — es kann Memories speichern, abrufen, Tasks verwalten, mit dir chatten und mehr.

Voraussetzungen

• Claude-Desktop-App (macOS oder Windows)
• Node.js 18+ installiert (node --version)
• Dein Synapse Mind Key

Schritt 1: Config-Datei öffnen

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

Wenn die Datei nicht existiert, lege sie an.

Schritt 2: Synapse-MCP-Server hinzufügen

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

Schritt 3: Claude Desktop neu starten

1. Claude Desktop vollständig beenden (Cmd+Q auf macOS, nicht nur Fenster schließen)
2. Claude Desktop wieder öffnen
3. Neuen Chat starten
4. Suche das 🔌-Plug-Icon unten links — es sollte „79 tools" sagen

Schritt 4: Testen

In einem neuen Chat eingeben:

memory_recall aufrufen

Claude sollte das memory_recall-Tool aufrufen und mit einer Zusammenfassung deiner gespeicherten Memories antworten (oder „No memories yet", wenn dein Mind leer ist).

Verfügbare Tools (Auswahl)

Vollständige Liste: Was ist MCP?

Troubleshooting

Keine Tools in Claude Desktop sichtbar

1. Node.js-Version verifizieren: node --version (muss ≥ 18 sein)
2. Config-Datei auf valides JSON prüfen (keine Trailing-Commas)
3. Claude Desktop vollständig neu starten (Cmd+Q, nicht nur schließen)
4. Claude-Desktop-Logs prüfen: ~/Library/Logs/Claude/mcp.log (macOS)

„Mind Key invalid"-Fehler

• Verifizieren, dass SYNAPSE_MIND_KEY mit mk_ beginnt
• Frischen Key via POST /minds holen (erfordert JWT von /login)
• Keine Anführungszeichen um den Key im JSON

npx nicht gefunden

• Node.js 18+ installieren: https://nodejs.org/
• Nach Installation Terminal neu starten
• Auf macOS mit Homebrew: brew install node

Tools sichtbar, aber Aufrufe schlagen fehl

• SYNAPSE_URL erreichbar prüfen: curl https://synapse.schaefer.zone/health
• Mind Key verifizieren: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Siehe MCP-Troubleshooting

Tool-Profile (Token sparen)

Wenn du ein kleineres LLM verwendest oder Kontext-Tokens sparen willst, setze ein Tool-Profil:

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

Profile: minimal (8 Tools), standard (25), full (119, Standard).

Nächste Schritte

• Claude-Code-Setup
• Cursor-Setup
• MCP-Troubleshooting