MCP-Tools: Aufgaben, Projekte und Meilensteine

list_tasks

Listet Aufgaben der Organisation, neueste zuerst. Filterbar nach Status, Priorität, Projekt und übergeordneter Aufgabe. Liefert die vollständigen Aufgabenzeilen. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Aufgaben“ aktiv.

status: Optional · string · todo | in_progress | done | backlog | list_only — Nur Aufgaben mit diesem Status.
priority: Optional · string · low | medium | high | critical — Nur Aufgaben mit dieser Priorität.
projectId: Optional · string — Nur Einträge dieses Projekts.
parentTaskId: Optional · string — Nur Unteraufgaben dieser Aufgabe.
limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 50, höchstens 200).

get_task

Liefert eine einzelne Aufgabe anhand ihrer ID. Ist die Aufgabe unbekannt oder gehört sie zu einer anderen Organisation, kommt der Fehler „Task not found“. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Aufgaben“ aktiv.

id: Pflicht · string — ID der Aufgabe.

create_task

Legt eine Aufgabe an. Ohne assigneeId wirst du selbst zugewiesen; ein ausdrücklich gesendetes null lässt die Aufgabe unzugewiesen. Die Aufgabennummer wird pro Organisation atomar und fortlaufend vergeben. Projekt, Meilenstein, übergeordnete Aufgabe und Zuständige müssen zur selben Organisation gehören, sonst kommt ein Fehler. Die Aufgabe wird zusätzlich für die semantische Ähnlichkeitssuche indexiert. Gibt die angelegte Aufgabenzeile zurück. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Aufgaben“ aktiv.

name: Pflicht · string — Titel der Aufgabe.
description: Optional · string — Beschreibung als Freitext.
status: Optional · string · todo | in_progress | done | backlog — Anfangsstatus. Standard: todo.
priority: Optional · string · low | medium | high | critical — Priorität der Aufgabe.
projectId: Optional · string — ID des zugeordneten Projekts.
milestoneId: Optional · string — ID des Meilensteins.
dueDate: Optional · string — Fälligkeitsdatum (ISO 8601).
tags: Optional · string[] — Schlagwörter als Liste.
assigneeId: Optional · string — Interne Nutzer-ID der zuständigen Person (Feld userId aus list_members). Standard: du selbst.
assigneeIds: Optional · string[] — Mehrere Zuständige als Liste interner Nutzer-IDs (Feld userId aus list_members).
parentTaskId: Optional · string — ID der übergeordneten Aufgabe (macht diese Aufgabe zur Unteraufgabe).

update_task

Ändert eine bestehende Aufgabe; nur die übergebenen Felder werden angepasst. Eine Aufgabe kann nicht ihre eigene übergeordnete Aufgabe sein. Mit einem leeren String bei parentTaskId wird sie wieder zur Hauptaufgabe. Verweise werden erneut auf Organisationszugehörigkeit geprüft; ändern sich Name, Beschreibung, Kategorie oder Tags, wird der Suchindex aktualisiert. Gibt die aktualisierte Zeile zurück. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Aufgaben“ aktiv.

id: Pflicht · string — ID der Aufgabe.
name: Optional · string — Neuer Titel.
description: Optional · string — Beschreibung als Freitext.
status: Optional · string · todo | in_progress | done | backlog — Neuer Status.
priority: Optional · string · low | medium | high | critical — Neue Priorität.
projectId: Optional · string — ID des zugeordneten Projekts.
milestoneId: Optional · string — ID des Meilensteins.
dueDate: Optional · string — Neues Fälligkeitsdatum (ISO 8601); ein leerer Wert entfernt es.
tags: Optional · string[] — Schlagwörter als Liste.
assigneeId: Optional · string — Interne Nutzer-ID der zuständigen Person (Feld userId aus list_members).
assigneeIds: Optional · string[] — Mehrere Zuständige als Liste interner Nutzer-IDs (Feld userId aus list_members).
parentTaskId: Optional · string — ID der übergeordneten Aufgabe. Ein leerer String löst die Verknüpfung.

delete_task

Löscht eine Aufgabe dauerhaft. 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 „Aufgaben“ aktiv.

id: Pflicht · string — ID der Aufgabe.

find_similar_tasks

Decision Context Layer: semantische Suche nach früheren, ähnlichen Aufgaben – entweder per Freitext (query) oder ausgehend von einer bestehenden Aufgabe (taskId; sie selbst wird ausgeschlossen). Liefert similarTasks mit geschätzten und tatsächlich erfassten Stunden, dazu passende Knowledgebase-Ausschnitte (kbHits) und das Flag degraded. Grundlage für Aufwandsschätzungen, Priorisierung und Sprint-Planung. Es gelten deine Sichtbarkeitsregeln für Aufgaben. Entweder query oder taskId ist erforderlich. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Aufgaben“ aktiv.

query: Optional · string — Freitextbeschreibung der Arbeit, zu der vergleichbare Aufgaben gesucht werden.
taskId: Optional · string — ID einer bestehenden Aufgabe, zu der ähnliche gesucht werden (Alternative zu query).
limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 6, höchstens 20).
onlyDone: Optional · boolean · Standard: false — Beschränkt auf abgeschlossene Aufgaben (ideal für den Vergleich Schätzung gegen Ist). Standard: false.
includeKb: Optional · boolean · Standard: true — Liefert zusätzlich passende Knowledgebase-Ausschnitte (Standard: true).

