macOS MCP-Konfigurationspfade: Richtige Datei finden und bearbeiten

MCP-Konfiguration unter macOS finden oder bearbeiten? Diese macOS-spezifische Anleitung zeigt, wo jeder MCP-Client seine Konfigurationsdateien speichert, wie Sie sie mit Finder oder Terminal sicher öffnen und bearbeiten und typische macOS-Pfadfallen vermeiden.

macOS-Konfigurationspfade verstehen

Unter macOS speichern MCP-Clients Konfigurationsdateien an unterschiedlichen Orten. Manche nutzen Ihr Home-Verzeichnis mit versteckten Ordnern (mit Punkt beginnend), andere Application-Support-Ordner. Diese Anleitung deckt die gängigen Speicherorte ab.

macOS-Pfadkonventionen

• ~ = /Users/YourUsername (Home-Verzeichnis)
• ~/Library/Application Support/ = Anwendungsspezifischer Datenordner
• Versteckte Ordner beginnen mit einem Punkt (z. B. .cursor)
• Pfade verwenden Schrägstriche (/)
• Finder blendet den Library-Ordner standardmäßig aus

MCP-Client-Konfigurationsspeicherorte unter macOS

Claude Desktop

Pfad zur Konfigurationsdatei:

~/Library/Application Support/Claude/claude_desktop_config.json

Vollständiges Beispiel:

/Users/YourUsername/Library/Application Support/Claude/claude_desktop_config.json

So öffnen Sie die Datei

Methode 1: Finder "Gehe zu Ordner"

1. Finder öffnen
2. Cmd+Shift+G (Gehe zu Ordner) drücken
3. Einfügen: ~/Library/Application Support/Claude
4. Enter drücken
5. claude_desktop_config.json in einem Texteditor öffnen

Methode 2: Terminal

cd ~/Library/Application\ Support/Claude
open -a "Visual Studio Code" claude_desktop_config.json

Oder nano, vim oder Ihren bevorzugten Editor nutzen

Cursor

Pfad zur Konfigurationsdatei:

~/.cursor/mcp.json

Vollständiges Beispiel:

/Users/YourUsername/.cursor/mcp.json

Versteckter Ordner

Der Ordner .cursor ist standardmäßig versteckt. So sichtbar machen:

1. Finder öffnen
2. Cmd+Shift+. (Punkt) drücken, um versteckte Dateien anzuzeigen
3. Zu Ihrem Home-Verzeichnis navigieren
4. Ordner .cursor öffnen

So öffnen Sie die Datei

Methode 1: Terminal (am einfachsten)

cd ~/.cursor
open -a "Visual Studio Code" mcp.json

Methode 2: Finder

1. Cmd+Shift+. drücken, um versteckte Dateien anzuzeigen
2. Cmd+Shift+G (Gehe zu Ordner) drücken
3. ~ eingeben und Enter drücken
4. Ordner .cursor öffnen
5. mcp.json öffnen

Windsurf

Konfigurationsspeicherort:

Windsurf kann nutzen:

• Einstellungen-Oberfläche (über die Windsurf-Oberfläche konfiguriert)
• Konfigurationsdatei: ~/Library/Application Support/Windsurf/mcp.json (bei dateibasierter Konfiguration)

Zuerst Einstellungen-Oberfläche prüfen

1. Windsurf öffnen
2. Zu Einstellungen → MCP-Server gehen
3. Prüfen, ob Corcava MCP dort konfiguriert ist
4. Falls nicht, über die Oberfläche hinzufügen (bevorzugt)

Continue

Pfad zur Konfigurationsdatei:

~/Library/Application Support/Continue/config.json

Vollständiges Beispiel:

/Users/YourUsername/Library/Application Support/Continue/config.json

Schritt 1: Versteckte Dateien im Finder anzeigen

Viele Konfigurationsdateien liegen in versteckten Ordnern. Zuerst die Anzeige versteckter Dateien aktivieren:

Versteckte Dateien im Finder anzeigen

1. Finder öffnen
2. Cmd+Shift+. (Punkt-Taste) drücken
3. Versteckte Dateien und Ordner sind nun sichtbar (grau dargestellt)
4. Erneut drücken, um sie auszublenden

Schritt 2: Auf den Library-Ordner zugreifen

Der Library-Ordner ist standardmäßig versteckt. So greifen Sie darauf zu:

Methode 1: Gehe zu Ordner (empfohlen)

1. Finder öffnen
2. Cmd+Shift+G (Gehe zu Ordner) drücken
3. Eingeben: ~/Library
4. Enter drücken
5. Zu Application Support → Ihrem App-Ordner navigieren

Methode 2: Terminal

cd ~/Library/Application\ Support/Claude
open .

Öffnet den Ordner im Finder

Methode 3: Library dauerhaft sichtbar machen

1. Finder öffnen
2. Zu Ihrem Home-Ordner gehen
3. Cmd+J (Ansichtsoptionen) drücken
4. "Library-Ordner anzeigen" aktivieren
5. Library ist nun dauerhaft sichtbar

Schritt 3: Zur Konfigurationsdatei navigieren

Eine dieser Methoden nutzen, um schnell zu den Konfigurationsdateien zu gelangen:

Methode 1: Terminal (am schnellsten)

Für versteckte Ordner (z. B. .cursor):

cd ~/.cursor
open -a "Visual Studio Code" mcp.json

