AgileHero

npx add-mcp 'https://mcp.agilehero.io/mcp'

AgileHero wird mit einem integrierten MCP-Server ausgeliefert: Fügen Sie eine URL zu einem beliebigen MCP-fähigen KI-Assistenten hinzu, melden Sie sich mit Ihrem AgileHero-Konto an, und er arbeitet mit Ihren Projekten mit genau Ihren Berechtigungen – 49 Tools für Boards, Backlog, Epics, Wiki, Whiteboards, Retrospektiven und Roadmap. Diese Referenz wird direkt vom Server generiert und ist daher immer aktuell.

Neu hier? Beginnen Sie mit der KI-Agenten-Übersicht oder springen Sie direkt zu Verbinden Ihres Clients weiter unten. Rich Text auf diesem Server ist überall AgileHero Markup (AHM) – ein strenger, validierter XML-Dialekt, der entwickelt wurde, damit Agenten menschliche Inhalte niemals beschädigen. Sie schreiben ein Skript, statt einen Assistenten zu verbinden? Die REST-API-Referenz verwendet dieselbe OAuth-Anmeldung.

Verbinden Sie Ihren KI-Client

Verbinden bedeutet zwei Dinge: Fügen Sie die Endpunkt-URL zu Ihrem Client hinzu und melden Sie sich dann mit Ihrem AgileHero-Konto an, wenn der Client Sie dazu auffordert. Es gibt keinen Schlüssel zu erstellen oder einzufügen. Sobald die Verbindung hergestellt ist, handelt der Client als Sie, mit genau Ihren Berechtigungen; jeder verbundene Client wird unter Einstellungen → KI-Clients in der App aufgelistet, wo Sie ihn jederzeit widerrufen können. Beobachter können den MCP-Server nicht verwenden: Ein Arbeitsbereich, in dem Sie Beobachter sind, wird nicht aufgelistet, und alles darin wird als nicht gefunden gelesen.

Endpunkt

https://mcp.agilehero.io/mcp

Transport

Streamable HTTP (POST)

Anmeldung

Ihr KI-Client öffnet ein Browserfenster; einmal genehmigen, jederzeit widerrufen unter Einstellungen → KI-Clients.

Claude Code

Führen Sie einmal in einem Terminal aus; Claude Code speichert den Server in Ihrer Benutzerkonfiguration und meldet sich über Ihren Browser an.

claude mcp add --transport http --scope user agilehero https://mcp.agilehero.io/mcp

• Alle Flags müssen vor dem Servernamen stehen.
• Führen Sie dann /mcp in einer Claude-Code-Sitzung aus und wählen Sie Authentifizieren (oder führen Sie claude mcp login agilehero aus) und genehmigen Sie die Anmeldung in Ihrem Browser.

Überprüfen: Führen Sie claude mcp list aus – agilehero sollte als verbunden angezeigt werden. Wenn „Authentifizierung erforderlich“ angezeigt wird, führen Sie claude mcp login agilehero aus.

Claude-Code-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

VS Code (GitHub Copilot)

Fügen Sie .vscode/mcp.json in einem Arbeitsbereich hinzu oder führen Sie „MCP: Benutzerkonfiguration öffnen“ für alle Arbeitsbereiche aus. Beim ersten Start des Servers öffnet sich ein Browserfenster für die Anmeldung.

.vscode/mcp.json