estimate_task_effort

KI-Aufwandsschätzung: schlägt Stunden für eine neue (query) oder bestehende Aufgabe (taskId) vor – auf Basis vergleichbarer abgeschlossener Aufgaben, wobei erfasste Zeit vor Soll-Zeit bevorzugt wird. Das Ergebnis enthält Spanne, Konfidenz und die Aufgaben, auf denen die Schätzung beruht. Gibt es zu wenige Vergleichsaufgaben, schätzt die KI allgemein anhand des typischen realen Aufwands (method="ai-general"). estimate ist nur dann null, wenn die KI nicht verfügbar ist. Das Ergebnis ist KI-generiert – prüfe es, bevor du es übernimmst. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Aufgaben“ aktiv.

query: Optional · string — Freitextbeschreibung der zu schätzenden Arbeit.
taskId: Optional · string — ID einer bestehenden Aufgabe, die geschätzt werden soll (Alternative zu query).

list_projects

Listet alle Projekte der Organisation, neueste zuerst. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Projekte“ aktiv.

limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 50, höchstens 200).

get_project

Liefert ein einzelnes Projekt anhand seiner ID. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Projekte“ aktiv.

id: Pflicht · string — ID des Projekts.

create_project

Legt ein Projekt an; du wirst als Ersteller gespeichert. Nur der Name ist Pflicht. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Projekte“ aktiv.

name: Pflicht · string — Projektname.
description: Optional · string — Beschreibung als Freitext.
category: Optional · string — Kategorie als Freitext.
color: Optional · string — Projektfarbe als Hex-Wert, z. B. #6366f1.
hourlyRate: Optional · number — Stundensatz des Projekts.
budgetHours: Optional · number — Stundenbudget des Projekts.

update_project

Ändert ein Projekt; nur die übergebenen Felder werden angepasst. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Projekte“ aktiv.

id: Pflicht · string — ID des Projekts.
name: Optional · string — Neuer Projektname.
description: Optional · string — Beschreibung als Freitext.
category: Optional · string — Kategorie als Freitext.
color: Optional · string — Neue Projektfarbe als Hex-Wert.
hourlyRate: Optional · number — Neuer Stundensatz des Projekts.
budgetHours: Optional · number — Stundenbudget des Projekts.

delete_project

Löscht ein Projekt dauerhaft. 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 „Projekte“ aktiv.

id: Pflicht · string — ID des Projekts.

list_milestones

Listet Meilensteine der Organisation, neueste zuerst; filterbar nach Status und Phase. Dieses Tool hat keinen Modul-Schalter und steht immer zur Verfügung. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, kein Modul-Schalter (immer verfügbar).

status: Optional · string · upcoming | in-progress | completed | delayed — Nur Meilensteine mit diesem Status.
phase: Optional · string · pre-mvp | mvp | pmf | growth | custom — Nur Meilensteine dieser Phase.
limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 50, höchstens 200).

get_milestone

Liefert einen einzelnen Meilenstein anhand seiner ID. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, kein Modul-Schalter (immer verfügbar).

id: Pflicht · string — ID des Meilensteins.

create_milestone

Legt einen Meilenstein an; du wirst als Ersteller gespeichert. Ohne Angaben startet er mit Phase custom und Status upcoming. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, kein Modul-Schalter (immer verfügbar).

title: Pflicht · string — Titel.
description: Optional · string — Beschreibung als Freitext.
phase: Optional · string · pre-mvp | mvp | pmf | growth | custom — Phase. Standard: custom.
status: Optional · string · upcoming | in-progress | completed | delayed — Anfangsstatus. Standard: upcoming.
targetDate: Optional · string — Zieldatum (ISO 8601).

update_milestone

Ändert einen Meilenstein. Wird der Status auf completed gesetzt, trägt das Tool automatisch das aktuelle Datum als Abschlussdatum ein. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, kein Modul-Schalter (immer verfügbar).

id: Pflicht · string — ID des Meilensteins.
title: Optional · string — Titel.
description: Optional · string — Beschreibung als Freitext.
phase: Optional · string · pre-mvp | mvp | pmf | growth | custom — Neue Phase.
status: Optional · string · upcoming | in-progress | completed | delayed — Neuer Status. completed setzt das Abschlussdatum.
targetDate: Optional · string — Neues Zieldatum (ISO 8601); ein leerer Wert entfernt es.

delete_milestone

Löscht einen Meilenstein. 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, kein Modul-Schalter (immer verfügbar).

id: Pflicht · string — ID des Meilensteins.

Häufige Stolperfallen

Standardzuweisung
create_task weist dich selbst zu, wenn du keine assigneeId sendest. Soll die Aufgabe unzugewiesen bleiben, muss ausdrücklich null gesendet werden.
Zugehörigkeit wird geprüft
Projekt, Meilenstein, übergeordnete Aufgabe und Zuständige müssen zur selben Organisation gehören; sonst kommt ein Fehler wie „projectId does not belong to this organization“.
Status-Werte unterscheiden sich
list_tasks kennt zusätzlich den Status list_only; beim Anlegen und Ändern sind todo, in_progress, done und backlog erlaubt.
Löschen ist endgültig
delete_task und delete_project löschen dauerhaft und verlangen Admin-Rolle und delete-Scope.