Für Application-Support-Ordner:

cd ~/Library/Application\ Support/Claude
open -a "Visual Studio Code" claude_desktop_config.json

Methode 2: Finder Gehe zu Ordner

1. Finder öffnen
2. Cmd+Shift+G drücken
3. Pfad eingeben (z. B. ~/.cursor oder ~/Library/Application Support/Claude)
4. Enter drücken
5. Konfigurationsdatei öffnen

Schritt 4: Konfigurationsdatei sicher bearbeiten

Vor dem Bearbeiten diese Sicherheitsmaßnahmen beachten:

Sicherheits-Checkliste

• ✅ MCP-Client vor dem Bearbeiten schließen (Cursor, Claude Desktop usw.)
• ✅ Sicherungskopie der Konfigurationsdatei anlegen
• ✅ Editor mit JSON-Unterstützung nutzen (VS Code, TextEdit, BBEdit)
• ✅ JSON-Syntax vor dem Speichern validieren
• ✅ Datei vor dem Schließen speichern

Empfohlene Editoren

• VS Code: Beste Wahl, JSON-Validierung eingebaut
• TextEdit: Vorhanden, funktioniert – "Reiner Text"-Modus aktivieren
• BBEdit: Sehr gute Alternative mit Syntaxhervorhebung
• nano/vim: Terminal-Editoren, gut für schnelle Änderungen

Sicherung anlegen

Schnelle Sicherung:

1. Im Finder Rechtsklick auf die Konfigurationsdatei
2. "Duplizieren" wählen
3. Kopie in config.json.backup umbenennen

Oder im Terminal:

cp mcp.json mcp.json.backup

Schritt 5: JSON-Syntax validieren

Ungültiges JSON verhindert, dass der MCP-Client Ihre Konfiguration lädt:

Häufige JSON-Fehler unter macOS

• Nachgestellte Kommas (in JSON nicht erlaubt)
• Fehlende Anführungszeichen um Schlüssel
• Falsche Verschachtelung oder Klammern
• Sonderzeichen nicht escaped

Vor dem Speichern validieren

Validierungsmethoden

• VS Code: Zeigt JSON-Fehler mit roten Wellenlinien
• Online: Inhalt in JSONLint einfügen
• Terminal: python3 -m json.tool config.json (validiert Syntax)

Schritt 6: Typische macOS-spezifische Probleme

Problem 1: Datei nicht gefunden

Symptom

Konfigurationsdatei existiert nicht am erwarteten Ort

Lösung

1. Prüfen, ob der übergeordnete Ordner existiert (z. B. .cursor)
2. Falls nicht, anlegen: mkdir -p ~/.cursor
3. Konfigurationsdatei anlegen: echo '{}' > ~/.cursor/mcp.json
4. MCP-Server-Konfiguration hinzufügen

Problem 2: Zugriff verweigert

Symptom

Änderungen an der Konfigurationsdatei können nicht gespeichert werden

Lösung

1. Dateiberechtigungen prüfen: ls -l ~/.cursor/mcp.json
2. Bei Bedarf korrigieren: chmod 644 ~/.cursor/mcp.json
3. Sicherstellen, dass Sie Eigentümer sind: chown $USER ~/.cursor/mcp.json

Problem 3: Finder vs. Terminal Pfadverwechslung

Symptom

Datei nicht gefunden oder falscher Speicherort bearbeitet

Lösung

• ~ für Home-Verzeichnis nutzen (funktioniert in Finder und Terminal)
• Aktuelles Verzeichnis prüfen: pwd im Terminal
• Bei Unsicherheit absolute Pfade nutzen: /Users/YourUsername/.cursor/mcp.json
• Gehe zu Ordner (Cmd+Shift+G) für genaue Finder-Navigation

Problem 4: TextEdit-Formatierungsprobleme

Symptom

TextEdit fügt Formatierung hinzu oder speichert als RTF

Lösung

1. In TextEdit: Format → In reinen Text umwandeln
2. Oder im Terminal: defaults write com.apple.TextEdit RichText -int 0
3. Besser: VS Code oder anderen Code-Editor nutzen

Schnelle Validierungsroutine

Vor dem Neustart des MCP-Clients

1. ✅ Richtige Konfigurationsdatei für Ihren Client gefunden
2. ✅ Versteckte Dateien im Finder aktiviert (Cmd+Shift+.), falls nötig
3. ✅ Sicherungskopie der ursprünglichen Konfiguration angelegt
4. ✅ JSON-Syntax validiert (keine Fehler)
5. ✅ Datei erfolgreich gespeichert
6. ✅ MCP-Client vor dem Bearbeiten geschlossen
7. ✅ Dateiberechtigungen erlauben Schreiben

Erster Test-Prompt

Nach dem Neustart des MCP-Clients mit diesem Prompt testen:

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

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

Kurzreferenz: Alle macOS-Pfade

Verwandte Fehlerbehebung

• Konfigurations-JSON-Fehler – JSON-Syntaxfehler in Konfigurationsdateien beheben
• Cursor-Konfigurationsprobleme – Cursor-Konfiguration wird nach Bearbeitung nicht übernommen
• Windows-Konfigurationspfade – Konfigurationsdateien unter Windows finden
• Fehlerbehebungs-Übersicht – Alle Fehlerbehebungsanleitungen durchsuchen