KI-Assistent-Integration (MCP)

Überblick

Diese Anleitung erklärt, wie Sie KI-Assistenten wie Claude Desktop, Cursor, Windsurf und Continue mit Ihrem Corcava-Arbeitsbereich über das Model Context Protocol (MCP) verbinden. Nach der Verbindung kann Ihr KI-Assistent Aufgaben lesen, Aufgaben anlegen, Zeit erfassen und Sie durch natürliche Unterhaltung effizienter arbeiten lassen.

Sie lernen:

Wie Sie Ihren API-Schlüssel erhalten
Universelles Konfigurationsformat für alle Clients
Client-spezifische Einrichtungsanleitungen
Wie Sie Ihre Verbindung prüfen
Was Ihre KI mit Corcava tun kann

Detaillierte, client-spezifische Einrichtungsanleitungen finden Sie in unseren Anleitungen:

Claude Desktop Einrichtung – macOS, Windows, Linux
Cursor Einrichtung – IDE-fokussiert mit Workflow-Beispielen
Windsurf Einrichtung – Einstellungen-UI-Konfiguration
Continue Einrichtung – SSE-Transport-Konfiguration

Was ist MCP?

MCP (Model Context Protocol) ist ein offener Standard, der es KI-Assistenten ermöglicht, sich mit externen Tools und Datenquellen zu verbinden. Mit der Corcava-MCP-Integration erhält Ihr KI-Assistent direkten Zugriff auf Ihre Projekte, Aufgaben und Zeiterfassung.

API-Schlüssel erhalten

Vor der Konfiguration Ihres KI-Assistenten benötigen Sie einen API-Schlüssel:

Zu Einstellungen → Integrationen gehen
Den Abschnitt Öffentliche API finden
Auf API-Schlüssel hinzufügen klicken
Den erzeugten Schlüssel sofort kopieren (er wird nur einmal angezeigt)
Ihn sicher aufbewahren – Sie benötigen ihn für die Konfiguration

Tipp: Legen Sie getrennte API-Schlüssel für verschiedene KI-Assistenten an, um den Zugriff unabhängig zu verwalten.

Universelle Konfiguration

Alle MCP-Clients benötigen diese zwei Angaben für die Verbindung mit Corcava:

Endpunkt-URL:

https://app.corcava.com/mcp

Authorization-Header:

Authorization: Bearer YOUR_API_KEY

Ersetzen Sie YOUR_API_KEY durch den API-Schlüssel, den Sie im vorherigen Schritt kopiert haben.

Konfigurationsformat

Die genaue JSON-Struktur unterscheidet sich je nach Client, aber alle Clients benötigen:

Die Corcava-Endpunkt-URL: https://app.corcava.com/mcp
Einen Authorization-Header mit Ihrem API-Schlüssel: Bearer YOUR_API_KEY

Beispiel-Konfigurationsstruktur (Format variiert je nach Client):

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

Hinweis: Continue nutzt ein leicht abweichendes Format mit SSE-Transport. Details siehe Continue-Einrichtungsanleitung.

Client-spezifische Einrichtung

Jeder KI-Assistent hat seinen eigenen Konfigurationsdatei-Speicherort und -format. Folgen Sie der jeweiligen Einrichtungsanleitung für Ihren Client:

Claude Desktop Einrichtung – Schritt-für-Schritt für macOS, Windows und Linux
Cursor Einrichtung – IDE-fokussierte Einrichtung mit Workflow-Beispielen
Windsurf Einrichtung – Anleitung zur Einstellungen-UI-Konfiguration
Continue Einrichtung – SSE-Transport-Konfiguration

Jede Anleitung enthält:

Exakte Konfigurationsdatei-Speicherorte für Ihr Betriebssystem
Vollständige JSON-Konfigurationssnippets mit Platzhaltern
Plattformspezifische Anweisungen
Tipps zur Fehlerbehebung

