Aufgabenkommentare per MCP auflisten: Zeitachsen und Prüfprotokolle

Entwicklerreferenz für das MCP-Tool list_task_comments. So rufen Sie Kommentarverlauf und Prüfprotokolle für Aufgaben ab, inkl. Paginierung und Filterung. Inkl. Beispiel-Tool-Aufrufe, natürliche Sprache, Grenzfälle und Fehlerbehebung.

Tool-Überblick

Zweck

Das Tool list_task_comments ruft die vollständige Kommentarhistorie für eine bestimmte Aufgabe ab. Nutzen Sie es, um Aufgaben-Zeitachsen zu prüfen, Entscheidungshistorie zu verstehen, Prüfprotokolle zu lesen oder Übergabe-Zusammenfassungen vorzubereiten.

Nur-Lesen-Operation: Dieses Tool liest nur Daten – es ändert keine Kommentare.

Eingabeparameter

Das Tool benötigt eine Aufgaben-ID. Paginierungsparameter sind optional.

Ausgabeformat

Das Tool liefert ein JSON-Objekt mit Kommentaren und Paginierungsinformationen:

{
  "comments": [
    {
      "id": 1,
      "content": "Started working on OAuth integration",
      "author_id": 101,
      "author_name": "John Doe",
      "author_email": "[email protected]",
      "created_at": "2026-02-20T14:22:00Z",
      "updated_at": "2026-02-20T14:22:00Z"
    }
  ],
  "total": 5,
  "limit": 25,
  "offset": 0,
  "has_more": false
}

Antwortfelder

• comments: Array von Kommentarobjekten (leeres Array bei keinen Kommentaren)
• total: Gesamtzahl der Kommentare für diese Aufgabe (über alle Seiten)
• limit: Maximale Anzahl der in dieser Antwort zurückgegebenen Kommentare
• offset: Anzahl der übersprungenen Kommentare (für Paginierung)
• has_more: Boolean, ob weitere Kommentare verfügbar sind

Kommentar-Objektfelder

• id: Eindeutige Kommentar-Kennung
• content: Kommentartext
• author_id: ID des Benutzers, der den Kommentar erstellt hat
• author_name: Name des Kommentarautors
• author_email: E-Mail des Kommentarautors
• created_at: Zeitstempel der Erstellung
• updated_at: Zeitstempel der letzten Aktualisierung

Beispiel-Tool-Aufrufe

Beispiel 1: Alle Kommentare auflisten

Tool-Aufruf (JSON):

{
  "tool": "list_task_comments",
  "arguments": {
    "task_id": 123,
    "limit": 50
  }
}

Rückgabe: Die ersten 50 Kommentare für Aufgabe 123

Beispiel 2: Paginierung

Tool-Aufruf (JSON):

{
  "tool": "list_task_comments",
  "arguments": {
    "task_id": 123,
    "limit": 25,
    "offset": 25
  }
}

Rückgabe: Kommentare 26–50 (zweite Seite)

Beispiele für natürliche Sprache

Claude Desktop / Allgemeine KI

Nutzeraufforderung:

"Zeig mir alle Kommentare zu Aufgabe #123"

KI-Verhalten:

1. KI ruft list_task_comments mit task_id: 123 auf
2. KI erhält das Kommentar-Array
3. KI formatiert und präsentiert die Kommentare chronologisch dem Nutzer

Aufgabenhistorie prüfen

Nutzeraufforderung:

"Welche Entscheidungen wurden bei der Login-Feature-Aufgabe getroffen?"

KI-Verhalten:

1. KI findet die Aufgabe mit list_tasks und Suche: "login feature"
2. KI ruft list_task_comments mit der Aufgaben-ID auf
3. KI analysiert Kommentare auf Entscheidungsbegriffe
4. KI präsentiert die Entscheidungs-Zeitachse dem Nutzer

Übergabe vorbereiten

Nutzeraufforderung:

"Fasse die Kommentarhistorie für Aufgabe #456 für eine Übergabe zusammen"

KI-Verhalten:

1. KI ruft list_task_comments auf, um alle Kommentare zu erhalten
2. KI erhält die Kommentar-Zeitachse
3. KI fasst Kernpunkte, Entscheidungen und nächste Schritte aus den Kommentaren zusammen
4. KI präsentiert die Übergabe-Zusammenfassung dem Nutzer

Typische Anwendungsfälle

• Aufgaben-Übergabe – Kommentarhistorie prüfen, um Übergabe-Zusammenfassungen vorzubereiten
• Fortschritts-Updates – Vorherige Kommentare prüfen, bevor neue Updates hinzugefügt werden
• Aufgabenverwaltung – Aufgabenkontext und Entscheidungshistorie verstehen
• Kommentare hinzufügen – Bestehende Kommentare prüfen, bevor neue hinzugefügt werden

Grenzfälle

Keine Kommentare

Situation: Aufgabe hat keine Kommentare

Antwort:

{
  "comments": [],
  "total": 0,
  "limit": 50,
  "offset": 0,
  "has_more": false
}

Umgang: Das ist normal – leeres Array bedeutet, dass die Aufgabe noch keine Kommentare hat

Aufgabe nicht gefunden (404)

Situation: task_id existiert nicht

Antwort:

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

Umgang: Prüfen, ob die Aufgaben-ID korrekt ist

Berechtigung verweigert (403)

Situation: Aufgabe existiert, aber Sie haben keinen Zugriff auf ihre Kommentare

Antwort:

{
  "error": "forbidden",
  "message": "You don't have permission to access this task's comments"
}

Umgang: Prüfen, ob Sie im richtigen Arbeitsbereich sind oder die Aufgabe privat ist

403-Fehlerbehebungsanleitung →

Fehlerbehebung

Ungültige Aufgaben-ID

Symptom: 400-Validierungsfehler oder 404 Not Found

Ursachen:

• Aufgaben-ID ist keine Zahl
• Aufgaben-ID existiert nicht
• Aufgabe wurde gelöscht

Lösung:

• Prüfen, ob die Aufgaben-ID eine gültige Ganzzahl ist
• Mit list_tasks oder get_task gültige IDs finden
• Prüfen, ob die Aufgabe in Corcava noch existiert

Zugriff verweigert (403)

Symptom: 403 Forbidden

Ursachen:

• Aufgabe gehört einem anderen Arbeitsbereich
• Aufgabe ist privat und Sie sind nicht zugewiesen
• API-Schlüssel hat keinen Zugriff auf den Arbeitsbereich

Lösung:

• Prüfen, ob Sie den richtigen Arbeitsbereich nutzen
• Aufgabenberechtigungen in Corcava prüfen
• Prüfen, ob der API-Schlüssel Zugriff auf den Arbeitsbereich hat

403-Fehlerbehebungsanleitung →

Best Practices

list_task_comments effektiv nutzen

• ✅ Bei vielen Kommentaren Paginierung (limit/offset) nutzen
• ✅ Kommentare prüfen, bevor neue hinzugefügt werden, um Duplikate zu vermeiden
• ✅ Kommentare nutzen, um Aufgabenkontext und Entscheidungshistorie zu verstehen
• ✅ Mit get_task für vollständigen Aufgabenkontext kombinieren
• ✅ Kommentare chronologisch sortieren (sie werden in Erstellungsreihenfolge zurückgegeben)

Verwandte Tools

Oft zusammen verwendet mit:

• get_task – Aufgabendetails abrufen (inkl. letzter Kommentare)
• add_task_comment – Neue Kommentare zu Aufgaben hinzufügen
• list_tasks – Aufgaben-IDs finden, bevor Kommentare aufgelistet werden