Cursor MCP-Fehlerbehebung: Änderungen nach Bearbeitung der Konfiguration werden nicht übernommen

Cursor MCP-Konfiguration bearbeitet, aber die Änderungen greifen nicht? Diese Cursor-spezifische Anleitung hilft, wenn Konfigurations-Updates nicht angewendet werden. Neustart-/Reload-Anforderungen, Verwechslung des Konfigurationsdatei-Speicherorts und Prüfung der aktiven Serverliste.

Warum Konfigurationsänderungen nicht greifen

Cursor liest die MCP-Konfigurationsdatei nur beim Start. Einfaches Speichern reicht nicht – Sie müssen neu starten oder das Fenster neu laden:

Häufige Ursachen

Cursor nach Konfigurationsänderungen nicht neu gestartet
Fenster-Neuladen nicht ausgeführt (Reload kann nötig sein)
Falsche Konfigurationsdatei bearbeitet (Speicherort verwechselt)
Konfigurationsdatei nicht korrekt gespeichert
JSON-Syntaxfehler verhindern das Laden der Konfiguration
Cursor cached alte Konfiguration

Schritt 1: Speicherort der Konfigurationsdatei prüfen

Stellen Sie zuerst sicher, dass Sie die richtige Datei bearbeiten:

Korrekter Pfad zur Konfigurationsdatei

Speicherort der Cursor-MCP-Konfiguration

~/.cursor/mcp.json

Vollständige Pfade:

macOS/Linux: /Users/yourusername/.cursor/mcp.json
Windows: C:\Users\yourusername\.cursor\mcp.json

Häufige Speicherort-Fehler

Falsch: Workspace-Konfiguration

.cursor/mcp.json im Projekt-Workspace bearbeiten

Lösung: Konfiguration im Home-Verzeichnis nutzen: ~/.cursor/mcp.json

Falsch: Anderer Dateiname

mcp_config.json oder cursor-mcp.json bearbeiten

Lösung: Datei muss exakt mcp.json heißen

Falsch: Falsches Verzeichnis

Datei in ~/.config/cursor/ oder anderem Ort bearbeiten

Lösung: Muss im Verzeichnis ~/.cursor/ liegen (mit Punkt)

Speicherort prüfen

Prüfen, dass Sie die richtige Datei bearbeiten:

Terminal/Eingabeaufforderung öffnen
Ins Home-Verzeichnis wechseln: cd ~
Prüfen, ob die Datei existiert: ls -la .cursor/mcp.json (macOS/Linux) oder dir .cursor\mcp.json (Windows)
Genau diese Datei im Editor öffnen

Schritt 2: Neustart vs. Reload

Cursor benötigt einen vollständigen Neustart oder Fenster-Reload, damit Konfigurationsänderungen übernommen werden:

Option 1: Vollständiger Neustart (empfohlen)

Schritte für vollständigen Neustart

Datei mcp.json speichern
Cursor vollständig beenden (Cmd+Q unter macOS, Alt+F4 unter Windows oder Datei → Beenden)
2–3 Sekunden warten, bis der Prozess vollständig beendet ist
Cursor erneut öffnen
Warten, bis Cursor vollständig initialisiert ist
Prüfen, ob der MCP-Server erscheint

Option 2: Fenster neu laden

Reload reicht nicht immer

Manchmal reicht Fenster neu laden, aber nicht immer:

Datei mcp.json speichern
Befehlspalette öffnen: Cmd+Shift+P (macOS) oder Ctrl+Shift+P (Windows/Linux)
"Reload Window" eingeben und auswählen
Warten, bis das Fenster neu geladen ist
Wenn der MCP-Server weiterhin nicht erscheint, vollständigen Neustart versuchen

Nicht nur Fenster schließen

Das einfache Schließen des Cursor-Fensters beendet die Anwendung möglicherweise nicht vollständig. Prüfen:

macOS: Dock auf Cursor-Symbol prüfen (Rechtsklick → Beenden, falls noch aktiv)
Windows: Systembereich auf Cursor-Prozess prüfen
Linux: Prüfen, ob Cursor-Prozess noch läuft: ps aux | grep cursor

Schritt 3: Aktive Serverliste prüfen

Nach dem Neustart prüfen, ob Cursor Ihre MCP-Server geladen hat:

