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:

{
  "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

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

Nächste Schritte

• Claude-Desktop-Setup
• Continue.dev-Setup
• Persistenter-LLM-Agent-Guide