list_sprints
Listet Sprints der Organisation, neueste zuerst, jeweils mit Aufgabenanzahl (taskCount) und Summe der geschätzten Stunden (estimatedHours). Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Sprints“ aktiv.
- status
- Optional · string · planning | active | completed | cancelled — Nur Sprints mit diesem Status.
- projectId
- Optional · string — Nur Sprints dieses Projekts.
get_sprint
Liefert einen Sprint samt aller Aufgaben mit Soll (estimatedHours) und Ist (actualHours aus den Zeiteinträgen) sowie Kennzahlen: totalTasks, completedTasks, totalEstimatedHours, totalActualHours und capacityUsedPercent (Verhältnis Soll zu Kapazität). Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Sprints“ aktiv.
- id
- Pflicht · string — ID des Sprints.
create_sprint
Legt einen Sprint an. Nur der Name ist Pflicht; ohne weitere Angabe startet der Sprint im Status planning. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Sprints“ aktiv.
- name
- Pflicht · string — Name des Sprints.
- goal
- Optional · string — Sprintziel als Beschreibung.
- startDate
- Optional · string — Startdatum (ISO 8601, YYYY-MM-DD).
- endDate
- Optional · string — Enddatum (ISO 8601, YYYY-MM-DD).
- capacityHours
- Optional · number — Gesamtkapazität des Teams für den Sprint in Stunden (Soll).
- projectId
- Optional · string — Optionale Zuordnung zu einem Projekt.
- status
- Optional · string · planning | active | completed | cancelled — Anfangsstatus. Standard: planning.
update_sprint
Ändert einen Sprint. Hiermit startest (active) oder beendest (completed) du einen Sprint und passt Zeitraum, Ziel oder Kapazität an. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Sprints“ aktiv.
- id
- Pflicht · string — ID des Sprints.
- name
- Optional · string — Neuer Name.
- goal
- Optional · string — Sprintziel als Beschreibung.
- startDate
- Optional · string — Startdatum (ISO 8601, YYYY-MM-DD).
- endDate
- Optional · string — Enddatum (ISO 8601, YYYY-MM-DD).
- capacityHours
- Optional · number — Gesamtkapazität des Teams für den Sprint in Stunden (Soll).
- projectId
- Optional · string — Neue Projektzuordnung.
- status
- Optional · string · planning | active | completed | cancelled — Neuer Status.
delete_sprint
Löscht einen Sprint dauerhaft und entfernt alle Aufgabenzuordnungen des Sprints; die Aufgaben selbst werden nicht gelöscht. Erfordert mindestens die Rolle Admin und einen Schlüssel mit delete-Scope. Voraussetzungen: Rolle Admin oder höher, Schlüssel-Scope „delete“ oder höher, Modul „Sprints“ aktiv.
- id
- Pflicht · string — ID des Sprints.
add_task_to_sprint
Fügt eine bestehende Aufgabe einem Sprint hinzu (mehrfaches Hinzufügen ist unschädlich) und setzt die Sprint-Zuordnung an der Aufgabe. Geprüft wird, dass der Sprint zur Organisation gehört. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Sprints“ aktiv.
- sprintId
- Pflicht · string — ID des Sprints.
- taskId
- Pflicht · string — ID der Aufgabe, die aufgenommen wird.
remove_task_from_sprint
Entfernt eine Aufgabe aus einem Sprint und löscht die Sprint-Zuordnung an der Aufgabe. Die Aufgabe selbst bleibt bestehen. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Sprints“ aktiv.
- sprintId
- Pflicht · string — ID des Sprints.
- taskId
- Pflicht · string — ID der Aufgabe, die entfernt wird.
suggest_sprint_plan
KI-Sprintplanung: Ein KI-Planer stellt den Sprint aus dem offenen Backlog zusammen und gewichtet dabei Priorität, Fristen, Sprintziel und Aufwand (manuelle Stunden, Schätzungen ähnlicher Aufgaben oder eigene realistische Schätzungen) innerhalb der Sprintkapazität. Steht die KI nicht zur Verfügung, greift ein regelbasierter Plan (method="rules"). Das Tool ändert nichts – den Vorschlag übernimmst du mit add_task_to_sprint. Es gelten deine Sichtbarkeitsregeln für Aufgaben. Das Ergebnis ist KI-generiert. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Sprints“ aktiv.
- sprintId
- Pflicht · string — ID des Sprints.
get_planning_week
Zeigt die Wochenplanung: für jedes Mitglied die der Woche zugeordneten Aufgaben sowie die Auslastung – hoursPerWeek (hinterlegte Kapazität, sonst 40), usedHours (Summe der geschätzten Stunden) und utilizationPct. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Planung“ aktiv.
- week
- Optional · string — Montag der Woche als ISO-Datum (z. B. 2026-06-30). Standard: aktuelle Woche.
list_unscheduled_tasks
Listet Aufgaben, die noch keiner Woche im Planungsplan zugeordnet sind. Das Tool filtert nicht nach Status; erledigte Aufgaben erscheinen daher ebenfalls. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Planung“ aktiv.
- limit
- Optional · number — Maximale Anzahl Ergebnisse (Standard 30, höchstens 100).
Häufige Stolperfallen
Der Vorschlag ändert nichts
suggest_sprint_plan ist rein lesend. Übernehmen musst du den Vorschlag mit add_task_to_sprint (und den Sprint per update_sprint auf active setzen).
Löschen entfernt nur Zuordnungen
delete_sprint löscht den Sprint und seine Zuordnungen; die Aufgaben selbst bleiben bestehen.
Nicht eingeplant heißt nicht offen
list_unscheduled_tasks filtert nicht nach Status und zeigt daher auch erledigte Aufgaben.