MCP-Server-Status prüfen

So prüfen Sie, ob MCP-Server geladen sind:

MCP-Server-Anzeige in der Cursor-Oberfläche suchen
Cursor-Einstellungen auf MCP-Serverliste prüfen
"What MCP tools are available?" fragen
Corcava-Tools in der verfügbaren Tool-Liste suchen

Test-Prompt

Verifizierungs-Prompt

"What MCP servers are configured? List available MCP tools."

Wenn Corcava MCP funktioniert, sollten Sie Tools wie list_tasks, get_task, create_task usw. sehen.

Schritt 4: JSON-Fehler prüfen

Ungültiges JSON verhindert, dass Cursor die Konfiguration lädt:

JSON-Syntax validieren

JSON-Fehler verhindern das Laden

Bei JSON-Syntaxfehlern in der Konfiguration lädt Cursor sie stillschweigend nicht:

Nachgestellte Kommas
Fehlende Anführungszeichen
Nicht passende Klammern
Kommentare (JSON unterstützt keine Kommentare)

Siehe Konfigurations-JSON-Fehler für detaillierte Lösungen.

Konfiguration validieren

JSON-Gültigkeit testen:

Gesamten Inhalt von mcp.json kopieren
In JSONLint oder ähnlichen Validator einfügen
Gemeldete Fehler beheben
Korrigierte Datei speichern
Cursor neu starten

Schritt 5: Cursor-Cache leeren

Manchmal cached Cursor die alte Konfiguration. Cache leeren, um einen frischen Laden zu erzwingen:

Cache-Speicherorte

macOS

rm -rf ~/Library/Caches/com.todesktop.230313mzl4w4u92
# Dann Cursor neu starten

Windows

Entfernen: %APPDATA%\Cursor\Cache
# Dann Cursor neu starten

Linux

rm -rf ~/.cache/cursor
# Dann Cursor neu starten

Hinweis zum Cache-Leeren

Beim Leeren des Caches werden auch andere Cursor-Einstellungen entfernt. Nur durchführen, wenn andere Schritte nicht geholfen haben.

Schritt 6: Prüfen, ob die Konfigurationsdatei gespeichert wurde

Sicherstellen, dass Ihre Änderungen tatsächlich auf der Festplatte gespeichert wurden:

Speicher-Prüfung

Prüfen, ob die Datei gespeichert wurde:

Datei im Editor schließen
~/.cursor/mcp.json erneut öffnen
Prüfen, ob Ihre Änderungen noch da sind
Änderungszeitstempel der Datei prüfen (sollte aktuell sein)

Häufige Speicher-Probleme

Datei nicht gespeichert

Symptom: Änderungen verschwinden beim erneuten Öffnen
Lösung: Datei vor dem Schließen speichern (Cmd+S / Ctrl+S)

Falsche Datei gespeichert

Symptom: Andere Datei oder Workspace-Kopie gespeichert
Lösung: Prüfen, dass Sie ~/.cursor/mcp.json (Home-Verzeichnis, nicht Workspace) bearbeiten

Schnell-Checkliste

Systematische Fehlerbehebung

✅ Konfigurationsdatei-Speicherort geprüft: ~/.cursor/mcp.json (Home-Verzeichnis)
✅ JSON-Syntax validiert (keine Fehler im Validator)
✅ Datei gespeichert und geprüft, dass Änderungen erhalten blieben
✅ Cursor vollständig beendet (nicht nur Fenster geschlossen)
✅ Nach dem Beenden einige Sekunden gewartet
✅ Cursor vollständig neu gestartet
✅ Gewartet, bis Cursor vollständig initialisiert ist
✅ Geprüft, dass der MCP-Server in Cursor erscheint
✅ Mit "What MCP tools are available?" getestet

Immer noch nicht in Ordnung?

Wenn Konfigurationsänderungen nach allen Schritten weiterhin nicht greifen:

Cursor-Protokolle auf Fehlermeldungen prüfen (Hilfe → Entwicklertools ein-/ausblenden → Konsole)
Minimale Konfiguration nur mit Corcava zum Testen anlegen
Cursor-Version prüfen (ältere Versionen können MCP-Probleme haben)
Tools werden nicht aufgelistet für weitere Fehlerbehebung
Verbindung fehlgeschlagen bei Netzwerkproblemen