Aufgabe per MCP anlegen: Pflichtfelder, Standardwerte und Sicherheitsprüfungen

Entwicklerreferenz für das MCP-Tool create_task. So legen Sie neue Aufgaben mit Pflicht- und optionalen Feldern an, verstehen Standardwerte, setzen Sicherheitsprüfungen und Bestätigungsmuster ein. Inkl. Beispiel-Tool-Aufrufe, natürliche Sprache, Grenzfälle und Fehlerbehebung.

Tool-Überblick

Zweck

Das Tool create_task legt eine neue Aufgabe in Ihrem Corcava-Arbeitsbereich an. Nutzen Sie es, um neue Arbeit zu erfassen, Nachfass-Aufgaben anzulegen oder Ideen in umsetzbare Aufgaben zu überführen.

⚠️ Schreiboperation: Dieses Tool ändert Daten – vor dem Aufruf immer Bestätigungsmuster verwenden.

Eingabeparameter

Einige Felder sind erforderlich, andere optional mit sinnvollen Standardwerten.

Ausgabeformat

Das Tool liefert das neu angelegte Aufgabenobjekt mit allen gesetzten Feldern:

{
  "id": 789,
  "title": "Follow up with Acme Corp",
  "description": "Schedule a call to discuss the proposal",
  "status": "open",
  "priority": "high",
  "due_date": "2026-03-10",
  "project_id": 456,
  "board_id": 123,
  "assignee_id": 101,
  "created_at": "2026-03-03T10:30:00Z",
  "updated_at": "2026-03-03T10:30:00Z",
  "created_by_id": 99
}

Sicherheitsprüfungen und Bestätigungsmuster

⚠️ Immer bestätigen vor dem Anlegen

KI darf keine Aufgaben ohne ausdrückliche Bestätigung anlegen. Diese Muster verwenden:

• Zuerst Vorschau: Zeigen, welche Aufgabe angelegt wird, bevor ausgeführt wird
• Bestätigungstoken: „CONFIRM“ verlangen, bevor create_task aufgerufen wird
• Felder prüfen: Alle Felder (Titel, Beschreibung, Fälligkeitsdatum, Projekt) zur Prüfung anzeigen

Mehr zu sicheren Schreib-Workflows →

Sicheres Aufforderungsmuster

✅ Sicheres Aufforderungs-Template:

"Ich möchte eine Aufgabe anlegen: [Beschreibung].
Zeig mir genau, was du anlegen wirst (Titel, Beschreibung, Projekt, Fälligkeitsdatum),
und warte auf mein Tippen von CONFIRM, bevor du anlegst.
Wenn ich nicht CONFIRM tippe, lege nichts an."

Beispiel-Tool-Aufrufe

Beispiel 1: Minimale Aufgabe (nur Titel)

Tool-Aufruf (JSON):

{
  "tool": "create_task",
  "arguments": {
    "title": "Follow up with Acme Corp"
  }
}

Rückgabe: Aufgabe mit Standardprojekt, -board, status="open", priority="medium"

Beispiel 2: Vollständige Aufgabe

Tool-Aufruf (JSON):

{
  "tool": "create_task",
  "arguments": {
    "title": "Implement login feature",
    "description": "Add user authentication with email/password and OAuth support",
    "project_id": 456,
    "board_id": 789,
    "due_date": "2026-03-15",
    "assignee_id": 101,
    "status": "open",
    "priority": "high",
    "tags": ["authentication", "backend"]
  }
}

Rückgabe: Vollständig spezifizierte Aufgabe mit allen gesetzten Feldern

Beispiel 3: Aufgabe mit Fälligkeitsdatum

Tool-Aufruf (JSON):

{
  "tool": "create_task",
  "arguments": {
    "title": "Review API design doc",
    "description": "Review and provide feedback on the new API design",
    "due_date": "2026-03-05",
    "priority": "high"
  }
}

Rückgabe: Aufgabe mit Fälligkeitsdatum und Priorität, andere Felder nutzen Standardwerte

Beispiele für natürliche Sprache

Sicheres Anlegen mit Bestätigung

Nutzeraufforderung:

"Lege eine Aufgabe an: Nächste Woche bei Acme Corp nachfassen. Zeig mir vor dem Anlegen, was du anlegen wirst."

KI-Verhalten:

1. KI schlägt Aufgabe vor: „Titel: Follow up with Acme Corp, Fällig: [nächste Woche], Projekt: [vorgeschlagen]“
2. KI zeigt Vorschau und bittet um Bestätigung
3. Nutzer tippt „CONFIRM“
4. KI ruft create_task mit den vorgeschlagenen Feldern auf
5. KI bestätigt, dass die Aufgabe angelegt wurde

