Corcava logo Das einzige Business-Tool, das Sie brauchen Corcava
Menü

Corcava-MCP-Setup für Windsurf: Projektmanagement-Tools in der IDE

Windsurf per MCP mit Corcava verbinden und Projektmanagement direkt in der IDE nutzen. Dieser Guide beschreibt die Konfigurationsschritte, wo Endpoint und Header eingetragen werden, und eine erste Nutzung.

Voraussetzungen

Schritt 1: Corcava-API-Key holen

  1. Bei Corcava anmelden
  2. EinstellungenIntegrationen öffnen
  3. Bereich Public API finden
  4. Auf API-Key hinzufügen klicken
  5. Key sofort kopieren (wird nur einmal angezeigt)
  6. Sicher aufbewahren – wird im nächsten Schritt benötigt

Schritt 2: Windsurf-Einstellungen öffnen

Windsurf nutzt eine Einstellungs-UI für die MCP-Konfiguration (keine Dateibearbeitung nötig):

  1. Windsurf öffnen
  2. Auf das Einstellungen-Symbol (Zahnrad) klicken oder Cmd+, (macOS) / Strg+, (Windows/Linux) nutzen
  3. Zum Bereich AI oder MCP wechseln
  4. Die MCP-Server-Konfiguration finden

Schritt 3: Corcava-MCP-Server hinzufügen

Im Bereich MCP-Server einen neuen Server mit diesen Angaben anlegen:

Konfigurationswerte

  • Name: corcava (oder ein anderer Name)
  • URL: https://app.corcava.com/mcp
  • Authorization: Bearer IHR_API_KEY

⚠️ Wichtig

  • IHR_API_KEY durch den kopierten API-Key ersetzen
  • Zwischen „Bearer“ und dem API-Key muss ein Leerzeichen stehen

Schritt 4: Speichern und Windsurf neu starten

  1. In den Einstellungen Speichern oder Übernehmen klicken
  2. Windsurf vollständig beenden
  3. Windsurf neu starten

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

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

Verifizierungs-Prompt

Im KI-Chat von Windsurf fragen:

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

Schritt 6: Erste Nutzung

Diesen Workflow zum Testen der Verbindung und zum Anlegen der ersten Aufgabe ausprobieren:

Aufgabe anlegen und mit Coding-Session verknüpfen

Prompt:

"Lege in Corcava eine Aufgabe für die Implementierung des Benutzer-Authentifizierungs-Features an. Zeige mir vorher, was du anlegen wirst."

FAQ: Berechtigungen und Schreibsicherheit

F: Welche Berechtigungen hat der API-Key?

A: Der API-Key gewährt vollen Zugriff auf Ihren Corcava-Workspace. Key sicher aufbewahren und nicht weitergeben.

F: Wie verhindere ich versehentliche Schreibzugriffe?

A: In Ihren Prompts Bestätigungsmuster nutzen. Die KI bitten, anzuzeigen, was sie anlegen/aktualisieren wird, bevor sie es tut.

Sichere Schreib-Workflows →

Fehlerbehebung

❌ Auth-Header werden nicht gesendet

Symptom: Verbindung steht, aber Tool-Aufrufe schlagen mit 401 fehl

Windsurf-Auth-Fehlerbehebung →

❌ Tools werden nicht angezeigt

Windsurf vollständig beenden und neu starten. Endpoint-URL und Auth-Header-Format prüfen.

Tools-Fehlerbehebung →

Windsurf mit Corcava verbinden

Projektmanagement in Ihre IDE holen

Keine Kreditkarte erforderlich