Aufgabe per MCP löschen: Unwiderrufliche Aktionen und Bestätigungsaufforderungen

Entwicklerreferenz für das MCP-Tool delete_task. Informationen zu dieser unwiderruflichen Operation, wann sie sinnvoll ist und wie Sie starke Bestätigungsmuster einsetzen, um versehentliches Löschen zu vermeiden. Inkl. Beispiel-Tool-Aufrufe, natürliche Sprache, Grenzfälle und Fehlerbehebung.

Tool-Überblick

Zweck

Das Tool delete_task entfernt eine Aufgabe dauerhaft aus Ihrem Corcava-Arbeitsbereich. Diese Aktion kann nicht rückgängig gemacht werden.

⚠️⚠️ Destruktive Operation: Dieses Tool löscht Daten dauerhaft. Immer starke Bestätigungsmuster verwenden und die Aufgabe vor dem Löschen in der Vorschau anzeigen.

⚠️ Warnung

Das Löschen einer Aufgabe ist dauerhaft. Gelöschte Aufgaben können nicht wiederhergestellt werden. Immer prüfen, dass die richtige Aufgabe gelöscht wird, und ausdrückliche Bestätigung verlangen (z. B. „DELETE CONFIRM“ mit beiden Wörtern).

Eingabeparameter

Das Tool benötigt nur die Aufgaben-ID zum Löschen.

Ausgabeformat

Bei erfolgreicher Löschung liefert das Tool eine Bestätigung:

{
  "success": true,
  "message": "Task deleted successfully",
  "deleted_task_id": 123
}

Sicherheitsmuster: Starke Bestätigung erforderlich

⚠️ Immer starke Bestätigung verwenden

Das Löschen ist unwiderruflich. Diese verbindlichen Muster nutzen:

• Zuerst Vorschau: Immer get_task aufrufen, um die Aufgabendetails anzuzeigen
• Ausdrückliche Warnung: Nutzer darauf hinweisen, dass das Löschen dauerhaft ist
• Starkes Token: „DELETE CONFIRM“ (beide Wörter) verlangen, nicht nur „CONFIRM“
• Aufgabenprüfung: Aufgabentitel und -ID vor dem Löschen anzeigen

Mehr zu sicheren Schreib-Workflows →

Sicheres Aufforderungsmuster

✅ Sicheres Aufforderungs-Template:

"Ich möchte die [Aufgabenname]-Aufgabe löschen.

Regeln:
1. Zuerst get_task aufrufen und mir die Aufgabendetails zeigen
2. Mich warnen, dass das Löschen dauerhaft ist und nicht rückgängig gemacht werden kann
3. Warten, bis ich DELETE CONFIRM (beide Wörter) tippe, bevor delete_task aufgerufen wird
4. Wenn ich nicht DELETE CONFIRM tippe, nichts löschen"

Beispiel-Tool-Aufrufe

Beispiel: Aufgabe löschen

Tool-Aufruf (JSON):

{
  "tool": "delete_task",
  "arguments": {
    "task_id": 123
  }
}

Rückgabe: Bestätigung, dass die Aufgabe gelöscht wurde

⚠️ Warnung: Dadurch wird die Aufgabe dauerhaft gelöscht. Immer zuerst bestätigen!

Beispiele für natürliche Sprache

Sicheres Löschen mit starker Bestätigung

Nutzeraufforderung:

"Lösche die doppelte Aufgabe 'Test login'. Zeig mir zuerst die Aufgabe, warne mich, dass es dauerhaft ist, dann warte auf DELETE CONFIRM."

KI-Verhalten:

1. KI ruft get_task auf, um die Aufgabendetails anzuzeigen
2. KI zeigt: „Aufgabe #123: Test login (Duplikat)“
3. KI warnt: „⚠️ Dadurch wird diese Aufgabe dauerhaft gelöscht. Das kann nicht rückgängig gemacht werden.“
4. KI bittet: „Tippen Sie DELETE CONFIRM (beide Wörter), um diese Aufgabe zu löschen“
5. Nutzer tippt „DELETE CONFIRM“
6. KI ruft delete_task erst nach exakter Bestätigung auf
7. KI bestätigt, dass die Aufgabe gelöscht wurde

Was nicht zu tun ist

❌ Unsichere Aufforderung:

"Lösche Aufgabe 123"

Warum unsicher:

