# MCP in Cursor

Cursor is een AI-aangedreven IDE gebaseerd op VS Code. Met Synapse MCP krijgt Cursor
permanent geheugen tussen sessies — het herinnert uw projectbeslissingen,
codebase-patronen en eerdere debugging-sessies.

## Vereisten

- Cursor IDE geïnstalleerd (<https://cursor.com>)
- Node.js 18+
- Uw Synapse Mind Key

## Setup

### Stap 1: Open Cursor-instellingen

In Cursor:

1. Open Instellingen (Cmd+, op macOS, Ctrl+, op Windows/Linux)
2. Zoek naar "MCP" of navigeer naar `Cursor Settings → MCP Servers`

### Stap 2: Voeg Synapse MCP-server toe

Klik op "Add MCP Server" en configureer:

| Veld | Waarde |
|------|--------|
| Name | `synapse` |
| Type | `stdio` |
| Command | `npx -y synapse-mcp-api@latest` |
| Env | `SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone` |

### Stap 3: Bewerk config.json direct (alternatief)

Cursor slaat MCP-config op in `~/.cursor/config.json`:

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

### Stap 4: Herstart Cursor

Herstart Cursor volledig (Cmd+Q en heropen op macOS).

## Verifieer dat het werkt

In Cursor's chat-paneel (Cmd+L):

```
recall all my memories
```

Cursor zou `memory_recall` moeten aanroepen en reageren met uw opgeslagen herinneringen.

## Veelvoorkomende patronen

### Project-onboarding

Bij het openen van een nieuw project:

```
recalling project context — what do I know about this codebase?
```

Cursor roept `memory_recall` aan en gaat verder met werk waar u gebleven was.

### Architectuurbeslissingen

```
store this decision: "Using Fastify instead of Express for this project
because of schema validation. Date: 2026-06-27."
```

Cursor slaat het op als een `project`-herinnering met `high`-prioriteit.

### Debugging-geschiedenis

```
what bugs have I hit in this codebase?
```

Cursor zoekt naar `mistake`-herinneringen en herinnert u aan eerdere fixes.

### Code-patronen tussen sessies

```
search memories: "authentication pattern"
```

Cursor vindt herinneringen over auth-implementaties die u eerder heeft gedaan.

## Troubleshooting

### MCP-server verbindt niet

1. Verifieer Node.js: `node --version` (≥ 18)
2. Test MCP-server: `npx -y synapse-mcp-api@latest` (zou zonder fouten moeten starten)
3. Controleer Cursor's MCP-logs (View → Output → MCP)
4. Herstart Cursor volledig

### Tools verschijnen niet

- Controleer dat `~/.cursor/config.json` geldige JSON is
- Verifieer dat `SYNAPSE_MIND_KEY`-env-var is ingesteld
- Controleer dat Cursor-versie MCP ondersteunt (≥ 0.42)

### Mind Key ongeldig

```bash
# Test your Mind Key directly
curl -H "Authorization: Bearer mk_YOUR_KEY" \
     https://synapse.schaefer.zone/memory/recall
```

## Volgende stappen

- [Claude Desktop-setup](/docs/mcp/claude-desktop)
- [Continue.dev-setup](/docs/mcp/continue)
- [Permanente LLM-agent-handleiding](/docs/guides/persistent-llm-agent)