# 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

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

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

| Tool | Beschreibung |
|------|--------------|
| `memory_recall` | Alle Memories abrufen |
| `memory_store` | Neuen Memory speichern |
| `memory_search` | Memories durchsuchen |
| `task_list` | Tasks auflisten |
| `task_create` | Task anlegen |
| `chat_poll` | Auf neue Nachrichten prüfen |
| `chat_reply` | Auf Nachricht antworten |
| `browser_new` | Browser-Tab öffnen |
| `computer_list` | Registrierte Rechner auflisten |

Vollständige Liste: [Was ist MCP?](/docs/mcp/what-is-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](/docs/mcp/troubleshooting)

## Tool-Profile (Token sparen)

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

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

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

## Nächste Schritte

- [Claude-Code-Setup](/docs/mcp/claude-code)
- [Cursor-Setup](/docs/mcp/cursor)
- [MCP-Troubleshooting](/docs/mcp/troubleshooting)