Prüfliste zur Verifizierung

Nach der Konfiguration Ihres KI-Assistenten diese Checkliste nutzen, um zu prüfen, ob alles funktioniert:

✅ Schritt 1: Konfigurationsdatei

Konfigurationsdatei existiert und liegt am richtigen Ort
JSON-Syntax ist gültig (keine nachgestellten Kommas, korrekte Anführungszeichen)
Endpunkt-URL ist exakt: https://app.corcava.com/mcp
Authorization-Header hat das Format: Bearer YOUR_API_KEY (mit Leerzeichen nach „Bearer“)
API-Schlüssel ist korrekt kopiert (keine zusätzlichen Leerzeichen oder Zeichen)

✅ Schritt 2: Client neu starten

KI-Assistent wurde vollständig neu gestartet (nicht nur neu geladen)
Alle Fenster/Instanzen des Clients wurden geschlossen und wieder geöffnet

✅ Schritt 3: Prüfen, ob Tools verfügbar sind

Testen, ob Ihr KI-Assistent die Corcava-Tools sieht, indem Sie fragen:

Für Claude Desktop, Cursor oder Windsurf:

„Welche MCP-Tools sind von Corcava verfügbar?“

Für Continue:

„Verfügbare MCP-Tools auflisten“

Erwartetes Ergebnis: Ihre KI sollte Corcava-MCP-Tools wie list_tasks, create_task, start_time_tracking usw. auflisten.

✅ Schritt 4: Leseoperation testen

Eine einfache Leseoperation ausführen:

„Liste meine Aufgaben aus Corcava“

Erwartetes Ergebnis: Ihre KI sollte Ihre Aufgaben abrufen und anzeigen (oder mitteilen, dass Sie keine Aufgaben haben).

✅ Schritt 5: Verbindungsstatus testen

Ihre KI fragen:

„Kannst du dich mit Corcava verbinden?“

Erwartetes Ergebnis: Ihre KI sollte bestätigen, dass sie auf Corcava-Tools zugreifen kann.

Häufige Probleme

Wenn Tools nicht erscheinen:

Prüfen, ob der Konfigurationsdatei-Speicherort für Ihr OS korrekt ist
JSON-Syntax prüfen (z. B. mit einem JSON-Validator)
Sicherstellen, dass der Client vollständig neu gestartet wurde
Prüfen, ob der API-Schlüssel unter Einstellungen → Integrationen aktiv ist

Bei „Authorization failed“:

Authorization-Header-Format prüfen: Bearer YOUR_API_KEY (mit Leerzeichen)
Prüfen, ob der API-Schlüssel korrekt und aktiv ist
Sicherstellen, dass keine zusätzlichen Leerzeichen oder Zeichen im Schlüssel sind

Bei Verbindungsfehler:

Internetverbindung prüfen
Prüfen, ob https://app.corcava.com im Browser erreichbar ist
Versuchen, den API-Schlüssel neu zu erzeugen

Weitere Hilfe zur Fehlerbehebung siehe MCP-Fehlerbehebungsanleitungen.

Was Ihre KI kann

Informationen lesen

Ihr KI-Assistent kann abrufen:

Aufgabendetails – Vollständige Beschreibung, Kommentare, Daten, Zugewiesene
Board-Übersicht – Spalten, Aufgabenzahlen, Projektkontext
Projektinformationen – Kunde, Status, zugehörige Boards

Aktionen ausführen

Ihr KI-Assistent kann:

Aufgaben anlegen – Neue Aufgaben mit Beschreibung, Daten und Zuweisungen hinzufügen
Aufgaben aktualisieren – Status ändern, zwischen Spalten verschieben, Details aktualisieren
Kommentare hinzufügen – Erledigte Arbeit dokumentieren oder Notizen hinterlassen
Zeit erfassen – Zeiterfassung für Aufgaben starten und stoppen
Auflisten und suchen – Aufgaben, Projekte und Boards finden

