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
- Windsurf auf Ihrem System installiert
- Corcava-Konto mit API-Key-Zugang
- Zugang zu den Windsurf-Einstellungen
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
Schritt 2: Windsurf-Einstellungen öffnen
Windsurf nutzt eine Einstellungs-UI für die MCP-Konfiguration (keine Dateibearbeitung nötig):
- Windsurf öffnen
- Auf das Einstellungen-Symbol (Zahnrad) klicken oder
Cmd+,(macOS) /Strg+,(Windows/Linux) nutzen - Zum Bereich AI oder MCP wechseln
- 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_KEYdurch den kopierten API-Key ersetzen- Zwischen „Bearer“ und dem API-Key muss ein Leerzeichen stehen
Schritt 4: Speichern und Windsurf neu starten
- In den Einstellungen Speichern oder Übernehmen klicken
- Windsurf vollständig beenden
- 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:
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:
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.
Fehlerbehebung
❌ Auth-Header werden nicht gesendet
Symptom: Verbindung steht, aber Tool-Aufrufe schlagen mit 401 fehl
❌ Tools werden nicht angezeigt
Windsurf vollständig beenden und neu starten. Endpoint-URL und Auth-Header-Format prüfen.
Windsurf mit Corcava verbinden
Projektmanagement in Ihre IDE holen
Keine Kreditkarte erforderlich