Aufgabenkommentar per MCP hinzufügen: Updates, Entscheidungen und nächste Schritte

Entwicklerreferenz für das MCP-Tool add_task_comment. So fügen Sie Kommentare zu Aufgaben für Fortschritts-Updates, Entscheidungen und nächste Schritte hinzu. Inkl. Sicherheitsprüfungen, Bestätigungsmustern, Beispiel-Tool-Aufrufen, natürlicher Sprache, Grenzfällen und Fehlerbehebung.

Tool-Überblick

Zweck

Das Tool add_task_comment fügt einen neuen Kommentar zu einer Aufgabe hinzu. Nutzen Sie es, um Fortschritts-Updates zu protokollieren, Entscheidungen zu dokumentieren, nächste Schritte festzuhalten oder Kontext für spätere Referenz zu liefern.

⚠️ Schreib-Operation: Dieses Tool ändert Daten – immer Bestätigungsmuster verwenden, bevor es aufgerufen wird.

Eingabeparameter

Sowohl task_id als auch content sind erforderlich.

Ausgabeformat

Das Tool liefert das neu erstellte Kommentarobjekt:

{
  "id": 5,
  "content": "Completed OAuth integration",
  "author_id": 101,
  "author_name": "John Doe",
  "author_email": "[email protected]",
  "created_at": "2026-03-18T10:30:00Z",
  "updated_at": "2026-03-18T10:30:00Z",
  "task_id": 123
}

Sicherheitsprüfungen und Bestätigungsmuster

⚠️ Immer bestätigen, bevor Kommentare hinzugefügt werden

KI niemals ohne ausdrückliche Bestätigung Kommentare hinzufügen lassen. Diese Muster nutzen:

• Zuerst Vorschau: Zeigen, welcher Kommentar hinzugefügt wird, bevor ausgeführt wird
• Bestätigungstoken: "CONFIRM" verlangen, bevor add_task_comment aufgerufen wird
• Inhalt prüfen: Kommentartext zur Prüfung anzeigen, bevor gepostet wird
• Aufgabe prüfen: Aufgaben-ID und -titel bestätigen, bevor Kommentar hinzugefügt wird

Mehr zu sicheren Schreib-Workflows →

Sicheres Aufforderungsmuster

✅ Sicheres Aufforderungs-Template:

"Ich möchte einen Kommentar zu Aufgabe #123 hinzufügen: [Kommentartext]. 
Zeig mir genau, was du posten wirst (Aufgabentitel und Kommentartext), 
und warte auf mein Tippen von CONFIRM, bevor du etwas hinzufügst. 
Wenn ich nicht CONFIRM tippe, füge nichts hinzu."

Beispiel-Tool-Aufrufe

Beispiel 1: Fortschritts-Update hinzufügen

Tool-Aufruf (JSON):

{
  "tool": "add_task_comment",
  "arguments": {
    "task_id": 123,
    "content": "Completed OAuth integration. Ready for review."
  }
}

Rückgabe: Erstelltes Kommentarobjekt mit allen Feldern

Beispiel 2: Entscheidungsprotokoll hinzufügen

Tool-Aufruf (JSON):

{
  "tool": "add_task_comment",
  "arguments": {
    "task_id": 456,
    "content": "Decision: Using OAuth 2.0 instead of OAuth 1.0 for better security and modern standards."
  }
}

Rückgabe: Erstelltes Kommentarobjekt mit der dokumentierten Entscheidung

Beispiele für natürliche Sprache

Sichere Kommentar-Hinzufügung mit Bestätigung

Nutzeraufforderung:

"Füge einen Kommentar zu Aufgabe #123 hinzu: 'OAuth-Integration ist abgeschlossen'. Zeig mir zuerst, was du posten wirst, dann warte auf CONFIRM."

KI-Verhalten:

1. KI ruft get_task auf, um zu prüfen, ob die Aufgabe existiert und den Titel zu erhalten
2. KI zeigt Vorschau: "Aufgabe: Login Feature, Kommentar: OAuth-Integration ist abgeschlossen"
3. KI wartet auf "CONFIRM"
4. KI ruft add_task_comment erst nach Bestätigung auf
5. KI bestätigt, dass der Kommentar hinzugefügt wurde

Fortschritts-Update-Workflow

Nutzeraufforderung:

"Ich bin mit dem Login-Feature fertig. Füge einen Fortschritts-Kommentar zu Aufgabe #123 hinzu, zeig mir aber zuerst den Kommentar."

KI-Verhalten:

1. KI formuliert Kommentar: "Fortschritts-Update: Login-Feature-Implementierung abgeschlossen"
2. KI zeigt Vorschau und bittet um Bestätigung
3. Nutzer bestätigt
4. KI ruft add_task_comment auf

Typische Anwendungsfälle

• Fortschritts-Updates – Regelmäßige Fortschritts-Updates zu Aufgaben protokollieren
• Aufgaben-Übergabe – Übergabe-Kommentare mit Kontext und nächsten Schritten hinzufügen
• Standup-Zusammenfassung – Standup-Zusammenfassungen als Aufgabenkommentare posten
• Kommentare prüfen – Bestehende Kommentare prüfen, bevor neue hinzugefügt werden

Grenzfälle

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

Leerer Inhalt

Situation: content ist leer oder nur Leerzeichen

Antwort:

{
  "error": "validation_error",
  "message": "Content cannot be empty",
  "field": "content"
}

Umgang: Sicherstellen, dass content nicht-leeren Text enthält

Berechtigung verweigert (403)

Situation: Aufgabe existiert, aber Sie haben keine Berechtigung zum Kommentieren

Antwort:

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

Umgang: Aufgabenberechtigungen in Corcava prüfen

403-Fehlerbehebungsanleitung →

Fehlerbehebung

Validierungsfehler (400)

Symptom: 400 Bad Request mit Validierungsfehler

Ursachen:

• Fehlendes Pflichtfeld (task_id oder content)
• Leerer Inhalt (nur Leerzeichen)
• Ungültiges task_id-Format

Lösung:

• Sicherstellen, dass task_id und content angegeben sind
• Prüfen, dass content echten Text enthält (nicht nur Leerzeichen)
• Prüfen, dass task_id eine gültige Ganzzahl ist

Validierungs-Fehlerbehebung →

Aufgabe nicht gefunden (404)

Symptom: 404 Not Found

Ursachen:

• Aufgaben-ID existiert nicht
• Aufgabe wurde gelöscht
• Ungültiges task_id-Format

Lösung:

• Prüfen, ob task_id korrekt ist
• Mit list_tasks oder get_task gültige IDs finden
• Prüfen, ob die Aufgabe noch existiert

Best Practices

add_task_comment sicher nutzen

• ✅ Kommentarinhalt immer vor dem Posten in der Vorschau anzeigen
• ✅ Ausdrückliche Bestätigung verlangen (CONFIRM-Token)
• ✅ Aufgaben-ID und -titel prüfen, bevor Kommentar hinzugefügt wird
• ✅ Bestehende Kommentare prüfen, um Duplikate zu vermeiden
• ✅ Klaren, umsetzbaren Kommentartext verwenden
• ✅ Bei Bedarf Kontext und nächste Schritte einbeziehen

Verwandte Tools

Oft zusammen verwendet mit:

• list_task_comments – Bestehende Kommentare prüfen, bevor neue hinzugefügt werden
• get_task – Prüfen, ob Aufgabe existiert, bevor kommentiert wird
• Least-Privilege Workflows – Sichere Schreib-Workflow-Muster