Corcava-MCP-Setup für Claude Desktop (macOS, Windows, Linux)

Schritt-für-Schritt-Anleitung, um Claude Desktop per MCP mit Corcava zu verbinden. Konfigurationsdatei-Pfade für alle Betriebssysteme, JSON-Struktur, Verifizierung und häufige Fehlerbehebung.

Voraussetzungen

Claude Desktop auf Ihrem System installiert
Corcava-Konto mit API-Key-Zugang
Grundkenntnisse im Bearbeiten von JSON-Dateien

Schritt 1: Corcava-API-Key holen

Bei Corcava anmelden
Einstellungen → Integrationen öffnen
Bereich Public API finden
Auf API-Key hinzufügen klicken
Key sofort kopieren (wird nur einmal angezeigt)
Sicher aufbewahren – wird im nächsten Schritt benötigt

💡 Tipp

API-Key aussagekräftig benennen (z. B. „Claude Desktop – MacBook Pro“), um mehrere Keys einfach zu verwalten.

Schritt 2: Konfigurationsdatei finden

Der Speicherort der Konfigurationsdatei hängt vom Betriebssystem ab:

macOS

Pfad:

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

Im Finder: Cmd+Shift+G drücken und Pfad einfügen.

Windows

Pfad:

%APPDATA%\Claude\claude_desktop_config.json

Im Explorer: Win+R, %APPDATA%\Claude eingeben und Enter.

Linux

Pfad:

~/.config/Claude/claude_desktop_config.json

Das Zeichen ~ steht für Ihr Benutzerverzeichnis.

Wenn die Datei nicht existiert

Falls die Konfigurationsdatei noch nicht vorhanden ist:

Bei Bedarf Verzeichnis anlegen (z. B. ~/.config/Claude/ unter Linux)
Neue Datei claude_desktop_config.json anlegen
Mit leerem JSON-Objekt starten: {}

Schritt 3: Corcava-MCP-Server-Konfiguration eintragen

Konfigurationsdatei in einem Texteditor öffnen und den Corcava-MCP-Server eintragen. Die genaue Struktur hängt davon ab, ob bereits andere MCP-Server konfiguriert sind.

Wenn dies Ihr erster MCP-Server ist

Wenn die Datei leer ist oder keine mcpServers-Sektion hat, diese Struktur verwenden:

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer IHR_API_KEY"
      }
    }
  }
}

Wenn Sie bereits andere MCP-Server haben

Falls bereits MCP-Server konfiguriert sind, Corcava zum bestehenden mcpServers-Objekt hinzufügen:

{
  "mcpServers": {
    "existing-server": {
      ...
    },
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer IHR_API_KEY"
      }
    }
  }
}

⚠️ Wichtig

IHR_API_KEY durch den in Schritt 1 kopierten API-Key ersetzen
Zwischen „Bearer“ und dem API-Key muss ein Leerzeichen stehen
Den API-Key im Header-Wert nicht in Anführungszeichen setzen
JSON muss gültig sein (keine trailing commas, korrekte Anführungszeichen)

Schritt 4: JSON-Syntax prüfen

Vor dem Speichern die JSON-Syntax validieren:

Online-Validator: z. B. jsonlint.com
Kommandozeile: python -m json.tool claude_desktop_config.json
VS Code: Zeigt JSON-Syntaxfehler an

Typische JSON-Fehler

Trailing commas (z. B. Komma nach dem letzten Eintrag)
Fehlende Anführungszeichen bei Keys oder Werten
Einfache statt doppelte Anführungszeichen
Fehlende Kommas zwischen Objekteigenschaften

Schritt 5: Speichern und Claude Desktop neu starten

Konfigurationsdatei speichern
Claude Desktop vollständig beenden (nicht nur minimieren)
Claude Desktop neu starten
Warten, bis Claude vollständig geladen hat (kann einige Sekunden dauern)

Warum Neustart nötig ist

Claude Desktop lädt die MCP-Server-Konfiguration nur beim Start. Einfaches Speichern reicht nicht – die Anwendung muss vollständig beendet und neu gestartet werden.

