Corcava MCP Tools: Vollständige Referenz

Vollständiges Verzeichnis aller Corcava-MCP-Tools. Jedes Tool ist eine Funktion, die Ihr KI-Assistent aufrufen kann, um mit Ihrem Corcava-Arbeitsbereich zu interagieren. Nach Kategorie durchsuchen oder die Schnellreferenz-Tabelle nutzen.

Tools nach Kategorie

Aufgabenverwaltung

• list_tasks – Aufgaben nach Projekt, Board, Status, Fälligkeitsdatum oder Stichwort suchen und filtern
• get_task – Vollständige Details einer bestimmten Aufgabe inkl. Beschreibung, Kommentare und Metadaten
• create_task – Neue Aufgabe mit Titel, Beschreibung, Daten und Zuweisungen anlegen
• update_task – Aufgabendetails aktualisieren, Status ändern, zwischen Spalten verschieben oder Felder anpassen
• delete_task – Aufgabe dauerhaft entfernen (unwiderrufliche Aktion)

Projektverwaltung

• list_projects – Alle zugänglichen Projekte mit Basis-Metadaten auflisten
• get_project – Projektdetails inkl. Mitglieder, Einstellungen und zugehörige Boards

Board-Workflows

• list_boards – Workflow-Boards auflisten, optional nach Projekt gefiltert
• get_board – Board-Details inkl. Spalten, Zustände und Aufgabenzahlen

Aufgabenkommentare

• list_task_comments – Alle Kommentare zu einer Aufgabe inkl. Zeitstempel und Autoren
• add_task_comment – Einen Kommentar zu einer Aufgabe für Updates, Entscheidungen oder Notizen hinzufügen

Zeiterfassung

• start_time_tracking – Zeiterfassung für eine bestimmte Aufgabe starten
• stop_time_tracking – Aktuelle Zeiterfassungssitzung beenden und Zeit der Aufgabe zuordnen
• get_tracking_status – Prüfen, ob Zeiterfassung aktiv ist und für welche Aufgabe

Schnellreferenz-Tabelle

Häufige Tools mit Beispielen

list_tasks – Am häufigsten genutzt

Aufgaben suchen und filtern:

"Welche Aufgaben sind diese Woche fällig?"

Vollständige Referenz →

create_task – Neue Arbeit anlegen

Aufgaben aus Unterhaltungen erstellen:

"Lege eine Aufgabe an: Nächste Woche bei Acme Corp nachfassen"

Vollständige Referenz →

start_time_tracking – Arbeit erfassen

Timer automatisch starten:

"Starte die Zeiterfassung für die Login-Feature-Aufgabe"

Vollständige Referenz →

Namenskonventionen für Tools

Corcava-MCP-Tools folgen einheitlichen Namensmustern:

Namensmuster: verb_noun

• Leseoperationen: list_*, get_* (z. B. list_tasks, get_task)
• Schreiboperationen: create_*, update_*, add_* (z. B. create_task, update_task)
• Destruktive Operationen: delete_* (z. B. delete_task)
• Aktionen: start_*, stop_* (z. B. start_time_tracking)

Format: snake_case

Alle Toolnamen verwenden Kleinbuchstaben mit Unterstrichen:

• ✅ list_tasks (korrekt)
• ✅ get_task (korrekt)
• ✅ start_time_tracking (korrekt)
• ❌ listTasks (falsch – camelCase)
• ❌ get-task (falsch – kebab-case)

Typische Fehlerantworten

Bei fehlgeschlagenen Tool-Aufrufen erhalten Sie strukturierte Fehlerantworten:

401 Unauthorized

Authentifizierung fehlgeschlagen:

{
  "error": "unauthorized",
  "message": "Invalid or expired API key"
}

400 Bad Request

Ungültige Parameter:

{
  "error": "validation_error",
  "message": "Missing required parameter: task_id",
  "field": "task_id"
}

404 Not Found

Ressource existiert nicht:

{
  "error": "not_found",
  "message": "Task with ID 123 not found"
}

429 Rate Limited

Zu viele Anfragen:

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Retry after 60 seconds",
  "retry_after": 60
}

Einzelne Tool-Referenzen durchsuchen

Jedes Tool hat eine detaillierte Referenzseite mit:

• Zweck und Anwendungsfällen
• Eingabeparametern und -typen
• Ausgabeformat
• Beispiel-Tool-Aufrufen (JSON)
• Beispielen für natürliche Sprache
• Grenzfällen und Fehlerbehebung

Alle Tool-Referenzen finden Sie in den Kategorien oben oder in der Schnellreferenz-Tabelle.

Erste Schritte

Um diese Tools zu nutzen, müssen Sie:

1. MCP-Integration einrichten – Siehe die Anleitung KI-Assistent-Integration (MCP)
2. API-Schlüssel erstellen – Unter Einstellungen → Integrationen → Öffentliche API anlegen
3. KI-Assistent konfigurieren – Corcava als MCP-Server in Claude Desktop, Cursor, Windsurf oder Continue hinzufügen
4. Tools nutzen – Ihren KI-Assistenten bitten, Aufgaben aufzulisten, Aufgaben anzulegen oder Zeit zu erfassen

Weitere Informationen auf der MCP-Integrationsseite.