Aus Meeting-Notizen

Nutzeraufforderung:

"Ich habe diese Aktionspunkte aus einem Meeting: [Liste]. Lege für jeden Aufgaben an, zeig mir aber zuerst alle Aufgaben. Lege erst an, wenn ich zustimme."

KI-Verhalten:

1. KI analysiert die Aktionspunkte
2. KI schlägt eine Liste von Aufgaben mit Details vor
3. KI zeigt Vorschau: „Ich werde diese 5 Aufgaben anlegen: [Liste]“
4. Nutzer prüft und genehmigt
5. KI ruft create_task für jede genehmigte Aufgabe auf

Typische Anwendungsfälle

• Meeting-Notizen zu Aufgaben – Aktionspunkte extrahieren und Nachfass-Aufgaben anlegen
• Spec zu Aufgaben – Feature-Specs in strukturierte Aufgabenbäume überführen
• Projekt-Kickoff – Startaufgaben für neue Projekte anlegen
• Sprint-Planung – Sprint-Ziele in abgegrenzte Aufgaben überführen

Grenzfälle

Fehlendes Pflichtfeld

Situation: title fehlt oder ist leer

Antwort:

{
  "error": "validation_error",
  "message": "Title is required",
  "field": "title"
}

Umgang: Beim Anlegen von Aufgaben immer einen Titel angeben

Ungültige Projekt-ID

Situation: project_id existiert nicht

Antwort:

{
  "error": "validation_error",
  "message": "Project with ID 999 not found",
  "field": "project_id"
}

Umgang: Vorher mit list_projects prüfen, ob project_id existiert

Ungültiges Datumsformat

Situation: due_date ist nicht im ISO-Format (YYYY-MM-DD)

Antwort:

{
  "error": "validation_error",
  "message": "Invalid date format. Use YYYY-MM-DD",
  "field": "due_date"
}

Umgang: ISO-Datumsformat verwenden: YYYY-MM-DD (z. B. "2026-03-15")

Ungültiger Statuswert

Situation: status ist keiner von: open, in_progress, done, blocked

Antwort:

{
  "error": "validation_error",
  "message": "Invalid status. Must be: open, in_progress, done, or blocked",
  "field": "status"
}

Umgang: Nur gültige Statuswerte verwenden

Fehlerbehebung

Validierungsfehler (400)

Symptom: 400 Bad Request mit Validierungsfehler

Ursachen:

• Fehlendes Pflichtfeld (title)
• Ungültiges Feldformat (Datum, Status, Priorität)
• Ungültige ID (project_id, board_id, assignee_id existieren nicht)

Lösung:

• Sicherstellen, dass title angegeben und nicht leer ist
• Vor der Nutzung prüfen, ob alle IDs existieren
• Korrekte Formate verwenden (ISO-Daten, gültige Status-/Prioritätswerte)

Validierungs-Fehlerbehebung →

Projekt nicht gefunden

Symptom: Validierungsfehler zu project_id

Ursachen:

• Projekt-ID existiert nicht
• Projekt gehört einem anderen Arbeitsbereich
• Projekt wurde gelöscht

Lösung:

• Mit list_projects gültige Projekt-IDs finden
• Prüfen, ob das Projekt in Ihrem Arbeitsbereich existiert
• project_id weglassen, um das Standardprojekt zu nutzen

Best Practices

create_task sicher nutzen

• ✅ Vor dem Anlegen immer Aufgabendetails in der Vorschau zeigen
• ✅ Ausdrückliche Bestätigung verlangen (CONFIRM-Token)
• ✅ Vor der Nutzung prüfen, ob project_id und board_id existieren
• ✅ Aussagekräftige Titel verwenden (nicht nur „Aufgabe“ oder „Neue Aufgabe“)
• ✅ Bei komplexen Aufgaben Beschreibungen einfügen
• ✅ Bei Bekanntheit passende Fälligkeitsdaten setzen
• ✅ Tags für Struktur und Filterung nutzen
• ✅ Nach dem Anlegen bei Bedarf Prüfkommentare hinzufügen

Verwandte Tools

Oft zusammen verwendet mit:

• list_projects – Projekt-IDs finden, bevor Aufgaben angelegt werden
• get_task – Prüfen, ob die Aufgabe erfolgreich angelegt wurde
• Least-Privilege Workflows – Sichere Schreib-Workflow-Muster