Beispiel-Unterhaltungen

Allgemeine Produktivität (Claude Desktop)

Sie: „Welche Aufgaben sind diese Woche fällig?“ KI: Listet Ihre anstehenden Aufgaben mit Fälligkeitsdaten und Projekten

Sie: „Lege eine Aufgabe an: Bei Acme Corp wegen des Angebots nachfassen“ KI: Legt eine neue Aufgabe an und bestätigt die Details

Sie: „Starte die Zeiterfassung für meine aktuelle Aufgabe“ KI: Startet den Zeit-Tracker für Ihre aktive Aufgabe

Entwicklungs-Workflow (Cursor)

Sie: Corcava-Aufgabenlink teilen „Hilf mir, dieses Feature umzusetzen“ KI: Liest die Anforderungen der Aufgabe und unterstützt Sie beim Code

Sie: „Füge zu Aufgabe #123 einen Kommentar hinzu, dass ich die API-Änderungen erledigt habe“ KI: Fügt den Kommentar mit Ihrer Dokumentation hinzu

Sie: „Was sind die Abnahmekriterien für diese Aufgabe?“ KI: Ruft die Aufgabenbeschreibung und Kommentare ab und zeigt sie an

Verfügbare Tools

Tool	Beschreibung
`list_tasks`	Aufgaben nach Projekt, Board oder Stichwort suchen und filtern
`get_task`	Vollständige Details einer bestimmten Aufgabe abrufen
`create_task`	Neue Aufgabe mit Titel, Beschreibung, Daten anlegen
`update_task`	Aufgabendetails aktualisieren oder in andere Spalte verschieben
`delete_task`	Aufgabe dauerhaft entfernen
`list_projects`	Alle zugänglichen Projekte auflisten
`get_project`	Projektdetails und zugehörige Boards abrufen
`list_boards`	Boards auflisten, optional nach Projekt gefiltert
`get_board`	Board-Details inkl. Spalten abrufen
`list_task_comments`	Alle Kommentare zu einer Aufgabe abrufen
`add_task_comment`	Kommentar zu einer Aufgabe hinzufügen
`start_time_tracking`	Zeiterfassung für eine Aufgabe starten
`stop_time_tracking`	Aktuelle Zeiterfassungssitzung beenden
`get_tracking_status`	Prüfen, ob Zeiterfassung aktiv ist

Sicherheitshinweise

Ihr API-Schlüssel gewährt vollen Zugriff auf Ihre Corcava-Daten – bewahren Sie ihn sicher auf
API-Schlüssel niemals teilen oder in die Versionskontrolle committen
API-Schlüssel können jederzeit unter Einstellungen → Integrationen deaktiviert oder gelöscht werden
Jede API-Anfrage ist nur auf die Daten Ihres Teams begrenzt

Fehlerbehebung

„Authorization failed“ oder „Invalid API key“

Sicherstellen, dass der vollständige API-Schlüssel kopiert wurde
Prüfen, ob der Schlüssel unter Einstellungen → Integrationen → Öffentliche API aktiv ist
Sicherstellen, dass das Präfix Bearer gefolgt von einem Leerzeichen vor dem Schlüssel steht

KI sieht Corcava-Tools nicht

KI-Assistent nach dem Hinzufügen der Konfiguration neu starten
Prüfen, ob die MCP-Server-URL korrekt ist: https://app.corcava.com/mcp
Prüfen, ob die JSON-Konfiguration gültig ist (keine Syntaxfehler)

Fehler „Connection refused“

Internetverbindung prüfen
Prüfen, ob Corcava im Browser erreichbar ist
Versuchen, den API-Schlüssel neu zu erzeugen

Support

Hilfe benötigt? Wenden Sie sich an unser Support-Team oder nutzen Sie die Dokumentation der öffentlichen API für weitere Details zur zugrunde liegenden API.