Schritt 6: Prüfen, ob Tools verfügbar sind

Nach dem Neustart prüfen, ob Claude die Corcava-MCP-Tools sieht:

Verifizierungs-Prompt

Claude fragen:

"Welche MCP-Tools von Corcava sind verfügbar?"

Erwartete Antwort:

Claude sollte u. a. folgende Tools nennen:

list_tasks
get_task
create_task
update_task
list_projects
start_time_tracking
und weitere …

Erster Test: Aufgaben auflisten

Einfache Nur-Lesen-Operation ausprobieren:

Prompt:

"Welche Aufgaben habe ich in Corcava?"

Erwartung: Claude listet Ihre Aufgaben (oder meldet, dass keine vorhanden sind).

Fehlerbehebung

❌ „Authorization failed“ oder 401

Mögliche Ursachen:

API-Key falsch oder mit Leerzeichen
„Bearer“-Präfix fehlt oder Leerzeichen nach „Bearer“ fehlt
API-Key wurde widerrufen oder gelöscht
Leerzeichen beim Kopieren des Keys

Abhilfe:

In Corcava unter Einstellungen → Integrationen prüfen, ob Key aktiv ist
Header-Format prüfen: "Authorization": "Bearer IHR_API_KEY" (mit Leerzeichen)
API-Key ggf. neu erzeugen

401-Fehlerbehebung →

❌ Tools werden nicht angezeigt

Mögliche Ursachen:

Claude Desktop nicht vollständig neu gestartet
JSON-Syntaxfehler in der Konfigurationsdatei
Konfigurationsdatei am falschen Ort
MCP-Server-Verbindung schlägt still fehl

Abhilfe:

JSON-Syntax validieren (z. B. jsonlint.com)
Prüfen, ob Konfigurationsdatei am betriebssystemspezifischen Ort liegt
Claude Desktop vollständig beenden und neu starten
Claude-Desktop-Logs auf Fehlermeldungen prüfen

Tools-Fehlerbehebung →

❌ „Connection refused“ oder Netzwerkfehler

Mögliche Ursachen:

Internetverbindung
Firewall blockiert HTTPS
Firmen-Proxy
Corcava vorübergehend nicht erreichbar

Abhilfe:

Prüfen, ob https://app.corcava.com im Browser erreichbar ist
Netzwerk-/Firewall-Einstellungen prüfen
API-Key ggf. neu erzeugen

Verbindungs-Fehlerbehebung →

❌ Ungültige JSON

Typische Fehler:

Trailing comma nach letzter Eigenschaft
Fehlende Anführungszeichen bei Keys oder Werten
Einfache statt doppelte Anführungszeichen
Fehlendes Komma zwischen Eigenschaften

Abhilfe:

JSON-Validator nutzen (jsonlint.com)
Auf trailing commas prüfen
Alle Strings in doppelten Anführungszeichen

JSON-Fehlerbehebung →

Beispiel-Workflows

Nach der Verbindung diese Prompts ausprobieren:

Wochenplanung

Prompt:

"Welche Aufgaben haben diese Woche in Corcava Fälligkeit? Zeige Fälliges, Blockiertes und was ich priorisieren sollte."

Follow-up-Aufgabe anlegen

Prompt:

"Lege eine Aufgabe an: nächste Woche Acme Corp nachfassen. Zeige mir vorher, was du anlegen willst."

Zeiterfassung

Prompt:

"Starte Zeiterfassung für die Aufgabe [Aufgabenname]"

Weitere Workflows im Anwendungsfälle-Guide.

Weitere Schritte

Claude-Desktop-Workflows

Wochenplanung, Statusberichte und Zeiterfassungs-Prompts

Sicherheits-Best-Practices

API-Key-Verwaltung und sichere Schreiboperationen

Bereit zum Start?

Claude Desktop in wenigen Minuten mit Corcava verbinden

Kostenlose Testversion → 5-Minuten-Quickstart

Keine Kreditkarte erforderlich