MCP-Tools-Referenz
AB Projects stellt MCP-Tools bereit, mit denen KI-Assistenten (wie Claude) mit Ihren Projekten, Aufgaben und Dokumenten arbeiten können. Wenn ein Assistent über diese Tools etwas ändert, durchläuft dies denselben Pfad wie die App: einen Eintrag in der Änderungshistorie mit der von Ihnen angegebenen Notiz, einen Eintrag im Audit-Log und eine Adaptive Card (adaptive Karte), die im verknüpften Microsoft-Teams-Kanal veröffentlicht wird — wobei die KI-Aktivität klar offengelegt wird. Nur-Lese-Tools geben lediglich Daten zurück und ändern nichts.
Projekt-Tools
| Tool | Beschreibung | Parameter |
|---|---|---|
ab_get_my_projects |
Listet alle Projekte auf, in denen Sie Mitglied sind, einschließlich Statistiken wie Aufgabenanzahl und Abschlussraten. | Keine |
ab_get_project_members |
Listet alle Mitglieder eines Projekts mit ihren Rollen und Mitgliedschafts-IDs auf. Verwenden Sie dies, um die für die Zuweisung einer Aufgabe benötigte Mitgliedschafts-ID zu erhalten. | project_id erforderlich |
ab_get_project_options |
Ruft die gültigen Status-, Typ- und Umgebungs-IDs für ein Projekt ab. Rufen Sie dies zuerst auf, bevor Sie einen Status, Typ oder eine Umgebung an ab_create_task oder ab_update_task übergeben. |
project_id erforderlich |
Aufgaben-Tools
| Tool | Beschreibung | Parameter |
|---|---|---|
ab_get_my_tasks |
Ruft Ihre aktiven Aufgaben ab — überfällig, heute fällig und in Bearbeitung. Gibt Aufgaben-ID, Titel, Priorität, Status, Fälligkeitsdatum und Fortschritt zurück. | project_id optional — auf ein bestimmtes Projekt filtern |
ab_search_tasks |
Sucht Aufgaben nach Stichwort über alle Ihre Projekte hinweg. | query erforderlich — Suchstichwort project_id optional — auf ein bestimmtes Projekt eingrenzen |
ab_get_task |
Ruft alle Details einer Aufgabe ab — Beschreibung, Daten, Bearbeiter, geschätzte/tatsächliche Stunden, Unteraufgaben-Infos, übergeordnete Aufgaben-ID, GitHub-Branch und die letzten 50 Kommentare inline. Status, Typ und Umgebung werden als menschenlesbare Namen zurückgegeben. | project_id erforderlich task_id erforderlich |
ab_create_task |
Erstellt eine neue Aufgabe. Ein Eintrag im Änderungsprotokoll wird aufgezeichnet und eine Benachrichtigung im verknüpften Teams-Kanal veröffentlicht. | project_id erforderlich title erforderlich description optional — unterstützt Markdown priority optional — 1 = Hoch, 2 = Mittel, 3 = Niedrig (Standard: 2) assignee_id optional — Mitgliedschafts-ID des Bearbeiters due_date optional — yyyy-MM-dd status / type / environment optional — IDs aus ab_get_project_optionsparent_task_id optional — Row Key der übergeordneten Aufgabe; wenn gesetzt, wird dies zu einer Unteraufgabe und das Kennzeichen „hat Unteraufgaben“ der übergeordneten Aufgabe wird automatisch aktualisiert note optional — Begründung, angezeigt im Änderungsprotokoll und Teams-Kanal |
ab_update_task |
Aktualisiert die Eigenschaften einer Aufgabe — Titel, Beschreibung, Status, Fortschritt, Priorität, Bearbeiter, Typ, Umgebung oder übergeordnete Aufgabe. Jede Änderung wird mit der angegebenen Notiz in der Historie aufgezeichnet. | project_id erforderlich task_id erforderlich title / description optional (Markdown) status optional — neue Status-ID progress optional — 0 bis 100 priority optional — 1/2/3 assignee_id / type / environment optional parent_task_id optional — unter eine andere übergeordnete Aufgabe verschieben; leerer String zum Lösen note optional — Begründung, angezeigt im Änderungsprotokoll und Teams-Kanal |
ab_complete_task |
Markiert eine Aufgabe als abgeschlossen. Setzt den Fortschritt auf 100 % und zeichnet einen Abschlusseintrag in der Änderungshistorie auf. | project_id erforderlich task_id erforderlich note optional — Abschlussnotiz, angezeigt im Änderungsprotokoll und Teams-Kanal |
ab_add_comment |
Fügt einer Aufgabe einen Kommentar hinzu. Der Kommentar erscheint im Thread der Aufgabe und wird von ab_get_task inline eingebunden, sodass ein Folgeaufruf ihn ohne einen zweiten Tool-Aufruf lesen kann. |
project_id erforderlich task_id erforderlich content erforderlich — Kommentartext |
Zeitplan-Tools
| Tool | Beschreibung | Parameter |
|---|---|---|
ab_get_schedule |
Ruft Ihren Zeitplan für die aktuelle Woche ab — gruppiert in überfällig, heute fällig und diese Woche fällig. | project_id optional — auf ein bestimmtes Projekt filtern |
Dokumente-(Wiki-)Tools
| Tool | Beschreibung | Parameter |
|---|---|---|
ab_get_wiki_tree |
Ruft den Navigationsbaum der Dokumente (Ordner und Seiten) für ein Projekt ab. | project_id erforderlich |
ab_get_wiki_article |
Liest den vollständigen Inhalt, die Metadaten und Versionsinformationen eines Dokuments. | project_id erforderlich article_id erforderlich — aus ab_get_wiki_tree oder ab_search_wiki |
ab_search_wiki |
Listet Dokumente unter einem bestimmten Ordnerpfad auf. | project_id erforderlich parent_path optional — Ordner, aus dem aufgelistet wird (Standard: / für Stammverzeichnis) |
ab_create_wiki_article |
Erstellt ein neues Dokument in Markdown. Veröffentlicht eine Benachrichtigung im verknüpften Teams-Kanal. | project_id erforderlich title erforderlich content erforderlich — Markdown parent_path optional — Ordner, z. B. / oder /Engineering (Standard: /)tags optional — durch Komma getrennt |
ab_update_wiki_article |
Aktualisiert ein vorhandenes Dokument. Erstellt eine neue Version mit einer Bearbeitungsnotiz und veröffentlicht eine Benachrichtigung im Teams-Kanal. | project_id erforderlich article_id erforderlich content erforderlich — aktualisiertes Markdown edit_note erforderlich — was sich geändert hat; angezeigt in der Versionshistorie tags optional — aktualisierte, durch Komma getrennte Tags |
ab_add_wiki_comment |
Fügt einem Dokument einen Kommentar hinzu. | project_id erforderlich article_id erforderlich content erforderlich — Kommentartext |
Wie KI-Änderungen sichtbar bleiben
Wenn eine Aufgabe oder ein Dokument über ein MCP-Tool erstellt, aktualisiert oder abgeschlossen wird, führt AB Projects automatisch Folgendes aus:
- Zeichnet die Änderung in der Änderungshistorie des Elements mit dem Namen des Benutzers und der angegebenen Notiz auf
- Schreibt einen Eintrag im Vorgangsprotokoll zu Audit-Zwecken
- Veröffentlicht oder aktualisiert eine Adaptive Card (adaptive Karte) im verknüpften Microsoft-Teams-Kanal des Projekts, wobei die Aktivität klar als KI-generiert offengelegt wird
So tragen KI-gesteuerte Änderungen dieselbe Sichtbarkeit und Nachvollziehbarkeit wie Änderungen, die direkt in der AB-Projects-App oder der Teams-Registerkarte vorgenommen werden. Wie Sie einen Assistenten verbinden, erfahren Sie unter KI-Assistenten über MCP verbinden.