# MCP in Cursor

Cursor ist eine AI-powered IDE basierend auf VS Code. Mit Synapse MCP erhält
Cursor persistenten Memory über Sessions hinweg — er erinnert sich an deine
Projektentscheidungen, Codebase-Patterns und vergangene Debugging-Sessions.

## Voraussetzungen

- Cursor-IDE installiert (<https://cursor.com>)
- Node.js 18+
- Dein Synapse Mind Key

## Setup

### Schritt 1: Cursor-Settings öffnen

In Cursor:

1. Settings öffnen (Cmd+, auf macOS, Ctrl+, auf Windows/Linux)
2. Nach „MCP" suchen oder zu `Cursor Settings → MCP Servers` navigieren

### Schritt 2: Synapse-MCP-Server hinzufügen

Auf „Add MCP Server" klicken und konfigurieren:

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

### Schritt 3: config.json direkt editieren (Alternative)

Cursor speichert MCP-Config 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"
      }
    }
  }
}
```

### Schritt 4: Cursor neu starten

Cursor vollständig neu starten (Cmd+Q und wieder öffnen auf macOS).

## Funktions-Verifikation

In Cursors Chat-Panel (Cmd+L):

```
recall all my memories
```

Cursor sollte `memory_recall` aufrufen und mit deinen gespeicherten Memories
antworten.

## Häufige Patterns

### Projekt-Onboarding

Beim Öffnen eines neuen Projekts:

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

Cursor ruft `memory_recall` auf und setzt die Arbeit dort fort, wo du
aufgehört hast.

### Architektur-Entscheidungen

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

Cursor speichert es als `project`-Memory mit Priorität `high`.

### Debugging-Historie

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

Cursor sucht nach `mistake`-Memories und erinnert dich an vergangene Fixes.

### Cross-Session-Code-Patterns

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

Cursor findet Memories über Auth-Implementierungen, die du früher gemacht hast.

## Troubleshooting

### MCP-Server verbindet nicht

1. Node.js verifizieren: `node --version` (≥ 18)
2. MCP-Server testen: `npx -y synapse-mcp-api@latest` (sollte ohne Fehler starten)
3. Cursors MCP-Logs prüfen (View → Output → MCP)
4. Cursor vollständig neu starten

### Tools erscheinen nicht

- `~/.cursor/config.json` auf valides JSON prüfen
- `SYNAPSE_MIND_KEY`-Env-Var gesetzt verifizieren
- Cursor-Version unterstützt MCP prüfen (≥ 0.42)

### Mind Key ungültig

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

## Nächste Schritte

- [Claude-Desktop-Setup](/docs/mcp/claude-desktop)
- [Continue.dev-Setup](/docs/mcp/continue)
- [Persistenter-LLM-Agent-Guide](/docs/guides/persistent-llm-agent)