Corcava-MCP-Setup für Cursor: Aufgaben und Projekte im Editor verbinden

Cursor per MCP mit Corcava verbinden und Projektmanagement direkt in der IDE nutzen. So fügen Sie Corcava als MCP-Server hinzu, starten neu bzw. laden neu und testen Ihren ersten Workflow.

Voraussetzungen

Cursor 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. „Cursor – Arbeits-Laptop“), um mehrere Keys einfach zu verwalten.

Schritt 2: MCP-Konfigurationsdatei finden

Cursor speichert die MCP-Server-Konfiguration plattformübergreifend in einer Datei:

Speicherort der Konfigurationsdatei

~/.cursor/mcp.json

Das Zeichen ~ steht für Ihr Benutzerverzeichnis:

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

Wenn die Datei nicht existiert

Falls ~/.cursor/mcp.json nicht vorhanden ist:

Ordner .cursor im Home-Verzeichnis anlegen (falls nötig)
Neue Datei mcp.json anlegen
Mit leerem JSON-Objekt starten: {}

Schritt 3: Corcava-MCP-Server-Konfiguration eintragen

~/.cursor/mcp.json in einem Texteditor öffnen und die Corcava-MCP-Server-Konfiguration eintragen.

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: Speichern und Cursor neu starten

Datei mcp.json speichern
Cursor vollständig beenden (nicht nur Fenster schließen)
Cursor neu starten
Warten, bis Cursor vollständig geladen hat

Alternative: Fenster neu laden

Einige Cursor-Versionen unterstützen Neuladen ohne kompletten Neustart:

Cmd+Shift+P (macOS) bzw. Strg+Shift+P (Windows/Linux) drücken
„Reload Window“ eingeben und auswählen

Hinweis: Vollständiger Neustart ist zuverlässiger. Neuladen nur, wenn Neustart nicht hilft.

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

Nach dem Neustart prüfen, ob die KI in Cursor die Corcava-MCP-Tools sieht:

Verifizierungs-Prompt

Im Cursor-Chat fragen:

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

Erwartete Antwort:

Die KI sollte u. a. folgende Tools nennen:

list_tasks
get_task
create_task
update_task
list_projects
start_time_tracking
und weitere …

Schritt 6: Erster Test-Workflow

Diese Workflows zum Testen der Verbindung ausprobieren:

1. Aufgaben auflisten

Prompt:

"Welche Aufgaben habe ich in Corcava?"

Erwartung: KI listet Ihre Aufgaben auf oder meldet, dass keine vorhanden sind.

2. Eine Aufgabe öffnen

Prompt:

"Zeige mir die Details zur Aufgabe [Aufgabenname]"

Erwartung: KI lädt und zeigt Aufgabendetails inkl. Beschreibung, Status und Kommentare.

3. Fortschritts-Kommentar hinzufügen

Prompt:

"Füge zur Aufgabe [Aufgabenname] einen Kommentar hinzu: 'API-Änderungen fertig, bereit für Review'"

Erwartung: KI fügt den Kommentar zur Aufgabe hinzu.

Hinweis: Das ist eine Schreiboperation. Die KI sollte vor dem Hinzufügen um Bestätigung bitten.

IDE-Workflows

Die Cursor-Integration mit Corcava ermöglicht IDE-Workflows wie:

Code mit Aufgabe verknüpfen

Code-Änderungen mit Corcava-Aufgaben verknüpfen:

"Ich arbeite an der Login-Feature-Aufgabe. Hilf mir bei der Umsetzung und füge danach einen Kommentar hinzu."

Aufgabenkontext im Editor

Anforderungen der Aufgabe beim Coden abrufen:

"Was sind die Akzeptanzkriterien für die Dashboard-Aufgabe?"

Fortschritts-Updates

Fortschritt direkt aus dem Editor loggen:

"Setze den Status der API-Refactor-Aufgabe auf in Bearbeitung und füge einen Kommentar zu meinen Änderungen hinzu."

Fehlerbehebung

❌ Verbindung oder Auth schlägt fehl

Mögliche Ursachen:

Ungültiger API-Key oder falsches Header-Format
API-Key wurde widerrufen
Netzwerkprobleme

Abhilfe:

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

401-Fehlerbehebung →

Verbindungs-Fehlerbehebung →

❌ Änderungen nach Konfig-Anpassung nicht aktiv

Mögliche Ursachen:

Cursor nicht vollständig neu gestartet
Konfigurationsdatei am falschen Ort
JSON-Syntaxfehler

Abhilfe:

Prüfen, ob Konfigurationsdatei unter ~/.cursor/mcp.json liegt
JSON-Syntax validieren
Cursor vollständig beenden und neu starten (nicht nur Neuladen)
Cursor-Logs auf Fehlermeldungen prüfen

Cursor-Neulade-Fehlerbehebung →

❌ Tools werden nicht angezeigt

Mögliche Ursachen:

MCP-Server-Verbindung fehlgeschlagen
Auth-Fehler bei bestehender Verbindung
Client-Caching

Abhilfe:

Zuerst Verbindung und Auth prüfen
Vollständigen Neustart (nicht nur Neuladen) ausführen
Endpoint-URL prüfen

Tools-Fehlerbehebung →

Weitere Schritte

Cursor-Workflows

Wochenplanung, Statusberichte und Zeiterfassung aus der IDE

Editor-Workflows

Aufgaben umsetzen und Fortschritt in Corcava loggen

Cursor mit Corcava verbinden

Projektmanagement in Ihre IDE holen

Kostenlose Testversion → Cursor-Workflows

Keine Kreditkarte erforderlich