# 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

```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]
> Als u al andere MCP-servers heeft geconfigureerd, voeg dan gewoon het `"synapse"`-
> blok toe binnen het bestaande `"mcpServers"`-object.

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

| Tool | Beschrijving |
|------|--------------|
| `memory_recall` | Alle herinneringen ophalen |
| `memory_store` | Een nieuwe herinnering opslaan |
| `memory_search` | Herinneringen doorzoeken |
| `task_list` | Taken tonen |
| `task_create` | Een taak aanmaken |
| `chat_poll` | Controleren op nieuwe berichten |
| `chat_reply` | Op een bericht antwoorden |
| `browser_new` | Een browsertabblad openen |
| `computer_list` | Geregistreerde computers tonen |

Volledige lijst: [Wat is MCP?](/docs/mcp/what-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](/docs/mcp/troubleshooting)

## Tool-profielen (bespaar tokens)

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

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

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

## Volgende stappen

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