• Keine Vorschau dessen, was gelöscht wird
• Keine Warnung zur Unwiderruflichkeit
• Schwache oder keine Bestätigung
• Hohes Risiko versehentlichen Löschens

Wann Löschen sinnvoll ist

Das Löschen von Aufgaben sollte selten sein. Zuerst diese Alternativen prüfen:

✅ Alternativen zum Löschen:

• Als erledigt markieren: Mit update_task status="done" setzen
• Archivieren: In ein „Archiv“-Board oder -Projekt verschieben
• Schließen: Status aktualisieren und Abschlusskommentar hinzufügen
• Abbrechen: Status auf „blocked“ setzen mit Begründung

⚠️ Wann Löschen angebracht ist:

• Echte Duplikate: Entfernen exakt doppelter Aufgaben
• Testaufgaben: Bereinigung von Test- oder Experimentieraufgaben
• Fehler: Versehentlich angelegte Aufgaben
• Datenbereinigung: Veraltete oder ungültige Aufgaben entfernen

Typische Anwendungsfälle

• Backlog-Pflege – Veraltete oder überflüssige Aufgaben aus dem Backlog entfernen
• Duplikaterkennung – Doppelte Aufgaben nach dem Zusammenführen entfernen
• Aufgabenverwaltung – Aufgaben im Rahmen des Aufgabenverwaltungs-Workflows bereinigen

Grenzfälle

Aufgabe nicht gefunden (404)

Situation: task_id existiert nicht oder wurde bereits gelöscht

Antwort:

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

Umgang: Prüfen, ob die Aufgaben-ID korrekt ist oder die Aufgabe bereits gelöscht wurde

Berechtigung verweigert (403)

Situation: Die Aufgabe existiert, aber Sie haben keine Berechtigung zum Löschen

Antwort:

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

Umgang: Aufgabenberechtigungen in Corcava prüfen

403-Fehlerbehebungsanleitung →

Aufgabe hat Abhängigkeiten

Situation: Die Aufgabe kann mit anderen Aufgaben verknüpft sein oder Zeiterfassung haben

Antwort: Die Aufgabe wird gelöscht, verknüpfte Daten können betroffen sein (Details in der Corcava-Dokumentation)

Umgang: Bei Bedarf vor dem Löschen die Aufgabenbeziehungen prüfen

Fehlerbehebung

Aufgabe nicht gefunden (404)

Symptom: 404 Not Found beim Löschversuch

Ursachen:

• Aufgaben-ID existiert nicht
• Aufgabe wurde bereits 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

Berechtigung verweigert (403)

Symptom: 403 Forbidden

Ursachen:

• Aufgabe gehört einem anderen Arbeitsbereich
• Sie haben keine Löschberechtigung
• Aufgabe ist geschützt oder gesperrt

Lösung:

• Prüfen, ob Sie im richtigen Arbeitsbereich sind
• Aufgabenberechtigungen in Corcava prüfen
• Bei Bedarf den Arbeitsbereich-Admin kontaktieren

403-Fehlerbehebungsanleitung →

Best Practices

delete_task sicher nutzen

• ✅ Vor dem Löschen immer get_task aufrufen, um die Vorschau der zu löschenden Aufgabe anzuzeigen
• ✅ Nutzer vor dem Löschen Aufgabentitel und -ID anzeigen
• ✅ Nutzer warnen, dass das Löschen dauerhaft und nicht rückgängig machbar ist
• ✅ Starkes Bestätigungstoken verlangen: „DELETE CONFIRM“ (beide Wörter)
• ✅ Vor dem Löschen Alternativen prüfen (als erledigt markieren, archivieren)
• ✅ Nur echte Duplikate, Testaufgaben oder Fehler löschen
• ✅ Vor dem Löschen prüfen, ob task_id korrekt ist
• ✅ Niemals stapelweise löschen, ohne die vollständige Liste zu zeigen und „DELETE CONFIRM ALL“ zu verlangen

Verwandte Tools

Oft zusammen verwendet mit:

• get_task – Aufgabendetails vor dem Löschen in der Vorschau anzeigen (erforderlich)
• list_tasks – Zu löschende Aufgaben finden (z. B. Duplikate)
• update_task – Statt Löschen ggf. Status aktualisieren
• Least-Privilege Workflows – Sichere Schreib-Workflow-Muster