Corcava logo Das einzige Business-Tool, das Sie brauchen Corcava
Menü
Lösungen
Branchen
Designer Personal & Recruiting Kanzleien Immobilien Beratung Marketing Digital Buchhaltung E-Commerce Softwareentwicklung
Produkt
Funktionen Integrationen
Blog Herunterladen
Ressourcen
Templates Doku MCP FAQ API Vergleiche Roadmap Neues $ Partnerprogramm
Preise
14-tägige kostenlose Testversion

Keine Kreditkarte erforderlich

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

← Windows MCP-Konfigurationspfade: Richtige Datei finden und bearbeiten
429 Rate Limited bei MCP: Weniger Tool-Aufrufe und sicheres Retry →

Verwandte Artikel

Windsurf MCP-Fehlerbehebung: Auth-Header werden nicht gesendet

Windsurf verbindet mit Corcava MCP, aber Tool-Aufrufe schlagen fehl? Diese Windsurf-spezifische Anleitung hilft, wenn der Server verbindet, Tool-Aufrufe aber wegen fehlender Authorization-Header mit 4...

MCP-Tool-Aufrufe schlagen fehl: Eingaben, Validierung und Fehler-Payloads debuggen

MCP-Tools werden angezeigt, aber Aufrufe schlagen fehl? Diese allgemeine Anleitung hilft beim Debuggen von Tool-Aufruf-Fehlern: ungültige Argumente, fehlende Pflichtfelder, falsche IDs und serverseiti...

MCP-Tools werden nicht aufgelistet: Warum tools/list leer zurückgibt

MCP-Server verbindet, aber es erscheinen keine Tools? Diese Anleitung hilft, Fälle zu beheben, in denen tools/list leer zurückgibt. So diagnostizieren Sie stille Auth-Fehler bei bestehender Verbindung...

Kundenorganisation & Hierarchie

Das Kundenverwaltungssystem bietet umfassende Möglichkeiten zur Unternehmensorganisation:

Mehrstufige Authentifizierung (MFA)

Schützen Sie Ihr Konto mit einer zusätzlichen Sicherheitsebene durch zeitbasierte Einmalpasswörter (TOTP) über Authenticator-Apps wie Google Authenticator oder Authy.

Plattformübergreifende Synchronisation

Ihre Arbeit bleibt auf allen Geräten aktuell. Projekte, Aufgaben, Zeiteinträge, Rechnungen und Nachrichten werden nahtlos zwischen Web-, Desktop- und mobilen Apps synchronisiert.