{"title":"MCP in Claude Desktop","slug":"claude-desktop","category":"mcp","summary":"Synapse in 2 Minuten mit Claude Desktop verbinden. Claude erhält 79 Synapse-Tools nativ.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":360,"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":"de","translated":true,"requested_lang":"de","content_markdown":"\n# MCP in Claude Desktop\n\nClaude Desktop ist Anthropics Desktop-App für macOS und Windows. Mit dem\nkonfigurierten Synapse-MCP-Server erhält Claude nativen Zugriff auf alle 79\nSynapse-Tools — es kann Memories speichern, abrufen, Tasks verwalten, mit dir\nchatten und mehr.\n\n## Voraussetzungen\n\n- Claude-Desktop-App (macOS oder Windows)\n- Node.js 18+ installiert (`node --version`)\n- Dein Synapse Mind Key\n\n## Schritt 1: Config-Datei öffnen\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nWenn die Datei nicht existiert, lege sie an.\n\n## Schritt 2: Synapse-MCP-Server hinzufügen\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> Wenn du bereits andere MCP-Server konfiguriert hast, füge einfach den\n> `\"synapse\"`-Block innerhalb des bestehenden `\"mcpServers\"`-Objekts hinzu.\n\n## Schritt 3: Claude Desktop neu starten\n\n1. Claude Desktop vollständig beenden (Cmd+Q auf macOS, nicht nur Fenster schließen)\n2. Claude Desktop wieder öffnen\n3. Neuen Chat starten\n4. Suche das 🔌-Plug-Icon unten links — es sollte „79 tools\" sagen\n\n## Schritt 4: Testen\n\nIn einem neuen Chat eingeben:\n\n```\nmemory_recall aufrufen\n```\n\nClaude sollte das `memory_recall`-Tool aufrufen und mit einer Zusammenfassung\ndeiner gespeicherten Memories antworten (oder „No memories yet\", wenn dein Mind\nleer ist).\n\n## Verfügbare Tools (Auswahl)\n\n| Tool | Beschreibung |\n|------|--------------|\n| `memory_recall` | Alle Memories abrufen |\n| `memory_store` | Neuen Memory speichern |\n| `memory_search` | Memories durchsuchen |\n| `task_list` | Tasks auflisten |\n| `task_create` | Task anlegen |\n| `chat_poll` | Auf neue Nachrichten prüfen |\n| `chat_reply` | Auf Nachricht antworten |\n| `browser_new` | Browser-Tab öffnen |\n| `computer_list` | Registrierte Rechner auflisten |\n\nVollständige Liste: [Was ist MCP?](/docs/mcp/what-is-mcp)\n\n## Troubleshooting\n\n### Keine Tools in Claude Desktop sichtbar\n\n1. Node.js-Version verifizieren: `node --version` (muss ≥ 18 sein)\n2. Config-Datei auf valides JSON prüfen (keine Trailing-Commas)\n3. Claude Desktop vollständig neu starten (Cmd+Q, nicht nur schließen)\n4. Claude-Desktop-Logs prüfen: `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### „Mind Key invalid\"-Fehler\n\n- Verifizieren, dass `SYNAPSE_MIND_KEY` mit `mk_` beginnt\n- Frischen Key via `POST /minds` holen (erfordert JWT von `/login`)\n- Keine Anführungszeichen um den Key im JSON\n\n### npx nicht gefunden\n\n- Node.js 18+ installieren: \n- Nach Installation Terminal neu starten\n- Auf macOS mit Homebrew: `brew install node`\n\n### Tools sichtbar, aber Aufrufe schlagen fehl\n\n- `SYNAPSE_URL` erreichbar prüfen: `curl https://synapse.schaefer.zone/health`\n- Mind Key verifizieren: `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- Siehe [MCP-Troubleshooting](/docs/mcp/troubleshooting)\n\n## Tool-Profile (Token sparen)\n\nWenn du ein kleineres LLM verwendest oder Kontext-Tokens sparen willst, setze\nein Tool-Profil:\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\nProfile: `minimal` (8 Tools), `standard` (25), `full` (119, Standard).\n\n## Nächste Schritte\n\n- [Claude-Code-Setup](/docs/mcp/claude-code)\n- [Cursor-Setup](/docs/mcp/cursor)\n- [MCP-Troubleshooting](/docs/mcp/troubleshooting)\n","content_html":"

MCP in Claude Desktop

\n

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

\n

Voraussetzungen

\n\n

Schritt 1: Config-Datei öffnen

\n\n

Wenn die Datei nicht existiert, lege sie an.

\n

Schritt 2: Synapse-MCP-Server hinzufügen

\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}
Wenn du bereits andere MCP-Server konfiguriert hast, füge einfach den\n`\"synapse\"`-Block innerhalb des bestehenden `\"mcpServers\"`-Objekts hinzu.

Schritt 3: Claude Desktop neu starten

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

Schritt 4: Testen

\n

In einem neuen Chat eingeben:

\n
memory_recall aufrufen

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

\n

Verfügbare Tools (Auswahl)

\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
ToolBeschreibung
memory_recallAlle Memories abrufen
memory_storeNeuen Memory speichern
memory_searchMemories durchsuchen
task_listTasks auflisten
task_createTask anlegen
chat_pollAuf neue Nachrichten prüfen
chat_replyAuf Nachricht antworten
browser_newBrowser-Tab öffnen
computer_listRegistrierte Rechner auflisten
\n

Vollständige Liste: Was ist MCP?

\n

Troubleshooting

\n

Keine Tools in Claude Desktop sichtbar

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

„Mind Key invalid"-Fehler

\n\n

npx nicht gefunden

\n\n

Tools sichtbar, aber Aufrufe schlagen fehl

\n\n

Tool-Profile (Token sparen)

\n

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

\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}

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

\n

Nächste Schritte

\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"]}