{
  "servers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• „type“: „http“ ist erforderlich – ohne dies behandelt VS Code die URL als auszuführenden Befehl.

Überprüfen: Führen Sie „MCP: Server auflisten“ aus, starten Sie agilehero, schließen Sie die Anmeldung im Browser ab und prüfen Sie, ob seine Tools in der Chat-Ansicht erscheinen.

VS-Code-Dokumentation (GitHub Copilot) · geprüft gegen die Anbieterdokumentation am 15.09.2026

Codex

Fügen Sie vom Terminal aus hinzu und melden Sie sich dann an – die Konfiguration wird von der Codex-CLI, der IDE-Erweiterung und der ChatGPT-Desktop-App gemeinsam genutzt.

codex mcp add agilehero --url https://mcp.agilehero.io/mcp
codex mcp login agilehero

• Codex startet die Anmeldung nicht von selbst – führen Sie codex mcp login agilehero nach dem Hinzufügen des Servers aus.

Überprüfen: Führen Sie codex mcp list aus – agilehero sollte als authentifiziert angezeigt werden; bitten Sie Codex dann, Ihre AgileHero-Projekte aufzulisten.

Codex-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

Zed

Fügen Sie zu settings.json hinzu oder verwenden Sie Einstellungen → KI → MCP-Server → Remote-Server hinzufügen; Zed fordert Sie zur Anmeldung auf.

~/.config/zed/settings.json

{
  "context_servers": {
    "agilehero": {
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• Lassen Sie Header weg – Zed startet die Anmeldung nur, wenn kein Authorization-Header konfiguriert ist.

Überprüfen: Starten Sie Zed neu, genehmigen Sie die Anmeldung in Ihrem Browser, wenn Sie dazu aufgefordert werden, und bitten Sie es, Ihre AgileHero-Projekte aufzulisten – der erste erfolgreiche Aufruf bestätigt die Verbindung.

Zed-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

GitHub Copilot CLI

Fügen Sie zu ~/.copilot/mcp-config.json oder .mcp.json in einem Repository hinzu.

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• Erfordert GitHub Copilot CLI 1.0.83 oder neuer (Unterstützung für Client-ID-Metadaten-Dokumente).
• Copilot CLI öffnet die Anmeldung, wenn der Server sie zum ersten Mal anfordert; Sie können auch /mcp auth agilehero in einer Sitzung ausführen.

Überprüfen: Führen Sie /mcp in Copilot CLI aus – agilehero sollte als verbunden mit seinen Tools aufgelistet sein.

GitHub-Copilot-CLI-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

Claude (Web, Desktop, Cowork)

Fügen Sie AgileHero als benutzerdefinierten Connector hinzu und melden Sie sich an; der Connector ist in Claude im Web, Claude Desktop, Cowork und den mobilen Apps verfügbar.

Settings → Connectors → Add custom connector
Name: AgileHero
URL: https://mcp.agilehero.io/mcp
Sign in now

• Der Connector erscheint auch in Claude Code, wenn es mit demselben Claude-Konto angemeldet ist.
• Kostenloser Plan: ein benutzerdefinierter Connector. Team und Enterprise: Ein Besitzer fügt den Connector hinzu, und jedes Mitglied meldet sich mit seinem eigenen AgileHero-Konto an.

Überprüfen: Starten Sie einen neuen Chat – AgileHero wird unter Connectors aufgelistet, und die Aufforderung an Claude, Ihre AgileHero-Projekte aufzulisten, funktioniert.

Claude-Dokumentation (Web, Desktop, Cowork) · geprüft gegen die Anbieterdokumentation am 15.09.2026

ChatGPT

Erstellen Sie einen Connector im Entwicklermodus und melden Sie sich mit OAuth an.

Settings → Connectors → Create (Developer mode)
Name: AgileHero
MCP server URL: https://mcp.agilehero.io/mcp
Authentication: OAuth

• Verfügbar auf Plus, Pro, Business, Enterprise und Edu mit aktiviertem Entwicklermodus; in einem Arbeitsbereich veröffentlicht ein Administrator oder Besitzer den Connector für Mitglieder.

Überprüfen: Öffnen Sie einen neuen Chat mit aktiviertem AgileHero-Connector und bitten Sie ChatGPT, Ihre AgileHero-Projekte aufzulisten.

ChatGPT-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

Anderer Client

Jeder MCP-Client, der OAuth mit Client-ID-Metadaten-Dokumenten unterstützt: Fügen Sie den Endpunkt als Remote-Server (Streamable HTTP) hinzu und genehmigen Sie die Anmeldung in Ihrem Browser.

Transport: Streamable HTTP
URL: https://mcp.agilehero.io/mcp
Authentication: OAuth (sign in when the client asks)

• Clients, die nur statische Token oder Header unterstützen, können keine Verbindung herstellen – AgileHero verwendet ausschließlich die OAuth-Anmeldung.

Überprüfen: Starten Sie den Client neu, genehmigen Sie die Anmeldung in Ihrem Browser, wenn Sie dazu aufgefordert werden, und bitten Sie ihn, Ihre AgileHero-Projekte aufzulisten – der erste erfolgreiche Aufruf bestätigt die Verbindung.

Dokumentation für andere Clients · geprüft gegen die Anbieterdokumentation am 15.09.2026

Noch nicht unterstützt

Diese Clients können sich noch nicht bei AgileHero anmelden. Die meisten von ihnen unterstützen keine Client-ID-Metadaten-Dokumente, die OAuth-Client-Registrierungsmethode, die AgileHero verwendet (die aktuelle MCP-Empfehlung); wir überprüfen die Anbieterdokumentation regelmäßig und stufen einen Client hoch, sobald er die Voraussetzungen erfüllt.

CursorNoch nicht

Cursor unterstützt Client-ID-Metadaten-Dokumente noch nicht (seine OAuth-Anmeldung benötigt Dynamic Client Registration oder einen vorregistrierten Client), daher kann es sich derzeit nicht mit AgileHero verbinden.

Cursor-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

OpenCodeNoch nicht

OpenCode unterstützt Client-ID-Metadaten-Dokumente noch nicht (seine OAuth-Anmeldung benötigt Dynamic Client Registration oder einen vorregistrierten Client), daher kann es sich derzeit nicht mit AgileHero verbinden.

OpenCode-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

Gemini CLINoch nicht

Gemini CLI unterstützt Client-ID-Metadaten-Dokumente noch nicht (seine OAuth-Anmeldung benötigt Dynamic Client Registration oder einen vorregistrierten Client), daher kann es sich derzeit nicht mit AgileHero verbinden.

Gemini-CLI-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

ClineNoch nicht

Cline unterstützt Client-ID-Metadaten-Dokumente noch nicht (seine OAuth-Anmeldung benötigt Dynamic Client Registration oder einen vorregistrierten Client), daher kann es sich derzeit nicht mit AgileHero verbinden.

Cline-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

Google AntigravityNoch nicht

Google Antigravity unterstützt Client-ID-Metadaten-Dokumente noch nicht (seine OAuth-Anmeldung benötigt Dynamic Client Registration oder einen vorregistrierten Client), daher kann es sich derzeit nicht mit AgileHero verbinden.

Google-Antigravity-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

AmpNoch nicht

Amp unterstützt Client-ID-Metadaten-Dokumente noch nicht (seine OAuth-Anmeldung benötigt Dynamic Client Registration oder einen vorregistrierten Client), daher kann es sich derzeit nicht mit AgileHero verbinden.

Amp-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

Raycast AINoch nicht

Raycast AI unterstützt Client-ID-Metadaten-Dokumente noch nicht (seine OAuth-Anmeldung benötigt Dynamic Client Registration oder einen vorregistrierten Client), daher kann es sich derzeit nicht mit AgileHero verbinden.

Raycast-AI-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

KiroNoch nicht

Kiro meldet sich mit einer Client-ID-Metadaten-Dokument-URL an, die Sie bereitstellen, und AgileHero hostet dafür noch kein Client-ID-Metadaten-Dokument.

Kiro-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

WarpNoch nicht

Warp hat noch keine OAuth-Anmeldung für benutzerhinzugefügte Server, daher kann es sich derzeit nicht mit AgileHero verbinden.

Warp-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

JetBrains AI AssistantNoch nicht

JetBrains AI Assistant hat keine OAuth-Anmeldung für Remote-Server, und die mcp-remote-Brücke würde ein gehostetes Client-Dokument benötigen – AgileHero hostet dafür noch kein Client-ID-Metadaten-Dokument.

JetBrains-AI-Assistant-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

ContinueNoch nicht

Continue hat keine OAuth-Anmeldung für Streamable-HTTP-Server, und die mcp-remote-Brücke würde ein gehostetes Client-Dokument benötigen – AgileHero hostet dafür noch kein Client-ID-Metadaten-Dokument.

Continue-Dokumentation · geprüft gegen die Anbieterdokumentation am 15.09.2026

Serveranweisungen

Jeder MCP-Client erhält diese Konventionen zum Initialisierungszeitpunkt:

AgileHero-MCP-Server.

Jeder id-Parameter und jede id in einer Antwort ist eine kurze UID – verwenden Sie immer UIDs, die von Listen-/Such-/Abruf-Tools zurückgegeben werden, erfinden Sie niemals eine. Die meisten Tools benötigen eine Projekt-UID – rufen Sie list_projects auf, um Arbeitsbereiche und Projekte zu entdecken. Bevorzugen Sie search (Volltext, alle Inhaltstypen) gegenüber search_cards (Titel-Teilstring, ein Projekt).

Verwenden Sie bei Update-Tools die add_*/remove_*-Deltafelder für Sammlungen (inkrementell, sicher); die einfachen Sammlungsfelder (assigned_to, labels, checklists, cards_relations, links, attachments) ERSETZEN den vorherigen Zustand und können nicht mit ihren Deltas kombiniert werden. Checklistenelemente sind { description, checked }. Bleiben Sie mit updated_since bei list_cards / list_epics auf dem Laufenden.

Verwenden Sie move_card (nicht update_card), um die Liste oder Position einer Karte zu ändern; eine leere list_id bedeutet das Backlog.

Wiki-, Whiteboard-, Retrospektiven- und Roadmap-Tools erfordern, dass der Arbeitsbereich des Projekts einen Pro- oder Testplan hat. Whiteboard-Elementschreibvorgänge sind Batch-Tools und alles-oder-nichts; Element-UIDs stammen von get_whiteboard. Retrospektivenelemente werden mit add_retro_items und move_retro_item verwaltet (move_card lehnt Retrospektivenkarten ab).

Tägliche Limits: Tool-Aufrufe werden pro Benutzer und Arbeitsbereich gemessen – 500/Tag im kostenlosen Plan, 5.000/Tag bei Pro oder Test, zurückgesetzt um 00:00 UTC. get_ahm_spec und list_projects werden nie gezählt (auch kein Aufruf, der keinem einzelnen Arbeitsbereich zugeordnet werden kann, wie eine unspezifische Suche). Über dem Limit geben Tools einen Tageslimit-Fehler zurück, bis zum Reset oder einem Upgrade.

Der gesamte Rich Text (Wiki-Seiten, Karten-/Epic-Beschreibungen, Kommentare) ist AgileHero Markup (AHM) – strenges XML, NIEMALS Markdown oder HTML; rufen Sie get_ahm_spec einmal auf, bevor Sie etwas schreiben. Rich-Text-Bearbeitungen sind zweistufig: preview_wiki_page_update / preview_description_update (Konsequenzen + preview_token), dann das passende Update-Tool mit diesem Token.

Vollständige Tool-Dokumentation: https://agilehero.io/docs/mcp

AHM-Spezifikation: https://agilehero.io/docs/mcp/agilehero-markup

Tools (49)

list_projectsnur lesen

Listet jeden Arbeitsbereich und jedes Projekt auf, auf das der Benutzer des Tokens zugreifen kann, damit der Agent die Projekt-UID auflösen kann, die die meisten anderen Tools benötigen. Rufen Sie dies zuerst auf, wenn keine Projekt-UID bekannt ist – bitten Sie den Benutzer niemals, eine einzufügen. Gibt Arbeitsbereiche (uid, name, plan, your role) mit ihren Projekten (uid, name, url) zurück. Pro-Pfeiler-Tools (wiki, metrics) benötigen den Plan des Arbeitsbereichs als pro oder trial.

searchnur lesen

Die globale Volltextsuche des Produkts (OpenSearch): Karten, Epics, Wiki-Seiten und Projekte, die Titel, Beschreibungen, Kommentare, Checklistenelemente und Anhangsdateinamen abgleichen, nach Relevanz sortiert mit einem Aktualitäts-Boost. Verwenden Sie dies, um alles nach Inhalt zu finden („die Karte, auf der wir die Migration besprochen haben“); verwenden Sie search_cards nur für Titel-Teilstrengen-Suchen innerhalb eines Projekts. Jedes Ergebnis enthält einen Typ, eine aktionsbereite UID (Karten speisen get_card/update_card, Epics get_epic, wiki_pages show_wiki_page, Projekte die project_id-Parameter), eine Deep-Link-URL und <mark>-hervorgehobene Ausschnitte, die zeigen, warum es übereinstimmte. Optional mit project_id oder assigned_to_me eingrenzen. Mit page/per_page paginieren; total_count ist die Gesamtzahl der Übereinstimmungen.

Parameter	Typ	Erforderlich	Beschreibung
query	string	ja	Freitext-Suchabfrage
project_id	string		Optionale Projekt-UID, um die Suche einzugrenzen
assigned_to_me	boolean		Nur Ergebnisse, die dem Benutzer des Tokens zugewiesen sind
page	integer		Seitennummer (Standard 1)
per_page	integer		Ergebnisse pro Seite, 1-50 (Standard 20)

get_cardread-only

Eine Karte vollständig lesen: ihre AgileHero-Markup-Beschreibung mit Block-IDs plus description_version (die beiden Eingaben preview_description_update / update_description akzeptieren), Listenplatzierung, Epic, Labels, Zugewiesene, Reporter, Typ, Schätzung, Fälligkeitsdatum, Checklisten, Links, Anhänge, verwandte Karten und verschachtelte Kommentare. Akzeptiert nur die Karten-UID — es gibt keinen project_id-Parameter. Karten-UIDs stammen aus list_cards, search oder search_cards.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Die eindeutige Kennung der Karte

get_epicread-only

Ein Epic vollständig lesen: seine AgileHero-Markup-Beschreibung mit Block-IDs plus description_version (die beiden Eingaben preview_description_update / update_description akzeptieren), Name, Nummer, Farbe, Start-/Enddaten, Zugewiesene, Checklisten, Links, Anhänge, jede Karte darauf (UID, Nummer, Titel und ihre Liste mit Kategorie — null Liste = Backlog — in Board-Reihenfolge, dies ist also der Weg, alle Karten eines Epics aufzulisten und zu sehen, welche zu tun, in Arbeit oder erledigt sind) und verschachtelte Kommentare. Akzeptiert nur die Epic-UID — es gibt keinen project_id-Parameter. Epic-UIDs stammen aus list_epics oder search.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Die eindeutige Kennung des Epics

list_wiki_pathsPro · wikiread-only

Den gesamten Wiki-Baum eines Projekts in Anzeigereihenfolge auflisten — jeden Ordner und jede Seite mit UID, Name, Typ (Seite oder Ordner) und parent_id — damit der Agent die Seiten-UID auflösen kann, die show_wiki_page akzeptiert, und ein parent_id für create_wiki_page auswählen kann. Erfordert einen Pro- oder Test-Arbeitsbereich.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung des Projekts

show_wiki_pagePro · wikiread-only

Eine Wiki-Seite als AgileHero-Markup (AHM) mit ihrer document_version abrufen. Der Inhalt ist AHM, nicht Markdown — Block-IDs, <discussion>-Anker und <image/>/<attachment/>-Referenzen sind Teil des Dokuments; lesen Sie get_ahm_spec vor dem Bearbeiten. Bearbeiten über preview_wiki_page_update und dann update_wiki_page, unter Verwendung der hier zurückgegebenen Block-IDs und document_version. Erfordert einen Pro- oder Test-Arbeitsbereich.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Die eindeutige Kennung des Seitenpfads

get_ahm_specread-only

Die AgileHero-Markup (AHM) v1.0-Spezifikation — das EINZIGE Rich-Text-Format, das AgileHero akzeptiert (Markdown und HTML werden abgelehnt). Lesen Sie dies EINMAL, bevor Sie Rich-Text schreiben oder bearbeiten (Wiki-Seiten, Karten-/Epic-Beschreibungen, Kommentare): Vokabular, Attribute, Escape-Regeln und ein durchgearbeitetes Beispiel. Gleicher Text im Web: https://agilehero.io/docs/mcp/agilehero-markup

create_wiki_pagePro · wiki

Eine Wiki-Seite (optional in einem Ordner) mit AgileHero-Markup (AHM)-Inhalt erstellen. Der Inhalt muss in <agile-hero-markup version="1.0"> eingeschlossen sein — Markdown und HTML werden abgelehnt; lesen Sie zuerst get_ahm_spec. Gibt die UID, URL, document_version und den Inhalt der neuen Seite zurück. Erfordert einen Pro- oder Test-Arbeitsbereich.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung (UID) des Projekts
name	string	ja	Seitentitel
parent_id	string		Optionale Ordner-UID (aus list_wiki_paths)
content	string		Seiteninhalt als AHM; für eine leere Seite weglassen

preview_wiki_page_updatePro · wikiread-only

ERFORDERLICHER erster Schritt jeder Wiki-Seiten-Aktualisierung: validiert die Operationen und gibt die serverberechneten Konsequenzen zurück (hinzugefügte/entfernte/geänderte Blöcke, Dateien, die dauerhaft gelöscht würden, Team-Diskussionen, die ihre Anker verlieren würden, mögliche Markdown-Warnungen) sowie das preview_token, das update_wiki_page benötigt. Es wird nichts geändert. Operationen sind blockadressiert (replace_block / insert_after / delete_block / move_block) mit AHM-Inhalt — lesen Sie zuerst get_ahm_spec und erhalten Sie Block-IDs + document_version aus show_wiki_page. Überprüfen Sie die Konsequenzen vor dem Speichern: Eine aufgeführte Dateilöschung oder Diskussions-Verankerungsaufhebung ist nur akzeptabel, wenn der Benutzer sie angefordert hat. Erfordert einen Pro- oder Test-Arbeitsbereich.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Seitenpfad-UID
document_version	string	ja	Aus show_wiki_page — beweist Aktualität
operations	array of object	ja	In Reihenfolge gegen das sich entwickelnde Dokument angewendet

update_wiki_pagePro · wikidestructive

Eine zuvor in der Vorschau angezeigte Aktualisierung auf eine Wiki-Seite anwenden. Erfordert das preview_token aus preview_wiki_page_update für GENAU diese Operationen und diese document_version — Speichern ohne Vorschau ist konstruktionsbedingt unmöglich. Jedes Speichern erstellt eine Seitenversion, die Menschen in der App zurücksetzen können. Gibt die aktualisierte Seite (AHM + neue document_version) und die angewendeten Konsequenzen zurück. Erfordert einen Pro- oder Test-Arbeitsbereich.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Seitenpfad-UID
document_version	string	ja	Die Version, gegen die die Vorschau erstellt wurde
operations	array of object	ja	Die genauen Operationen, die in der Vorschau angezeigt wurden
preview_token	string	ja	Aus preview_wiki_page_update

preview_description_updateread-only

ERFORDERLICHER erster Schritt jeder Karten- oder Epic-Beschreibungsbearbeitung: validiert die Blockoperationen und gibt die serverberechneten Konsequenzen plus das preview_token zurück, das update_description benötigt. Es wird nichts geändert. Der Inhalt ist AgileHero-Markup (AHM, Beschreibungsoberfläche: keine Tabellen, Farben, Ausrichtung, Diskussionen oder Dateianhänge) — lesen Sie zuerst get_ahm_spec; Block-IDs und document_version stammen aus get_card / get_epic.

Parameter	Typ	Erforderlich	Beschreibung
resource_type	enum: card | epic	ja
id	string	ja	Karten- oder Epic-UID
document_version	string	ja	Aus get_card / get_epic
operations	array of object	ja	In Reihenfolge gegen die sich entwickelnde Beschreibung angewendet

update_descriptiondestructive

Eine zuvor in der Vorschau angezeigte Beschreibungsaktualisierung auf eine Karte oder ein Epic anwenden. Erfordert das preview_token aus preview_description_update für GENAU diese Operationen und diese document_version — Speichern ohne Vorschau ist konstruktionsbedingt unmöglich. Gibt die aktualisierte Beschreibung (AHM + neue document_version) zurück.

Parameter	Typ	Erforderlich	Beschreibung
resource_type	enum: card | epic	ja
id	string	ja	Karten- oder Epic-UID
document_version	string	ja	Die Version, gegen die die Vorschau erstellt wurde
operations	array of object	ja	Die genauen Operationen, die in der Vorschau angezeigt wurden
preview_token	string	ja	Aus preview_description_update

list_whiteboardsPro · whiteboardread-only

Die Whiteboards eines Projekts auflisten (UID, Name, Elementanzahl, URL). Verwenden Sie get_whiteboard, um die Elemente eines Boards zu lesen. Erfordert einen Pro- oder Test-Arbeitsbereich.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung des Projekts

create_whiteboardPro · whiteboard

Ein leeres Whiteboard auf einem Projekt erstellen. Fügen Sie Inhalte mit create_whiteboard_elements hinzu. Erfordert einen Pro- oder Test-Arbeitsbereich.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung des Projekts
name	string	ja	Whiteboard-Name

get_whiteboardPro · whiteboardread-only

Ein Whiteboard als kompakte Textdarstellung lesen: Board-Grenzen plus eine Zeile pro Element — „<type> <uid> bei <x>,<y> Größe <w>x<h> [Farbe] [Eltern <frame-uid>] [verknüpft <card|epic> <uid>] \"text\"", Verbinder als „Verbindung <uid> <from> -> <to>". Element-UIDs von hier sind die Griffe, die jedes Whiteboard-Schreibwerkzeug akzeptiert. Erfordert einen Pro- oder Test-Arbeitsbereich.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Die eindeutige Kennung des Whiteboards

create_whiteboard_elementsPro · whiteboard

Bis zu 100 Whiteboard-Elemente in einem einzigen transaktionalen Aufruf erstellen (alles-oder-nichts, ein Echtzeit-Ereignis). Native Größen, Farben und Textplatzierung werden serverseitig angewendet — normalerweise nur Typ + Text (+ Farbe) angeben. x/y weglassen und Elemente werden automatisch angeordnet (standardmäßig Raster; arrange: row|column|grid, origin_x/origin_y/gap zum Feinabstimmen); x/y für volle Kontrolle angeben. Rahmen enthalten Elemente über parent_id (eine vorhandene Rahmen-UID) oder parent_ref (die Referenz eines Rahmens früher in DIESEM Aufruf). Verbinder binden Elemente per UID (source_id/target_id) oder Batch-Referenz (source_ref/target_ref) — niemals Koordinaten; Anker werden von der UI berechnet. Erfordert einen Pro- oder Test-Arbeitsbereich.

Parameter	Typ	Erforderlich	Beschreibung
whiteboard_id	string	ja	Die eindeutige Kennung des Whiteboards
elements	array of object	ja	In Array-Reihenfolge erstellt — Referenzen lösen nur rückwärts auf
arrange	enum: grid | row | column		Layout für Elemente ohne explizites x/y (Standard grid)
origin_x	number		Automatische Anordnungs-Start-x (Standard 100)
origin_y	number		Automatische Anordnungs-Start-y (Standard 100)
gap	number		Automatischer Anordnungsabstand in px (Standard 20)

create_whiteboard_diagramPro · whiteboard

Ein Diagramm (Flussdiagramm, Prozess, Abhängigkeitsgraph) auf einem Whiteboard aus einem semantischen Graphen zeichnen — Knoten, Kanten, optionale Gruppen, KEINE Koordinaten: Der Server führt ein geschichtetes Layout von oben nach unten mit nativen Größen aus und gibt die erstellten Element-UIDs zurück, die nach Ihren Knoten-IDs verschlüsselt sind. Unterhalb des vorhandenen Board-Inhalts platziert. Transaktional (alles-oder-nichts, ein Echtzeit-Ereignis). Maximal 20 Knoten — größere Flüsse in zwei Diagramme aufteilen. Formen schlicht halten (Rechteck), es sei denn, die Semantik erfordert eine (Raute = Entscheidung, Stadion = Start/Ende, Zylinder = Datenspeicher). Das Ergebnis mit update_whiteboard_elements bearbeiten — das Layout läuft nie wieder. Erfordert einen Pro- oder Test-Arbeitsbereich.

Parameter	Typ	Erforderlich	Beschreibung
whiteboard_id	string	ja	Die eindeutige Kennung des Whiteboards
title	string		Diagrammtitel (Rahmentitel oder eine Überschrift, wenn Gruppen verwendet werden)
nodes	array of object	ja
edges	array of object
groups	array of object
origin_x	number		Optionale obere linke x; standardmäßig unterhalb des vorhandenen Inhalts
origin_y	number		Optionale obere linke y; standardmäßig unterhalb des vorhandenen Inhalts

update_whiteboard_elementsPro · whiteboard

Aktualisiere bis zu 100 Whiteboard-Elemente in einem einzigen Alles-oder-nichts-Aufruf: verschieben (x/y), skalieren, neu stapeln (z_index), Text ändern, neu einfärben, neu zuordnen (parent_id — eine Frame-UID oder "" zum Lösen) sowie Connector-Pfeil/Pfad/Beschriftung. Element-UIDs stammen von get_whiteboard; Elementtypen können nicht geändert werden. Nur angegebene Felder ändern sich — nicht zusammenhängende Eigenschaften bleiben erhalten. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
whiteboard_id	string	ja	Die eindeutige Kennung des Whiteboards
updates	array of object	ja

delete_whiteboard_elementsPro · whiteboarddestruktiv

Lösche bis zu 100 Whiteboard-Elemente in einem einzigen transaktionalen Aufruf. Das Löschen eines Frames oder Mind-Map-Knotens gibt dessen Kinder auf dem Board frei (sie werden NICHT gelöscht — nimm ihre UIDs explizit auf, um auch sie zu löschen). Connectors, die an gelöschten Elementen hängen, werden nicht entfernt und bleiben lose. Element-UIDs stammen von get_whiteboard. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
whiteboard_id	string	ja	Die eindeutige Kennung des Whiteboards
ids	array of string	ja	Zu löschende Element-UIDs

review_whiteboardPro · whiteboardschreibgeschützt

Führe deterministische Qualitätsprüfungen an einem Whiteboard durch: Text, der wahrscheinlich sein Element überläuft, sichtbar überlappende Elemente, Connectors mit ungebundenen oder losen Endpunkten, Farben außerhalb der UI-Palette, Positionen außerhalb des Rasters und Elemente, deren übergeordnetes Element gelöscht wurde. Hinweisgebend — Befunde sind Vorschläge, keine Fehler, und ein Board mit Befunden kann genau das sein, was der Benutzer möchte. Nach dem Zeichnen zur Plausibilitätsprüfung verwenden, höchstens einmal korrigieren und nicht in einer Schleife einem leeren Bericht hinterherjagen. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Die eindeutige Kennung des Whiteboards

convert_whiteboard_elementPro · whiteboard

Wandle ein Whiteboard-Element in ein Backlog-Element um: einen Haftnotiz in eine Karte oder ein Epic oder einen Frame in ein Epic (die Haftnotiz-Kinder des Frames werden zu Karten auf diesem Epic; bereits konvertierte Kinder werden neu zugewiesen, nicht dupliziert). Das Element bleibt auf dem Board, verknüpft mit dem, was daraus wurde — get_whiteboard zeigt die Verknüpfung. Ein Element kann nur einmal konvertiert werden. Der Notiz-/Frame-Text wird zum Titel, sofern du keinen angibst. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Element-UID (eine sticky_note oder ein frame, von get_whiteboard)
to	enum: card | epic	ja	Was erstellt werden soll
title	string		Kartentitel / Epic-Name; standardmäßig der Text des Elements
list_id	string		Nur Karte: Ziel-Listen-UID; für das Backlog weglassen
color	string		Nur Epic: Hex-Farbe; standardmäßig die Farbe des Elements

convert_mind_mapPro · whiteboard

Wandle eine Mind Map mit einer Pro-Knoten-Zuordnung in Backlog-Elemente um: Die Wurzel kann ein neues Epic werden (Rolle "epic") oder an ein bestehendes angehängt werden (Rolle "existing_epic" + target_epic_id); andere Knoten werden zu Karten auf diesem Epic (Rolle "card") oder Projekt-Labels (Rolle "label" — Label-Knoten über einem Kartenknoten im Baum werden auf diese Karte angewendet); Rolle "skip" ignoriert einen Knoten. Übergib die ROOT-Element-UID als id und jeden Knoten, den du konvertieren möchtest, in nodes (nicht aufgeführte Knoten werden ignoriert). Eine Konvertierung pro Knoten: Bereits konvertierte Knoten werden im Voraus abgelehnt — sende sie ohne diese erneut ein. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Die ROOT-Mind-Map-Knoten-UID (von get_whiteboard)
nodes	array of object	ja
target_epic_id	string		Epic-UID, erforderlich mit Rolle "existing_epic" auf der Wurzel

list_retrospectivesPro · retrospectivesschreibgeschützt

Liste die Retrospektiven eines Projekts auf: Retrospektiven des neuen Modells und Health Checks, wo der Workspace sie hat, andernfalls klassische Retrospektiv-Boards. Ein Eintrag des neuen Modells hat uid, name, kind (retro | health_check), status (open | live | closed), date (starts_on; closes_on für einen Health Check), aktuelle Phase, Vorlage, Facilitator-UID, Anzahl der von ihr erstellten Aktionen und url; die Antwort fügt die open_actions_count des Projekts hinzu. Verwende get_retrospective für das vollständige Bild. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung des Projekts

create_retrospectivePro · retrospectives

Erstelle eine Retrospektive: eine Retrospektive des neuen Modells, wo der Workspace sie hat, andernfalls ein klassisches Retrospektiv-Board; die Antwort ist die Retrospektive, wie get_retrospective sie zurückgibt (Spalten mit ihren UIDs), sodass add_retro_items sofort folgen kann. Eine Retrospektive des neuen Modells stammt aus einer Vorlage (Standard went_well), ist sofort für Notizen geöffnet und hat dich als Facilitator; optional: Fokus, Anonymität (Standard: die der Vorlage), participant_ids (eine Retrospektive mit ausgewählten Mitgliedern; weglassen für jedes Projektmitglied mit Schreibzugriff), die check_in- und feedback-Fragenarten sowie Stimmen. Der Facilitator startet sie und führt ihre Phasen in der App aus. Klassische Boards akzeptieren nur name, date und previous_retrospective_id und lehnen die Argumente des neuen Modells ab. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung des Projekts
name	string	ja	Name der Retrospektive
template	enum: went_well | start_stop_continue | four_ls | mad_sad_glad | kalm | daki | starfish | plus_delta | sailboat | rose_thorn_bud | wrap | hot_air_balloon | three_pigs | project_retro | postmortem | kudos_lessons		Vorlagenschlüssel; Standard went_well
starts_on	string		Datum, ISO-8601 (YYYY-MM-DD); standardmäßig heute
starts_at	string		Veralteter Alias von starts_on
focus	string		Worum es in dieser Retrospektive geht, angezeigt unter ihrem Namen
anonymity	enum: anonymous | optional | named		Wer auf Notizen angezeigt wird: anonymous, optional (Autoren können ihren Namen hinzufügen) oder named
participant_ids	array of string		Benutzer-UIDs der Teilnehmer (list_project_users); du bist immer einer davon
check_in	enum: safety | mood | esvp | one_word		Check-in-Frage (Standard safety)
feedback	enum: roti | pulse | one_word		Abschluss-Feedback-Frage (Standard roti)
votes	object		Abstimmungseinstellungen: budget (auto | fixed | unlimited), per_person (1-20), max_per_topic (1-10)
previous_retrospective_id	string		Nur klassische Boards: UID einer früheren Retrospektive, deren Aktionsspalte als „Vergangene Aktionen" angezeigt wird

get_retrospectivePro · retrospectivesschreibgeschützt

Lies eine Retrospektive, wie du sie sehen könntest: eine Retrospektive des neuen Modells oder einen Health Check, wo der Workspace sie hat, andernfalls ein klassisches Retrospektiv-Board. Eine Retrospektive des neuen Modells gibt Setup, Phasen (aktuelle, Timer, Fortschritt), Spalten (mit UIDs) mit Themen (Notizgruppen, mit UIDs), Check-in- und Feedback-Zählungen, deine verbleibenden Stimmen, die Discuss-Warteschlange und geparkte Themen, Vorschläge, Aktionen (die von ihr erstellten plus die offenen des Projekts) und, sobald geschlossen, ihre Zusammenfassung zurück. Der Datenschutz folgt dem Raum: Vor der Enthüllung erhältst du nur deine eigenen Notizen (jede Spalte zählt die aller), Autoren nur bei benannten Notizen, Stimmen-Summen nur, sobald die Stimmen enthüllt sind. Ein Health Check gibt seine Dimensionen und Teilnahme, deine eigenen Bewertungen, während er offen ist, und pro Dimension aggregierte Werte, sobald geschlossen, zurück. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Die Retrospektiven-UID (von list_retrospectives)

add_retro_itemsPro · retrospectives

Füge einer Retrospektive als du selbst Elemente hinzu, mehrere auf einmal: Notizen auf einer Retrospektive des neuen Modells, wo der Workspace sie hat, Karten auf einem klassischen Retrospektiv-Board andernfalls. Jedes Element ist { column, text, recipient_id? }: column ist ein Spaltentitel (Groß-/Kleinschreibung egal) oder eine UID von get_retrospective; text ist bis zu 1000 Zeichen (255 auf klassischen Boards); recipient_id, die Benutzer-UID des bedankten Teammitglieds, ist in einer Kudos-Spalte des neuen Modells erforderlich und wird auf klassischen Boards abgelehnt. Eine Notiz des neuen Modells startet ein eigenes Thema und andere sehen sie, sobald Notizen enthüllt sind; Notizen werden nur aufgenommen, während die Retrospektive für Notizen geöffnet ist oder in der Write-Phase, andernfalls wird der Aufruf mit Code wrong_stage und der aktuellen Phase abgelehnt. TEILWEISER Fehler: Gültige Elemente werden hinzugefügt, ungültige werden pro Index gemeldet — prüfe das „failed"-Array. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
retrospective_id	string	ja	Die Retrospektiven-UID
items	array of object	ja

move_retro_itemPro · retrospectives

Verschiebe ein Retrospektiven-Element: gruppiere eine Notiz auf einer Retrospektive des neuen Modells neu, wo der Workspace sie hat, verschiebe eine Karte in eine andere Spalte eines klassischen Retrospektiv-Boards andernfalls. Neues Modell, nur Group-Phase: topic_id platziert die Notiz in diesem Thema (Notizgruppe); column (Titel oder UID) macht sie dort zu einem eigenen Thema, an Position unter den Themen der Spalte (weglassen für letzte). Übergib expected_updated_at, die topic updated_at der Notiz von get_retrospective, um mit Code stale abgelehnt zu werden, wenn jemand sie in der Zwischenzeit neu gruppiert hat. Außerhalb von Group wird der Aufruf mit Code wrong_stage und der aktuellen Phase abgelehnt; Kudos und andere Notizen vermischen sich nie. Klassische Boards akzeptieren nur column und position (position weggelassen = oben). Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Die Notiz-UID (klassische Boards: die Element-UID) von get_retrospective
topic_id	string		Ziel-Themen-UID; column weglassen
column	string		Titel oder UID der Zielspalte
position	integer		Index in der Zielspalte (0 = erste)
expected_updated_at	string		Die topic updated_at der Notiz, wie zuletzt gelesen (Konfliktprüfung)

list_project_usersschreibgeschützt

Liste die Mitglieder eines Projekts auf — jedes Workspace-Mitglied für ein Standardprojekt; den Ersteller, die Workspace-Besitzer und -Administratoren sowie alle, die für ein privates explizit hinzugefügt wurden — damit der Agent Beauftragten-UIDs auflösen kann, statt Namen zu raten. Gibt die UID, den vollständigen Namen, die E-Mail und die Workspace-Rolle (owner, admin, member oder observer) jedes Mitglieds zurück. Diese UIDs sind das, was assigned_to bei create_card, update_card, create_epic, update_epic und create_roadmap_slot akzeptiert.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung des Projekts

list_board_listsschreibgeschützt

Liste die Listen des Kanban-Boards eines Projekts auf, damit der Agent ein gültiges move_card-Ziel auflösen kann. Gibt jede aktive Liste in Anzeigereihenfolge mit ihrer UID (als move_card-Ziel verwendbar) und ihrem Anzeigenamen zurück. Das Backlog ist als auswählbarer Eintrag mit einer leeren String-ID enthalten.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung (UID) des Projekts

list_epicsschreibgeschützt

Liste die Epics eines Projekts auf, damit der Agent Epic-UIDs für get_epic und Kartenzuweisung auflösen kann. Gibt jedes Epic in Anzeigereihenfolge (Position aufsteigend) mit seiner UID, Nummer, Name, Beschreibung (Markdown), Farbe, Start-/Enddaten und Kartenanzahl zurück.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung (UID) des Projekts
updated_since	string		Nur Epics, deren Datensatz sich an oder nach diesem ISO-8601-Datum oder -Datumszeitpunkt geändert hat. Hinweis: Sammlungsbearbeitungen (Checklisten, Links) können die Änderungszeit eines Epics möglicherweise nicht erhöhen; Namens-/Datums-/Beschreibungsbearbeitungen tun dies immer.

list_labelsschreibgeschützt

Liste die Labels eines Projekts auf, damit der Agent die vorhandene Taxonomie wiederverwenden kann, statt bei Karten-Schreibvorgängen Fast-Duplikate zu erstellen. Gibt jedes Label in Anzeigereihenfolge (Position aufsteigend) mit seiner UID, Name und Position zurück.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung (uid) des Projekts

list_cardsnur lesen

Listet die Karten einer Kanban-Liste oder des Backlogs des Projekts auf, wenn list_id weggelassen oder leer ist, in der Anzeigereihenfolge des Boards (zuerst oben in der Spalte, d. h. absteigende Platzierungsposition – dieselbe Reihenfolge, die die Produkt-UI zeigt). Filter kombinieren mit UND: epic_id, label_id, assigned_user_id und reporter_id akzeptieren uids (eine unbekannte uid passt auf nichts); due_date behält Karten, die am oder vor dem angegebenen Datum fällig sind. Gibt aktionsfähige Kartenzusammenfassungen zurück (uid, Titel, Liste + Position, Epic, Labels, Zugewiesene, Reporter, Fälligkeitsdatum), bereit für get_card / move_card / update_card, paginiert mit limit (Standard 50, max. 100) und offset; total_count ist die vollständige gefilterte Anzahl.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung (uid) des Projekts
list_id	string		Listen-uid zum Lesen; weglassen oder leeren String für das Backlog angeben
epic_id	string		Nur Karten in diesem Epic (Epic-uid) innerhalb der gewählten Liste oder des Backlogs; um jede Karte eines Epics über alle Listen aufzulisten, verwenden Sie get_epic
label_id	string		Nur Karten mit diesem Label (Label-uid)
assigned_user_id	string		Nur Karten, die diesem Benutzer zugewiesen sind (Benutzer-uid)
reporter_id	string		Nur Karten, die von diesem Benutzer gemeldet (erstellt) wurden (Benutzer-uid)
due_date	string		Nur Karten, die am oder vor diesem Datum fällig sind (ISO-8601, z. B. 2026-06-10)
updated_since	string		Nur Karten, deren Datensatz sich an oder nach diesem ISO-8601-Datum oder -Datumszeitpunkt geändert hat – der Filter „Was hat sich geändert, seit ich zuletzt gelaufen bin“. Hinweis: Änderungen an angehängten Sammlungen (Labels, Checklisten, Links) erhöhen möglicherweise nicht die Änderungszeit einer Karte; Titel-/Beschreibungs-/Skalar-Änderungen tun dies immer.
limit	integer		Seitengröße, 1-100 (Standard 50)
offset	integer		Anzahl der zu überspringenden Karten (Standard 0)

search_cardsnur lesen

Titel-Teilstring-Kartensuche innerhalb eines Projekts (Kanban-Board und Backlog), die exakt der Live-Kartensuche im Projekt des Produkts entspricht (Datenbank-Groß-/Kleinschreibung-unabhängiger Teilstring nur auf dem Kartentitel – Beschreibungen und Kommentare werden nicht durchsucht; verwenden Sie das Suchtool für Volltextsuche über alle Inhaltstypen), sortiert nach neuestem Erstellungsdatum zuerst. Gibt aktionsfähige Kartenzusammenfassungen zurück (uid, Titel, Listenplatzierung + Position, Epic, Labels, Zugewiesene, Reporter, Fälligkeitsdatum); eine Abfrage ohne Treffer gibt ein leeres Karten-Array zurück, keinen Fehler. Paginieren Sie mit limit (Standard 50, max. 100) und offset; total_count ist die vollständige Trefferanzahl.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung (uid) des Projekts
query	string	ja	Text, der mit Kartentiteln abgeglichen werden soll (Groß-/Kleinschreibung-unabhängiger Teilstring)
limit	integer		Seitengröße, 1-100 (Standard 50)
offset	integer		Anzahl der zu überspringenden übereinstimmenden Karten (Standard 0)

list_attention_cardsPro · Metrikennur lesen

Listet die Karten auf, die auf dem Kanban-Board eines Projekts Aufmerksamkeit benötigen – dieselben Listen wie die Metrikseiten des Produkts. Arten: stuck (in einer Spalte sitzend, nicht Backlog/Erledigt, seit über 7 Tagen unverändert; am längsten feststeckende zuerst), blocking (unerledigte Karten, von denen andere Karten blockiert werden), overdue (innerhalb der nächsten 7 Tage fällig oder bereits überfällig; bald fälligste zuerst). kind wählt eine Liste oder 'all' (Standard). Optional nach einer Zugewiesenen-uid oder dem Literal 'unassigned' filtern. Jeder angeforderte Abschnitt gibt Kartenzusammenfassungen zurück, bereit für get_card / move_card / update_card, begrenzt auf limit mit der vollständigen total_count. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung (uid) des Projekts
kind	enum: stuck | blocking | overdue | all		Welche Aufmerksamkeitsliste zurückgegeben werden soll (Standard 'all' = jede Liste als eigener Abschnitt)
assignee_id	string		Nur Karten, die dieser Benutzer-uid zugewiesen sind, oder 'unassigned' für Karten ohne Zugewiesenen
limit	integer		Max. Karten pro Abschnitt, 1-100 (Standard 50)

get_metrics_summaryPro · Metrikennur lesen

Ein-Aufruf-Zählungen der Karten, die auf dem Kanban-Board eines Projekts Aufmerksamkeit benötigen: overdue_cards_count, blocking_cards_count und stuck_cards_count – dieselben Definitionen wie list_attention_cards, das die Karten hinter jeder Zählung zurückgibt. Günstig; rufen Sie dies zuerst auf, um zu entscheiden, ob ein tieferer Blick sich lohnt. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung (uid) des Projekts

list_roadmap_slotsPro · Roadmapnur lesen

Listet die Roadmap-Slots eines Projekts auf, die ein Datumsfenster überlappen (Standard: dieser Monat bis fünf Monate voraus). Ein Slot plant ein Epic zwischen zwei Daten und kann Zugewiesene tragen; ein Epic kann mehrere Slots halten, einschließlich Überlappungen – das ist beabsichtigt. Gibt höchstens 200 Slots zurück – verengen Sie das Fenster, wenn das Limit erreicht wird. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung des Projekts
start_date	string		Fensterstart, ISO-8601 (JJJJ-MM-TT); Standard: Anfang dieses Monats
end_date	string		Fensterende, ISO-8601; Standard: start_date + 6 Monate

create_roadmap_slotPro · Roadmap

Planen Sie ein Epic auf der Projekt-Roadmap: ein Slot von start_date bis end_date, optional mit Zugewiesenen. Ein Epic kann mehrere Slots halten und Überlappungen sind absichtlich erlaubt – prüfen Sie zuerst list_roadmap_slots, wenn Sie einen bestehenden Slot erweitern möchten, anstatt einen hinzuzufügen. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Die eindeutige Kennung des Projekts
epic_id	string	ja	Epic-uid (aus list_epics); muss zu diesem Projekt gehören
start_date	string	ja	ISO-8601 (JJJJ-MM-TT)
end_date	string	ja	ISO-8601; derselbe Tag wie start_date ist erlaubt
assigned_to	Array von string		Benutzer-uids zum Zuweisen (Projektmitglieder – siehe list_project_users)

update_roadmap_slotPro · Roadmap

Aktualisieren Sie einen Roadmap-Slot: neu planen oder skalieren (start_date/end_date), zu einem anderen Epic desselben Projekts verschieben (epic_id) oder dessen Zugewiesene festlegen. Nur gelieferte Felder ändern sich, AUSSER assigned_to, das den vollständigen Zugewiesenen-Satz ERSETZT – lesen Sie zuerst den Slot und senden Sie alle, die bleiben sollen. Slot-uids stammen aus list_roadmap_slots. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Die Roadmap-Slot-uid
epic_id	string		Neue Epic-uid (gleiches Projekt)
start_date	string		ISO-8601 (JJJJ-MM-TT)
end_date	string		ISO-8601
assigned_to	Array von string		ERSETZT alle Zugewiesenen (Benutzer-uids, Projektmitglieder); [] löscht

delete_roadmap_slotPro · Roadmapzerstörerisch

Löscht einen Roadmap-Slot DAUERHAFT (und seine Zugewiesenen-Verknüpfungen). Dies kann nicht rückgängig gemacht werden – es gibt keinen Papierkorb für Roadmap-Slots. Das Epic selbst wird nicht berührt; zum Neuplanen bevorzugen Sie update_roadmap_slot. Erfordert einen Pro- oder Test-Workspace.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Die Roadmap-Slot-uid (aus list_roadmap_slots)

create_label

Erstellen Sie ein neues Label auf einem Projekt nach Namen. Wenn ein Label mit demselben Namen bereits existiert (Groß-/Kleinschreibung-unabhängig), wird das vorhandene Label unverändert zurückgegeben, anstatt ein Fast-Duplikat zu erstellen. Das neue Label wird am Ende der Anzeigereihenfolge angehängt.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Projekt-uid, zu dem das Label gehört
name	string	ja

create_card

Erstellen Sie eine Karte auf dem Kanban-Board eines Projekts. Nur project_id und title sind erforderlich. Lassen Sie list_id weg, um die Karte ins Backlog zu legen; lassen Sie position weg, um ans Ende der Warteschlange zu kommen (move_card dokumentiert den Positionsvertrag). description ist AgileHero-Markup – niemals Markdown oder HTML; lesen Sie zuerst get_ahm_spec. epic_id und Zugewiesenen-uids müssen bereits existieren (list_epics, list_project_users), während Labelnamen, die noch nicht existieren, auf dem Projekt erstellt werden. estimation ist Fibonacci-Komplexität (0/1/2/3/5/8/13), keine Zeitschätzung. Checklisten, Links, Anhänge und Kartenbeziehungen können alle in demselben Aufruf geliefert werden.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Projekt-uid, zu dem die Karte gehört (die Karte wird auf dem Kanban-Board des Projekts erstellt)
list_id	string		Listen-uid; weglassen, um ins Backlog zu legen
position	integer
type	enum: story | bug | chore | research
title	string	ja
description	string		AgileHero-Markup (AHM) – niemals Markdown oder HTML; lesen Sie zuerst get_ahm_spec. Beschreibungsoberfläche: keine Tabellen, Farben, Ausrichtung oder Diskussionen.
epic_id	string		Epic-uid; muss bereits auf dem Projekt existieren
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Komplexitätsschätzung in Story Points (Fibonacci-Skala), keine Zeitschätzung
due_date	string		ISO-8601-Datum
assigned_to	Array von string		Zugewiesene Benutzer-uids, auffindbar über list_project_users
labels	Array von string		Labelnamen; unbekannte Namen werden auf dem Projekt erstellt
checklists	Array von Objekt		Jedes { name, items: [{ description, checked }] }; Elemente behalten die gelieferte Reihenfolge
cards_relations	Array von Objekt		Jedes { type, target_card_id (eine Karten-uid auf demselben Board) }
links	Array von Objekt		Jedes { url, description }
attachments	Array von Objekt		Jedes { url, name }; die Datei wird von der url abgerufen

update_cardzerstörerisch

Aktualisieren Sie eine vorhandene Karte nach ihrer uid. Für Sammlungen bevorzugen Sie die add_*/remove_*-Deltafelder (sichere inkrementelle Bearbeitungen: add_labels, remove_assignees, add_checklist_items, check_items, …); die einfachen Sammlungsfelder (labels, assigned_to, checklists, cards_relations, links, attachments) ERSETZEN den vorherigen Zustand zerstörerisch und können nicht mit ihren Deltas kombiniert werden. Verwenden Sie move_card, um Liste oder Position zu ändern, und preview_description_update / update_description, um die Beschreibung zu bearbeiten.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Karten-UID
type	enum: story | bug | chore | research
title	string
epic_id	string
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Komplexitätsschätzung in Story Points (Fibonacci-Skala), keine Zeitschätzung
due_date	string		ISO-8601-Datum
assigned_to	array of string		UIDs der zugewiesenen Benutzer, ermittelbar über list_project_users; ersetzt die Zugewiesenen der Karte
labels	array of string		Labelnamen; unbekannte Namen werden im Projekt erstellt; ersetzt die Labels der Karte
checklists	array of object		Jedes { name, items: [{ description, checked }] }; Elemente behalten die angegebene Reihenfolge; ersetzt die Checklisten der Karte
cards_relations	array of object		Jedes { type, target_card_id (eine Karten-UID auf demselben Board) }; ersetzt die Beziehungen der Karte
links	array of object		Jedes { url, description }; ersetzt die Links der Karte
attachments	array of object		Jedes { url, name }; die Datei wird von der URL abgerufen; ersetzt die Anhänge der Karte
add_labels	array of string		Labels nach Namen hinzufügen (unbekannte Namen werden erstellt); behält vorhandene Labels
remove_labels	array of string		Labels nach Namen entfernen (Groß-/Kleinschreibung wird ignoriert); nicht vorhandene Namen sind ohne Wirkung
add_assignees	array of string		Zugewiesene nach Benutzer-UID hinzufügen; behält vorhandene Zugewiesene
remove_assignees	array of string		Zugewiesene nach Benutzer-UID entfernen; nicht vorhandene UIDs sind ohne Wirkung
add_checklist_items	array of object		Elemente anhängen: jedes { checklist, description, checked? } — die benannte Checkliste wird erstellt, falls sie nicht existiert
check_items	array of object		Elemente als erledigt markieren, abgeglichen nach exakter Beschreibung innerhalb der benannten Checkliste
uncheck_items	array of object		Elemente als nicht erledigt markieren (gleicher Abgleich wie check_items)
remove_checklist_items	array of object		Elemente löschen; nicht vorhandene Elemente sind ohne Wirkung
add_relations	array of object		Beziehungen hinzufügen; behält vorhandene Beziehungen
remove_relations	array of object		Passende Beziehungen entfernen; nicht vorhandene sind ohne Wirkung
add_links	array of object		Links hinzufügen: jedes { url, description? }; behält vorhandene Links
remove_links	array of string		Links nach exakter URL entfernen; nicht vorhandene URLs sind ohne Wirkung

delete_carddestructive

Löscht eine Karte weich anhand ihrer UID: Sie verlässt das Board und alle Auflistungen, ihre Beziehungen zu anderen Karten werden entfernt, jede Schätzsitzung zu ihr wird deaktiviert und mit ihr verknüpfte Whiteboard-Elemente werden entkoppelt. Das Epic, zu dem sie gehörte, wird nicht gelöscht. Über MCP gibt es kein Wiederherstellen.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Karten-UID

move_card

Verschiebt eine Karte in eine andere Liste (oder ändert ihre Position innerhalb derselben Liste). Nur Karten auf einem Kanban-Board können verschoben werden; Karten auf Retrospektiv-Boards werden abgelehnt. Übergeben Sie eine leere Zeichenfolge für list_id, um die Karte in den Kanban-Backlog zu verschieben. Eine Liste wird von oben nach unten ab ihrer höchsten Position angezeigt, daher ist Position 0 der UNTERSTE Punkt der Liste. Lassen Sie position weg, um sich in Backlog sowie in to_do- und in_progress-Listen ans Ende der Warteschlange (unten, Position 0) zu setzen, oder an den Anfang einer done-Liste.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Karten-UID
list_id	string	ja	UID der Zielliste; leere Zeichenfolge verschiebt in den Backlog (nur Kanban)
position	integer		Platzierung innerhalb des Ziels: 0 ist unten und die höchste Position ist oben. Muss zwischen 0 und der Anzahl der bereits im Ziel befindlichen anderen Karten liegen. Weglassen, um sich in Backlog sowie in to_do- und in_progress-Listen ans Ende der Warteschlange (Position 0) zu setzen, oder an den Anfang einer done-Liste.

create_epic

Erstellt ein Epic in einem Projekt. Nur project_id und name sind erforderlich. description ist AgileHero Markup — niemals Markdown oder HTML; lesen Sie zuerst get_ahm_spec. Zugewiesene Benutzer-UIDs stammen aus list_project_users. Checklisten, Links und Anhänge können im selben Aufruf angegeben werden. Gibt die neue Epic-UID zurück — was create_card / update_card als epic_id akzeptieren und was create_roadmap_slot einplant.

Parameter	Typ	Erforderlich	Beschreibung
project_id	string	ja	Projekt-UID, zu dem das Epic gehört
name	string	ja
description	string		AgileHero Markup (AHM) — niemals Markdown oder HTML; lesen Sie zuerst get_ahm_spec. Beschreibungsoberfläche: keine Tabellen, Farben, Ausrichtung oder Diskussionen.
color	string		Hex-Farbe wie #0060F0
start_date	string		ISO-8601-Datum
end_date	string		ISO-8601-Datum
assigned_to	array of string		UIDs der zugewiesenen Benutzer, ermittelbar über list_project_users
checklists	array of object		Jedes { name, items: [{ description, checked }] }; Elemente behalten die angegebene Reihenfolge
links	array of object		Jedes { url, description }
attachments	array of object		Jedes { url, name }; die Datei wird von der URL abgerufen

update_epicdestructive

Aktualisiert ein vorhandenes Epic anhand seiner UID; nur angegebene Felder werden geändert. Für Sammlungen bevorzugen Sie die add_*/remove_*-Deltfelder (sichere inkrementelle Bearbeitung); die einfachen Sammlungsfelder (assigned_to, checklists, links, attachments) ERSETZEN den vorherigen Zustand destruktiv und können nicht mit ihren Deltas kombiniert werden. Verwenden Sie preview_description_update / update_description, um die Beschreibung zu bearbeiten.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Epic-UID
name	string
color	string		Hex-Farbe wie #0060F0
start_date	string		ISO-8601-Datum
end_date	string		ISO-8601-Datum
assigned_to	array of string		UIDs der zugewiesenen Benutzer, ermittelbar über list_project_users; ersetzt die Zugewiesenen des Epics
checklists	array of object		Jedes { name, items: [{ description, checked }] }; ersetzt die Checklisten des Epics
links	array of object		Jedes { url, description }; ersetzt die Links des Epics
attachments	array of object		Jedes { url, name }; die Datei wird von der URL abgerufen; ersetzt die Anhänge des Epics
add_assignees	array of string		Zugewiesene nach Benutzer-UID hinzufügen; behält vorhandene Zugewiesene
remove_assignees	array of string		Zugewiesene nach Benutzer-UID entfernen; nicht vorhandene UIDs sind ohne Wirkung
add_checklist_items	array of object		Elemente anhängen: jedes { checklist, description, checked? } — die benannte Checkliste wird erstellt, falls sie nicht existiert
check_items	array of object		Elemente als erledigt markieren, abgeglichen nach exakter Beschreibung innerhalb der benannten Checkliste
uncheck_items	array of object		Elemente als nicht erledigt markieren (gleicher Abgleich wie check_items)
remove_checklist_items	array of object		Elemente löschen; nicht vorhandene Elemente sind ohne Wirkung
add_links	array of object		Links hinzufügen: jedes { url, description? }; behält vorhandene Links
remove_links	array of string		Links nach exakter URL entfernen; nicht vorhandene URLs sind ohne Wirkung

delete_epicdestructive

Löscht ein Epic weich anhand seiner UID. Seine Karten werden NICHT gelöscht — sie bleiben auf dem Board, vom Epic entkoppelt. Die Roadmap-Slots des Epics werden DAUERHAFT gelöscht (ein Slot plant ein Epic ein, daher ist er ohne eines bedeutungslos), und mit dem Epic verknüpfte Whiteboard-Elemente werden entkoppelt.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Epic-UID

create_comment

Fügt einer Karte oder einem Epic einen Kommentar hinzu. Geben Sie genau eines von card_id oder epic_id an. Der Inhalt ist AgileHero Markup (AHM, Kommentaroberfläche: keine Tabellen, Medien, Farben, Ausrichtung oder Diskussionen) — niemals Markdown oder HTML; lesen Sie zuerst get_ahm_spec. Der Kommentar wird dem angemeldeten Benutzer zugeschrieben, als den dieser Client agiert, und erscheint in nachfolgenden get_card / get_epic-Antworten. Kommentare können über MCP nicht bearbeitet werden; delete_comment entfernt Ihre eigenen (korrigieren Sie Fehler durch Löschen + erneutes Posten). Übergeben Sie parent_comment_id, um auf einen vorhandenen Kommentar zu antworten. Threads sind eine Ebene tief: Das Antworten auf eine Antwort hängt den neuen Kommentar stattdessen an die Thread-Wurzel dieser Antwort an, versuchen Sie also nicht, Antworten zu verschachteln. Das Elternteil muss ein Kommentar zur selben Karte oder zum selben Epic sein — eine UID von anderswo wird abgelehnt.

Parameter	Typ	Erforderlich	Beschreibung
card_id	string		Karten-UID zum Kommentieren (gegenseitig ausschließend mit epic_id)
epic_id	string		Epic-UID zum Kommentieren (gegenseitig ausschließend mit card_id)
content	string	ja	Kommentartext als AgileHero Markup (AHM)
parent_comment_id	string		Optionale UID eines Kommentars zur SELBEN Karte oder zum SELBEN Epic, auf den geantwortet werden soll. Weglassen für einen Top-Level-Kommentar. Das Antworten auf eine Antwort normalisiert zur Thread-Wurzel dieser Antwort (Threads sind eine Ebene tief).

delete_commentdestructive

Löscht einen Kommentar, den SIE gepostet haben (Kommentare werden dem angemeldeten Benutzer zugeschrieben, als den dieser Client agiert — Kommentare anderer Personen können nicht gelöscht werden). Das Korrekturmuster ist Löschen + Posten eines korrigierten Kommentars mit create_comment. Ein gelöschter Kommentar mit Antworten bleibt als Grabstein in seinem Thread sichtbar. Kommentar-UIDs stammen aus get_card / get_epic.

Parameter	Typ	Erforderlich	Beschreibung
id	string	ja	Kommentar-UID