AgileHero

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

AgileHero est livré avec un serveur MCP intégré : ajoutez une URL à n'importe quel assistant IA compatible MCP, connectez-vous avec votre compte AgileHero, et il travaille sur vos projets avec exactement vos permissions — 49 outils couvrant les tableaux, le backlog, les epics, le wiki, les whiteboards, les rétrospectives et la feuille de route. Cette référence est générée à partir du serveur lui-même, elle est donc toujours à jour.

Vous débutez ? Commencez par la vue d'ensemble des agents IA, ou passez directement à la connexion de votre client ci-dessous. Le texte enrichi partout sur ce serveur utilise le AgileHero Markup (AHM) — un dialecte XML strict et validé, conçu pour que les agents ne corrompent jamais le contenu humain. Vous écrivez un script au lieu de connecter un assistant ? La référence de l'API REST utilise la même connexion OAuth.

Connectez votre client IA

Se connecter signifie deux choses : ajoutez l'URL du point de terminaison à votre client, puis connectez-vous avec votre compte AgileHero lorsque le client le demande. Il n'y a aucune clé à créer ou à coller. Une fois connecté, le client agit comme vous, avec exactement vos permissions ; chaque client connecté est listé sous Paramètres → Clients IA dans l'application, où vous pouvez le révoquer à tout moment. Les observateurs ne peuvent pas utiliser le serveur MCP : un espace de travail où vous êtes observateur n'est pas listé, et tout ce qu'il contient est lu comme introuvable.

Point de terminaison

https://mcp.agilehero.io/mcp

Transport

Streamable HTTP (POST)

Connexion

Votre client IA ouvre une fenêtre de navigateur ; approuvez une fois, révoquez à tout moment dans Paramètres → Clients IA.

Claude Code

Exécutez une fois dans un terminal ; Claude Code stocke le serveur dans votre configuration au niveau utilisateur et se connecte via votre navigateur.

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

• Tous les indicateurs doivent précéder le nom du serveur.
• Ensuite, exécutez /mcp dans une session Claude Code et choisissez Authenticate (ou exécutez claude mcp login agilehero) et approuvez la connexion dans votre navigateur.

Vérification : Exécutez claude mcp list — agilehero doit apparaître comme connecté. S'il affiche « needs authentication », exécutez claude mcp login agilehero.

Documentation Claude Code · vérifiée contre la documentation du fournisseur le 2026-09-15

VS Code (GitHub Copilot)

Ajoutez à .vscode/mcp.json dans un espace de travail, ou exécutez « MCP: Open User Configuration » pour tous les espaces de travail. Une fenêtre de navigateur s'ouvre pour la connexion la première fois que le serveur démarre.

.vscode/mcp.json

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

• « type » : « http » est requis — sans cela, VS Code traite l'URL comme une commande à exécuter.

Vérification : Exécutez « MCP: List Servers », démarrez agilehero, terminez la connexion dans le navigateur et vérifiez que ses outils apparaissent dans la vue Chat.

Documentation VS Code (GitHub Copilot) · vérifiée contre la documentation du fournisseur le 2026-09-15

Codex

Ajoutez depuis le terminal, puis connectez-vous — la configuration est partagée par le CLI Codex, l'extension IDE et l'application de bureau ChatGPT.

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

• Codex ne démarre pas la connexion tout seul — exécutez codex mcp login agilehero après avoir ajouté le serveur.

Vérification : Exécutez codex mcp list — agilehero doit apparaître comme authentifié ; puis demandez à Codex de lister vos projets AgileHero.

Documentation Codex · vérifiée contre la documentation du fournisseur le 2026-09-15

Zed

Ajoutez à settings.json, ou utilisez Paramètres → IA → Serveurs MCP → Ajouter un serveur distant ; Zed vous invite à vous connecter.

~/.config/zed/settings.json

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

• Laissez les en-têtes de côté — Zed ne démarre la connexion que lorsqu'aucun en-tête Authorization n'est configuré.

Vérification : Redémarrez Zed, approuvez la connexion dans votre navigateur lorsqu'on vous le demande, et demandez-lui de lister vos projets AgileHero — le premier appel réussi confirme la connexion.

Documentation Zed · vérifiée contre la documentation du fournisseur le 2026-09-15

GitHub Copilot CLI

Ajoutez à ~/.copilot/mcp-config.json, ou .mcp.json dans un dépôt.

~/.copilot/mcp-config.json

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

• Nécessite GitHub Copilot CLI 1.0.83 ou plus récent (prise en charge du document de métadonnées d'ID client).
• Copilot CLI ouvre la connexion lorsque le serveur la demande pour la première fois ; vous pouvez aussi exécuter /mcp auth agilehero dans une session.

Vérification : Exécutez /mcp dans Copilot CLI — agilehero doit être listé comme connecté avec ses outils.

Documentation GitHub Copilot CLI · vérifiée contre la documentation du fournisseur le 2026-09-15

Claude (web, bureau, Cowork)

Ajoutez AgileHero comme connecteur personnalisé et connectez-vous ; le connecteur est disponible dans Claude sur le web, Claude Desktop, Cowork et les applications mobiles.

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

• Le connecteur apparaît également dans Claude Code lorsqu'il est connecté avec le même compte Claude.
• Plan gratuit : un connecteur personnalisé. Team et Enterprise : un propriétaire ajoute le connecteur, et chaque membre se connecte avec son propre compte AgileHero.

Vérification : Démarrez une nouvelle conversation — AgileHero est listé sous les connecteurs, et demander à Claude de lister vos projets AgileHero fonctionne.

Documentation Claude (web, bureau, Cowork) · vérifiée contre la documentation du fournisseur le 2026-09-15

ChatGPT

Créez un connecteur en mode Développeur et connectez-vous avec OAuth.

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

• Disponible sur Plus, Pro, Business, Enterprise et Edu avec le mode Développeur activé ; dans un espace de travail, un administrateur ou un propriétaire publie le connecteur pour les membres.

Vérification : Ouvrez une nouvelle conversation avec le connecteur AgileHero activé et demandez à ChatGPT de lister vos projets AgileHero.

Documentation ChatGPT · vérifiée contre la documentation du fournisseur le 2026-09-15

Autre client

Tout client MCP prenant en charge OAuth avec des documents de métadonnées d'ID client : ajoutez le point de terminaison comme serveur distant (Streamable HTTP) et approuvez la connexion dans votre navigateur.

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

• Les clients qui ne prennent en charge que les jetons statiques ou les en-têtes ne peuvent pas se connecter — AgileHero utilise uniquement la connexion OAuth.

Vérification : Redémarrez le client, approuvez la connexion dans votre navigateur lorsqu'on vous le demande, et demandez-lui de lister vos projets AgileHero — le premier appel réussi confirme la connexion.

Documentation autre client · vérifiée contre la documentation du fournisseur le 2026-09-15

Pas encore pris en charge

Ces clients ne peuvent pas encore se connecter à AgileHero. La plupart d'entre eux ne prennent pas en charge les documents de métadonnées d'ID client, la méthode d'enregistrement de client OAuth qu'AgileHero utilise (la recommandation MCP actuelle) ; nous revérifions régulièrement la documentation du fournisseur et faisons passer un client dès qu'il est éligible.

CursorPas encore

Cursor ne prend pas encore en charge les documents de métadonnées d'ID client (sa connexion OAuth nécessite l'enregistrement dynamique de client ou un client pré-enregistré), il ne peut donc pas se connecter à AgileHero pour l'instant.

Documentation Cursor · vérifiée contre la documentation du fournisseur le 2026-09-15

OpenCodePas encore

OpenCode ne prend pas encore en charge les documents de métadonnées d'ID client (sa connexion OAuth nécessite l'enregistrement dynamique de client ou un client pré-enregistré), il ne peut donc pas se connecter à AgileHero pour l'instant.

Documentation OpenCode · vérifiée contre la documentation du fournisseur le 2026-09-15

Gemini CLIPas encore

Gemini CLI ne prend pas encore en charge les documents de métadonnées d'ID client (sa connexion OAuth nécessite l'enregistrement dynamique de client ou un client pré-enregistré), il ne peut donc pas se connecter à AgileHero pour l'instant.

Documentation Gemini CLI · vérifiée contre la documentation du fournisseur le 2026-09-15

ClinePas encore

Cline ne prend pas encore en charge les documents de métadonnées d'ID client (sa connexion OAuth nécessite l'enregistrement dynamique de client ou un client pré-enregistré), il ne peut donc pas se connecter à AgileHero pour l'instant.

Documentation Cline · vérifiée contre la documentation du fournisseur le 2026-09-15

Google AntigravityPas encore

Google Antigravity ne prend pas encore en charge les documents de métadonnées d'ID client (sa connexion OAuth nécessite l'enregistrement dynamique de client ou un client pré-enregistré), il ne peut donc pas se connecter à AgileHero pour l'instant.

Documentation Google Antigravity · vérifiée contre la documentation du fournisseur le 2026-09-15

AmpPas encore

Amp ne prend pas encore en charge les documents de métadonnées d'ID client (sa connexion OAuth nécessite l'enregistrement dynamique de client ou un client pré-enregistré), il ne peut donc pas se connecter à AgileHero pour l'instant.

Documentation Amp · vérifiée contre la documentation du fournisseur le 2026-09-15

Raycast AIPas encore

Raycast AI ne prend pas encore en charge les documents de métadonnées d'ID client (sa connexion OAuth nécessite l'enregistrement dynamique de client ou un client pré-enregistré), il ne peut donc pas se connecter à AgileHero pour l'instant.

Documentation Raycast AI · vérifiée contre la documentation du fournisseur le 2026-09-15

KiroPas encore

Kiro se connecte avec une URL de document de métadonnées d'ID client que vous fournissez, et AgileHero n'héberge pas encore de document de métadonnées d'ID client pour lui.

Documentation Kiro · vérifiée contre la documentation du fournisseur le 2026-09-15

WarpPas encore

Warp n'a pas encore de connexion OAuth pour les serveurs ajoutés par l'utilisateur, il ne peut donc pas se connecter à AgileHero pour l'instant.

Documentation Warp · vérifiée contre la documentation du fournisseur le 2026-09-15

JetBrains AI AssistantPas encore

JetBrains AI Assistant n'a pas de connexion OAuth pour les serveurs distants, et le pont mcp-remote nécessiterait un document client hébergé — AgileHero n'héberge pas encore de document de métadonnées d'ID client pour lui.

Documentation JetBrains AI Assistant · vérifiée contre la documentation du fournisseur le 2026-09-15

ContinuePas encore

Continue n'a pas de connexion OAuth pour les serveurs Streamable HTTP, et le pont mcp-remote nécessiterait un document client hébergé — AgileHero n'héberge pas encore de document de métadonnées d'ID client pour lui.

Documentation Continue · vérifiée contre la documentation du fournisseur le 2026-09-15

Instructions du serveur

Chaque client MCP reçoit ces conventions au moment de l'initialisation :

Serveur MCP AgileHero.

Chaque paramètre id et chaque id dans une réponse est un uid court — utilisez toujours les uids renvoyés par les outils list/get/search, n'en inventez jamais. La plupart des outils nécessitent un uid de projet — appelez list_projects d'abord pour découvrir les espaces de travail et les projets. Préférez search (texte intégral, tous les types de contenu) à search_cards (sous-chaîne de titre, un projet).

Sur les outils de mise à jour, préférez les champs delta add_*/remove_* pour les collections (incrémentaux, sûrs) ; les champs de collection simples (assigned_to, labels, checklists, cards_relations, links, attachments) REMPLACENT l'état précédent et ne peuvent pas être combinés avec leurs deltas. Les éléments de checklist sont { description, checked }. Rattrapez les changements avec updated_since sur list_cards / list_epics.

Utilisez move_card (pas update_card) pour changer la liste ou la position d'une carte ; un list_id vide signifie le backlog.

Les outils wiki, whiteboard, rétrospective et feuille de route nécessitent que l'espace de travail du projet soit sur un plan Pro ou d'essai. Les écritures d'éléments de whiteboard sont des outils par lots et tout-ou-rien ; les uids d'éléments proviennent de get_whiteboard. Les éléments de rétrospective sont gérés avec add_retro_items et move_retro_item (move_card refuse les cartes de rétrospective).

Limites quotidiennes : les appels d'outils sont comptés par utilisateur et par espace de travail — 500/jour sur le plan Gratuit, 5 000/jour sur Pro ou essai, réinitialisation à 00:00 UTC. get_ahm_spec et list_projects ne sont jamais comptés (ni aucun appel non attribuable à un seul espace de travail, comme une recherche sans portée). Au-delà de la limite, les outils renvoient une erreur de limite quotidienne jusqu'à la réinitialisation ou la mise à niveau.

TOUT le texte enrichi (pages wiki, descriptions de cartes/epics, commentaires) est en AgileHero Markup (AHM) — XML strict, JAMAIS markdown ou HTML ; appelez get_ahm_spec une fois avant d'en écrire. Les modifications de texte enrichi sont en deux étapes par conception : preview_wiki_page_update / preview_description_update (conséquences + preview_token), puis l'outil de mise à jour correspondant avec ce jeton.

Documentation complète des outils : https://agilehero.io/docs/mcp

Spécification AHM : https://agilehero.io/docs/mcp/agilehero-markup

Outils (49)

list_projectslecture seule

Liste chaque espace de travail et projet auquel l'utilisateur du jeton peut accéder, afin que l'agent puisse résoudre l'uid de projet requis par la plupart des autres outils. Appelez ceci en premier chaque fois qu'aucun uid de projet n'est connu — ne demandez jamais à l'utilisateur d'en coller un. Renvoie les espaces de travail (uid, nom, plan, votre rôle) avec leurs projets (uid, nom, url). Les outils du pilier Pro (wiki, métriques) nécessitent que le plan de l'espace de travail soit pro ou essai.

searchlecture seule

La recherche plein texte globale du produit (OpenSearch) : cartes, epics, pages wiki et projets, correspondant aux titres, descriptions, commentaires, éléments de checklist et noms de fichiers joints, classés par pertinence avec un boost de récence. Utilisez-la pour trouver n'importe quoi par contenu (« la carte où nous avons discuté de la migration ») ; utilisez search_cards uniquement pour les recherches de sous-chaînes dans les titres au sein d'un seul projet. Chaque résultat comporte un type, un uid prêt pour l'action (les cartes alimentent get_card/update_card, les epics get_epic, les wiki_pages show_wiki_page, les projets les paramètres project_id), une URL de lien profond et des extraits surlignés <mark> montrant pourquoi il a été trouvé. Optionnellement, limitez avec project_id ou assigned_to_me. Paginez avec page/per_page ; total_count est le nombre total de correspondances.

Paramètre	Type	Requis	Description
query	string	oui	Requête de recherche en texte libre
project_id	string		UID de projet optionnel pour limiter la recherche
assigned_to_me	boolean		Uniquement les résultats assignés à l'utilisateur du jeton
page	integer		Numéro de page (défaut 1)
per_page	integer		Résultats par page, 1-50 (défaut 20)

get_cardlecture seule

Lire une carte en entier : sa description AgileHero Markup avec les identifiants de blocs plus description_version (les deux entrées preview_description_update / update_description prennent), l'emplacement dans la liste, l'epic, les étiquettes, les assignés, le rapporteur, le type, l'estimation, la date d'échéance, les checklists, les liens, les pièces jointes, les cartes liées et les commentaires en fil. Prend uniquement l'uid de la carte — il n'y a pas de paramètre project_id. Les uids de cartes proviennent de list_cards, search ou search_cards.

Paramètre	Type	Requis	Description
id	string	oui	L'identifiant unique de la carte

get_epiclecture seule

Lire un epic en entier : sa description AgileHero Markup avec les identifiants de blocs plus description_version (les deux entrées preview_description_update / update_description prennent), le nom, le numéro, la couleur, les dates de début/fin, les assignés, les checklists, les liens, les pièces jointes, chaque carte qu'il contient (uid, numéro, titre et sa liste avec catégorie — liste nulle = backlog — dans l'ordre du tableau, c'est donc la façon de lister toutes les cartes d'un epic et de voir lesquelles sont à faire, en cours ou terminées) et les commentaires en fil. Prend uniquement l'uid de l'epic — il n'y a pas de paramètre project_id. Les uids d'epics proviennent de list_epics ou search.

Paramètre	Type	Requis	Description
id	string	oui	L'identifiant unique de l'epic

list_wiki_pathsPro · wikilecture seule

Lister tout l'arborescence wiki d'un projet dans l'ordre d'affichage — chaque dossier et page avec son uid, son nom, son type (page ou dossier) et son parent_id — afin que l'agent puisse résoudre l'uid de page que show_wiki_page prend et choisir un parent_id pour create_wiki_page. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique du projet

show_wiki_pagePro · wikilecture seule

Récupérer une page wiki en AgileHero Markup (AHM) avec son document_version. Le contenu est en AHM, pas en markdown — les identifiants de blocs, les ancres <discussion>, et les références <image/>/<attachment/> font partie du document ; lisez get_ahm_spec avant de modifier. Modifiez via preview_wiki_page_update puis update_wiki_page, en utilisant les identifiants de blocs et document_version retournés ici. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	L'identifiant unique du chemin de la page

get_ahm_speclecture seule

La spécification AgileHero Markup (AHM) v1.0 — le SEUL format de texte enrichi qu'AgileHero accepte (markdown et HTML sont rejetés). Lisez ceci UNE FOIS avant d'écrire ou de modifier tout texte enrichi (pages wiki, descriptions de cartes/epics, commentaires) : vocabulaire, attributs, règles d'échappement et un exemple travaillé. Même texte sur le web : https://agilehero.io/docs/mcp/agilehero-markup

create_wiki_pagePro · wiki

Créer une page wiki (optionnellement dans un dossier) avec du contenu AgileHero Markup (AHM). Le contenu doit être enveloppé dans <agile-hero-markup version="1.0"> — markdown et HTML sont rejetés ; lisez get_ahm_spec d'abord. Retourne l'uid de la nouvelle page, son url, document_version et contenu. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique (uid) du projet
name	string	oui	Titre de la page
parent_id	string		UID de dossier optionnel (de list_wiki_paths)
content	string		Corps de la page en AHM ; omettre pour une page vide

preview_wiki_page_updatePro · wikilecture seule

Étape préalable OBLIGATOIRE pour chaque mise à jour de page wiki : valide les opérations et retourne les conséquences calculées par le serveur (blocs ajoutés/supprimés/modifiés, fichiers qui seraient définitivement supprimés, discussions d'équipe qui perdraient leurs ancres, avertissements possibles de markdown) plus le preview_token que update_wiki_page exige. Rien n'est modifié. Les opérations sont adressées par bloc (replace_block / insert_after / delete_block / move_block) avec du contenu AHM — lisez get_ahm_spec d'abord, et obtenez les identifiants de blocs + document_version de show_wiki_page. Examinez les conséquences avant d'enregistrer : une suppression de fichier listée ou un désancrage de discussion n'est acceptable que si l'utilisateur l'a demandé. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	UID du chemin de la page
document_version	string	oui	De show_wiki_page — prouve la fraîcheur
operations	array of object	oui	Appliquées dans l'ordre sur le document en évolution

update_wiki_pagePro · wikidestructif

Appliquer une mise à jour précédemment prévisualisée à une page wiki. Exige le preview_token de preview_wiki_page_update pour EXACTEMENT ces opérations et ce document_version — enregistrer sans prévisualiser est impossible par conception. Chaque enregistrement crée une version de page que les humains peuvent restaurer dans l'application. Retourne la page mise à jour (AHM + nouveau document_version) et les conséquences appliquées. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	UID du chemin de la page
document_version	string	oui	La version sur laquelle la prévisualisation a été faite
operations	array of object	oui	Les opérations exactes qui ont été prévisualisées
preview_token	string	oui	De preview_wiki_page_update

preview_description_updatelecture seule

Étape préalable OBLIGATOIRE pour chaque modification de description de carte ou d'epic : valide les opérations de blocs et retourne les conséquences calculées par le serveur plus le preview_token que update_description exige. Rien n'est modifié. Le contenu est en AgileHero Markup (AHM, surface de description : pas de tableaux, couleurs, alignement, discussions ou pièces jointes) — lisez get_ahm_spec d'abord ; les identifiants de blocs et document_version proviennent de get_card / get_epic.

Paramètre	Type	Requis	Description
resource_type	enum: card | epic	oui
id	string	oui	UID de carte ou d'epic
document_version	string	oui	De get_card / get_epic
operations	array of object	oui	Appliquées dans l'ordre sur la description en évolution

update_descriptiondestructif

Appliquer une mise à jour de description précédemment prévisualisée à une carte ou un epic. Exige le preview_token de preview_description_update pour EXACTEMENT ces opérations et ce document_version — enregistrer sans prévisualiser est impossible par conception. Retourne la description mise à jour (AHM + nouveau document_version).

Paramètre	Type	Requis	Description
resource_type	enum: card | epic	oui
id	string	oui	UID de carte ou d'epic
document_version	string	oui	La version sur laquelle la prévisualisation a été faite
operations	array of object	oui	Les opérations exactes qui ont été prévisualisées
preview_token	string	oui	De preview_description_update

list_whiteboardsPro · whiteboardlecture seule

Lister les whiteboards d'un projet (uid, nom, nombre d'éléments, url). Utilisez get_whiteboard pour lire les éléments d'un tableau. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique du projet

create_whiteboardPro · whiteboard

Créer un whiteboard vide sur un projet. Ajoutez du contenu avec create_whiteboard_elements. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique du projet
name	string	oui	Nom du whiteboard

get_whiteboardPro · whiteboardlecture seule

Lire un whiteboard comme une représentation textuelle compacte : limites du tableau plus une ligne par élément — « <type> <uid> à <x>,<y> taille <w>x<h> [couleur] [parent <frame-uid>] [lié <card|epic> <uid>] \"texte\" », les connecteurs comme « connecteur <uid> <from> -> <to> ». Les uids d'éléments d'ici sont les poignées que chaque outil d'écriture de whiteboard prend. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	L'identifiant unique du whiteboard

create_whiteboard_elementsPro · whiteboard

Créer jusqu'à 100 éléments de whiteboard en un seul appel transactionnel (tout ou rien, un seul événement temps réel). Les tailles natives, couleurs et placements de texte sont appliqués côté serveur — donnez généralement juste le type + texte (+ couleur). Omettez x/y et les éléments sont automatiquement disposés (grille par défaut ; arrange : row|column|grid, origin_x/origin_y/gap pour ajuster) ; donnez x/y pour un contrôle total. Les cadres contiennent des éléments via parent_id (un uid de cadre existant) ou parent_ref (la ref d'un cadre plus tôt dans CET appel). Les connecteurs lient les éléments par uid (source_id/target_id) ou ref de lot (source_ref/target_ref) — jamais par coordonnées ; les ancres sont calculées par l'interface. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
whiteboard_id	string	oui	L'identifiant unique du whiteboard
elements	array of object	oui	Créés dans l'ordre du tableau — les refs ne se résolvent que vers l'arrière
arrange	enum: grid | row | column		Disposition pour les éléments sans x/y explicite (défaut grille)
origin_x	number		Début x de la disposition automatique (défaut 100)
origin_y	number		Début y de la disposition automatique (défaut 100)
gap	number		Espacement de la disposition automatique en px (défaut 20)

create_whiteboard_diagramPro · whiteboard

Dessiner un diagramme (organigramme, processus, graphe de dépendances) sur un whiteboard à partir d'un graphe sémantique — nœuds, arêtes, groupes optionnels, AUCUNE coordonnée : le serveur fait une disposition en couches de haut en bas avec des tailles natives et retourne les uids d'éléments créés indexés par vos identifiants de nœuds. Placé sous le contenu existant du tableau. Transactionnel (tout ou rien, un seul événement temps réel). Maximum 20 nœuds — divisez les flux plus grands en deux diagrammes. Gardez les formes simples (rectangle) sauf si la sémantique l'exige (losange = décision, stade = début/fin, cylindre = magasin de données). Modifiez le résultat avec update_whiteboard_elements — la disposition ne s'exécute jamais à nouveau. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
whiteboard_id	string	oui	L'identifiant unique du whiteboard
title	string		Titre du diagramme (titre du cadre, ou un en-tête quand des groupes sont utilisés)
nodes	array of object	oui
edges	array of object
groups	array of object
origin_x	number		x en haut à gauche optionnel ; par défaut sous le contenu existant
origin_y	number		y en haut à gauche optionnel ; par défaut sous le contenu existant

update_whiteboard_elementsPro · whiteboard

Mettez à jour jusqu'à 100 éléments de tableau blanc en un seul appel tout-ou-rien : déplacer (x/y), redimensionner, réorganiser (z_index), modifier le texte, recolorer, réaffecter (parent_id — un uid de cadre, ou "" pour détacher), ainsi que les flèches/chemins/étiquettes de connecteur. Les uids d'éléments proviennent de get_whiteboard ; les types d'éléments ne peuvent pas être modifiés. Seuls les champs fournis changent — les propriétés non liées sont préservées. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
whiteboard_id	string	oui	L'identifiant unique du tableau blanc
updates	tableau d'objets	oui

delete_whiteboard_elementsPro · whiteboarddestructif

Supprimez jusqu'à 100 éléments de tableau blanc en un seul appel transactionnel. La suppression d'un cadre ou d'un nœud de carte mentale libère ses enfants sur le tableau (ils ne sont PAS supprimés — incluez leurs uids explicitement pour les supprimer aussi). Les connecteurs attachés aux éléments supprimés ne sont pas retirés et resteront suspendus. Les uids d'éléments proviennent de get_whiteboard. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
whiteboard_id	string	oui	L'identifiant unique du tableau blanc
ids	tableau de chaînes	oui	Uids des éléments à supprimer

review_whiteboardPro · whiteboardlecture seule

Exécutez des contrôles de qualité déterministes sur un tableau blanc : texte susceptible de déborder de son élément, éléments visiblement superposés, connecteurs avec des extrémités non liées ou suspendues, couleurs hors palette de l'interface, positions hors grille, et éléments dont le parent a été supprimé. Avis — les constatations sont des suggestions, pas des erreurs, et un tableau avec des constatations peut être exactement ce que l'utilisateur souhaite. Utilisez-le après le dessin pour vérifier la cohérence, corrigez au plus une fois, et ne bouclez pas pour chasser un rapport vide. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	L'identifiant unique du tableau blanc

convert_whiteboard_elementPro · whiteboard

Convertissez un élément de tableau blanc en élément de backlog : un post-it en carte ou en épopée, ou un cadre en épopée (les enfants post-it du cadre deviennent des cartes sur cette épopée ; les enfants déjà convertis sont réaffectés, non dupliqués). L'élément reste sur le tableau, lié à ce qu'il est devenu — get_whiteboard affiche le lien. Un élément ne peut être converti qu'une seule fois. Le texte du post-it/cadre devient le titre sauf si vous en fournissez un. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	Uid de l'élément (un sticky_note ou frame, depuis get_whiteboard)
to	enum : card | epic	oui	Ce qu'il faut créer
title	string		Titre de la carte / nom de l'épopée ; par défaut, le texte de l'élément
list_id	string		Carte uniquement : uid de la liste cible ; omettre pour le backlog
color	string		Épopée uniquement : couleur hexadécimale ; par défaut, la couleur de l'élément

convert_mind_mapPro · whiteboard

Convertissez une carte mentale en éléments de backlog avec un mappage par nœud : la racine peut devenir une nouvelle épopée (rôle "epic") ou s'attacher à une existante (rôle "existing_epic" + target_epic_id) ; les autres nœuds deviennent des cartes sur cette épopée (rôle "card") ou des étiquettes de projet (rôle "label" — les nœuds d'étiquette au-dessus d'un nœud de carte dans l'arbre sont appliqués à cette carte) ; le rôle "skip" ignore un nœud. Passez l'uid de l'élément RACINE comme id et chaque nœud à convertir dans nodes (les nœuds non listés sont ignorés). Une conversion par nœud : les nœuds déjà convertis sont rejetés d'emblée — resoumettez sans eux. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	L'uid du nœud RACINE de la carte mentale (depuis get_whiteboard)
nodes	tableau d'objets	oui
target_epic_id	string		Uid de l'épopée, requis avec le rôle "existing_epic" sur la racine

list_retrospectivesPro · retrospectiveslecture seule

Listez les rétrospectives d'un projet : les rétrospectives de nouveau modèle et les bilans de santé lorsque l'espace de travail en dispose, les tableaux de rétrospectives classiques sinon. Une entrée de nouveau modèle a uid, name, kind (retro | health_check), status (open | live | closed), date (starts_on ; closes_on pour un bilan de santé), l'étape actuelle, le modèle, l'uid du facilitateur, les compteurs des actions qu'elle a créées, et url ; la réponse ajoute le open_actions_count du projet. Utilisez get_retrospective pour une vue complète. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique du projet

create_retrospectivePro · retrospectives

Créez une rétrospective : une rétrospective de nouveau modèle lorsque l'espace de travail en dispose, un tableau de rétrospective classique sinon ; la réponse est la rétrospective telle que get_retrospective la renvoie (colonnes avec leurs uids), afin que add_retro_items puisse suivre immédiatement. Une rétrospective de nouveau modèle provient d'un modèle (par défaut went_well), est ouverte aux notes immédiatement et vous a comme facilitateur ; en option : focus, anonymat (par défaut : celui du modèle), participant_ids (une rétrospective à membres sélectionnés ; omettre pour chaque membre du projet avec accès en écriture), les types de questions check_in et feedback, et les votes. Le facilitateur la démarre et en anime les étapes dans l'application. Les tableaux classiques n'acceptent que name, date et previous_retrospective_id et refusent les arguments de nouveau modèle. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique du projet
name	string	oui	Nom de la rétrospective
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		Clé du modèle ; par défaut went_well
starts_on	string		Date, ISO-8601 (AAAA-MM-JJ) ; par défaut aujourd'hui
starts_at	string		Alias obsolète de starts_on
focus	string		Le sujet de cette rétro, affiché sous son nom
anonymity	enum : anonymous | optional | named		Qui est affiché sur les notes : anonymous, optional (les auteurs peuvent ajouter leur nom) ou named
participant_ids	tableau de chaînes		Uids des participants (list_project_users) ; vous en faites toujours partie
check_in	enum : safety | mood | esvp | one_word		Question de point de départ (par défaut safety)
feedback	enum : roti | pulse | one_word		Question de feedback de clôture (par défaut roti)
votes	objet		Paramètres de vote : budget (auto | fixed | unlimited), per_person (1-20), max_per_topic (1-10)
previous_retrospective_id	string		Tableaux classiques uniquement : uid d'une rétrospective antérieure dont la colonne Actions s'affiche comme « Past actions »

get_retrospectivePro · retrospectiveslecture seule

Lisez une rétrospective telle que vous pouvez la voir : une rétrospective de nouveau modèle ou un bilan de santé lorsque l'espace de travail en dispose, un tableau de rétrospective classique sinon. Une rétrospective de nouveau modèle renvoie la configuration, les étapes (étape actuelle, minuteur, progression), les colonnes (avec uids) contenant les sujets (groupes de notes, avec uids), les totaux de check-in et de feedback, vos votes restants, la file Discuss et les sujets mis de côté, les propositions, les actions (celles qu'elle a créées plus celles ouvertes du projet) et, une fois fermée, son résumé. La confidentialité suit la salle : avant la révélation, vous n'obtenez que vos propres notes (chaque colonne compte celles de tout le monde), les auteurs uniquement sur les notes nommées, les totaux de votes uniquement une fois les votes révélés. Un bilan de santé renvoie ses dimensions et la participation, vos propres évaluations pendant qu'il est ouvert, et des agrégats par dimension une fois fermé. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	L'uid de la rétrospective (depuis list_retrospectives)

add_retro_itemsPro · retrospectives

Ajoutez des éléments à une rétrospective en votre nom, plusieurs à la fois : des notes sur une rétrospective de nouveau modèle lorsque l'espace de travail en dispose, des cartes sur un tableau de rétrospective classique sinon. Chaque élément est { column, text, recipient_id? } : column est un titre de colonne (insensible à la casse) ou un uid de get_retrospective ; text fait jusqu'à 1000 caractères (255 sur les tableaux classiques) ; recipient_id, l'uid de l'utilisateur du coéquipier remercié, est requis dans une colonne kudos de nouveau modèle et refusé sur les tableaux classiques. Une note de nouveau modèle démarre son propre sujet et les autres la voient une fois les notes révélées ; les notes ne sont prises que pendant que la rétrospective est ouverte aux notes ou à l'étape Write, sinon l'appel est refusé avec le code wrong_stage et l'étape actuelle. Échec PARTIEL : les éléments valides sont ajoutés, les invalides sont signalés par index — vérifiez le tableau "failed". Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
retrospective_id	string	oui	L'uid de la rétrospective
items	tableau d'objets	oui

move_retro_itemPro · retrospectives

Déplacez un élément de rétrospective : regroupez une note sur une rétrospective de nouveau modèle lorsque l'espace de travail en dispose, déplacez une carte vers une autre colonne d'un tableau de rétrospective classique sinon. Nouveau modèle, étape Group uniquement : topic_id place la note dans ce sujet (groupe de notes) ; column (titre ou uid) en fait un sujet à part entière là-bas, à la position parmi les sujets de la colonne (omettre pour la fin). Passez expected_updated_at, le updated_at du sujet de la note depuis get_retrospective, pour être refusé avec le code stale si quelqu'un l'a regroupé entre-temps. Hors de l'étape Group, l'appel est refusé avec le code wrong_stage et l'étape actuelle ; les kudos et les autres notes ne se mélangent jamais. Les tableaux classiques n'acceptent que column et position (position omise = en haut). Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	L'uid de la note (tableaux classiques : l'uid de l'élément) depuis get_retrospective
topic_id	string		Uid du sujet cible ; laissez column de côté
column	string		Titre ou uid de la colonne cible
position	entier		Index dans la colonne cible (0 = premier)
expected_updated_at	string		Le updated_at du sujet de la note tel que lu en dernier (contrôle de conflit)

list_project_userslecture seule

Listez les membres d'un projet — chaque membre de l'espace de travail pour un projet standard ; le créateur, les propriétaires et administrateurs de l'espace de travail, et toute personne explicitement ajoutée pour un projet privé — afin que l'agent puisse résoudre les uids des assignés au lieu de deviner les noms. Renvoie l'uid de chaque membre, son nom complet, son e-mail et son rôle dans l'espace de travail (owner, admin, member ou observer). Ces uids sont ce que assigned_to attend sur create_card, update_card, create_epic, update_epic et create_roadmap_slot.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique du projet

list_board_listslecture seule

Listez les listes du tableau kanban d'un projet afin que l'agent puisse résoudre une destination move_card valide. Renvoie chaque liste active dans l'ordre d'affichage avec son uid (utilisable comme cible move_card) et son nom d'affichage. Le backlog est inclus comme entrée sélectionnable avec un id de chaîne vide.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique (uid) du projet

list_epicslecture seule

Listez les épopées d'un projet afin que l'agent puisse résoudre les uids d'épopées pour get_epic et l'assignation de cartes. Renvoie chaque épopée dans l'ordre d'affichage (position croissante) avec son uid, son numéro, son nom, sa description (Markdown), sa couleur, ses dates de début/fin et les compteurs de cartes.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique (uid) du projet
updated_since	string		Seules les épopées dont l'enregistrement a changé à ou après cette date ou date-heure ISO-8601. Attention : les modifications de collection (listes de contrôle, liens) peuvent ne pas mettre à jour l'heure de changement d'une épopée ; les modifications de nom/date/description le font toujours.

list_labelslecture seule

Listez les étiquettes d'un projet afin que l'agent puisse réutiliser la taxonomie existante au lieu de créer des quasi-doublons lors des écritures de cartes. Renvoie chaque étiquette dans l'ordre d'affichage (position croissante) avec son uid, son nom et sa position.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique (uid) du projet

list_cardslecture seule

Liste les cartes d'une liste kanban, ou du backlog du projet lorsque list_id est omis ou vide, dans l'ordre d'affichage du tableau (haut de la colonne en premier, c'est-à-dire position de placement décroissante — le même ordre que l'interface produit). Les filtres se combinent avec ET : epic_id, label_id, assigned_user_id et reporter_id prennent des uids (un uid inconnu ne correspond à rien) ; due_date conserve les cartes à échéance à la date donnée ou avant. Renvoie des résumés de cartes suffisants pour les actions (uid, titre, liste + position, épopée, étiquettes, assignés, rapporteur, date d'échéance), prêts pour get_card / move_card / update_card, paginés avec limit (défaut 50, max 100) et offset ; total_count est le nombre total filtré.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique (uid) du projet
list_id	string		Uid de la liste à lire ; omettre ou passer une chaîne vide pour le backlog
epic_id	string		Uniquement les cartes de cette épopée (uid de l'épopée) dans la liste ou le backlog choisi ; pour lister chaque carte d'une épopée sur toutes les listes, utilisez get_epic
label_id	string		Uniquement les cartes portant cette étiquette (uid de l'étiquette)
assigned_user_id	string		Uniquement les cartes assignées à cet utilisateur (uid de l'utilisateur)
reporter_id	string		Uniquement les cartes signalées (créées) par cet utilisateur (uid de l'utilisateur)
due_date	string		Uniquement les cartes à échéance à cette date ou avant (ISO-8601, ex. 2026-06-10)
updated_since	string		Uniquement les cartes dont l'enregistrement a changé à cette date ou date-heure ISO-8601 ou après — le filtre « ce qui a changé depuis ma dernière exécution ». Attention : les modifications des collections jointes (étiquettes, listes de contrôle, liens) peuvent ne pas mettre à jour l'heure de changement d'une carte ; les modifications de titre/description/scalaires le font toujours.
limit	integer		Taille de page, 1-100 (défaut 50)
offset	integer		Nombre de cartes à ignorer (défaut 0)

search_cardslecture seule

Recherche de cartes par sous-chaîne de titre dans un projet (tableau kanban et backlog), correspondant exactement à la recherche de cartes en direct du produit (sous-chaîne insensible à la casse dans la base de données sur le titre de la carte uniquement — les descriptions et commentaires ne sont pas recherchés ; utilisez l'outil de recherche pour une recherche en texte intégral sur tous les types de contenu), triée par création la plus récente en premier. Renvoie des résumés de cartes suffisants pour les actions (uid, titre, placement de liste + position, épopée, étiquettes, assignés, rapporteur, date d'échéance) ; une requête sans correspondance renvoie un tableau de cartes vide, pas une erreur. Paginez avec limit (défaut 50, max 100) et offset ; total_count est le nombre total de correspondances.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique (uid) du projet
query	string	oui	Texte à faire correspondre aux titres de cartes (sous-chaîne insensible à la casse)
limit	integer		Taille de page, 1-100 (défaut 50)
offset	integer		Nombre de cartes correspondantes à ignorer (défaut 0)

list_attention_cardsPro · métriqueslecture seule

Liste les cartes nécessitant une attention sur le tableau kanban d'un projet — les mêmes listes que les pages Métriques du produit. Types : stuck (bloquées dans une colonne, pas backlog/Terminé, non déplacées depuis plus de 7 jours ; les plus bloquées en premier), blocking (cartes non terminées qui bloquent d'autres cartes), overdue (à échéance dans les 7 prochains jours ou déjà en retard ; les plus proches en premier). kind sélectionne une liste ou 'all' (défaut). Filtrez éventuellement par un uid d'assigné ou le littéral 'unassigned'. Chaque section demandée renvoie des résumés de cartes prêts pour get_card / move_card / update_card, plafonnés à limit avec le total_count complet. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique (uid) du projet
kind	enum : stuck | blocking | overdue | all		Quelle liste d'attention renvoyer (défaut 'all' = chaque liste comme sa propre section)
assignee_id	string		Uniquement les cartes assignées à cet uid d'utilisateur, ou 'unassigned' pour les cartes sans assigné
limit	integer		Max de cartes par section, 1-100 (défaut 50)

get_metrics_summaryPro · métriqueslecture seule

Comptages en un appel des cartes nécessitant une attention sur le tableau kanban d'un projet : overdue_cards_count, blocking_cards_count et stuck_cards_count — les mêmes définitions que list_attention_cards, qui renvoie les cartes derrière chaque comptage. Peu coûteux ; appelez-le d'abord pour décider si un examen plus approfondi en vaut la peine. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique (uid) du projet

list_roadmap_slotsPro · feuille de routelecture seule

Liste les créneaux de feuille de route d'un projet chevauchant une fenêtre de dates (défaut : ce mois-ci jusqu'à cinq mois). Un créneau planifie une épopée entre deux dates et peut porter des assignés ; une épopée peut avoir plusieurs créneaux, chevauchements inclus — c'est voulu. Renvoie au plus 200 créneaux — réduisez la fenêtre si plafonné. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique du projet
start_date	string		Début de fenêtre, ISO-8601 (AAAA-MM-JJ) ; défaut : début de ce mois
end_date	string		Fin de fenêtre, ISO-8601 ; défaut : start_date + 6 mois

create_roadmap_slotPro · feuille de route

Planifiez une épopée sur la feuille de route du projet : un créneau de start_date à end_date, éventuellement avec des assignés. Une épopée peut avoir plusieurs créneaux et les chevauchements sont autorisés par conception — vérifiez list_roadmap_slots d'abord si vous voulez étendre un créneau existant plutôt que d'en ajouter un. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
project_id	string	oui	L'identifiant unique du projet
epic_id	string	oui	Uid de l'épopée (de list_epics) ; doit appartenir à ce projet
start_date	string	oui	ISO-8601 (AAAA-MM-JJ)
end_date	string	oui	ISO-8601 ; le même jour que start_date est autorisé
assigned_to	tableau de string		Uids d'utilisateurs à assigner (membres du projet — voir list_project_users)

update_roadmap_slotPro · feuille de route

Mettez à jour un créneau de feuille de route : reprogrammez ou redimensionnez (start_date/end_date), déplacez-le vers une autre épopée du même projet (epic_id), ou définissez ses assignés. Seuls les champs fournis changent, SAUF assigned_to qui REMPLACE l'ensemble complet des assignés — lisez le créneau d'abord et envoyez tous ceux qui doivent rester. Les uids de créneaux proviennent de list_roadmap_slots. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	L'uid du créneau de feuille de route
epic_id	string		Nouvel uid d'épopée (même projet)
start_date	string		ISO-8601 (AAAA-MM-JJ)
end_date	string		ISO-8601
assigned_to	tableau de string		REMPLACE tous les assignés (uids d'utilisateurs, membres du projet) ; [] efface

delete_roadmap_slotPro · feuille de routedestructif

Supprime DÉFINITIVEMENT un créneau de feuille de route (et ses liens d'assignés). Cela ne peut pas être annulé — il n'y a pas de corbeille pour les créneaux de feuille de route. L'épopée elle-même n'est pas touchée ; pour reprogrammer, préférez update_roadmap_slot. Nécessite un espace de travail Pro ou d'essai.

Paramètre	Type	Requis	Description
id	string	oui	L'uid du créneau de feuille de route (de list_roadmap_slots)

create_label

Créez une nouvelle étiquette sur un projet par nom. Si une étiquette avec le même nom existe déjà (insensible à la casse), l'étiquette existante est renvoyée inchangée au lieu de créer un quasi-doublon. La nouvelle étiquette est ajoutée à la fin de l'ordre d'affichage.

Paramètre	Type	Requis	Description
project_id	string	oui	Uid du projet auquel l'étiquette appartient
name	string	oui

create_card

Créez une carte sur le tableau kanban d'un projet. Seuls project_id et title sont requis. Omettre list_id pour placer la carte dans le backlog ; omettre position pour rejoindre la fin de la file (move_card documente le contrat de position). description est en AgileHero Markup — jamais en markdown ou HTML ; lisez get_ahm_spec d'abord. epic_id et les uids d'assignés doivent déjà exister (list_epics, list_project_users), tandis que les noms d'étiquettes qui n'existent pas encore sont créés sur le projet. estimation est la complexité de Fibonacci (0/1/2/3/5/8/13), pas une estimation de temps. Les listes de contrôle, liens, pièces jointes et relations de cartes peuvent tous être fournis dans ce même appel.

Paramètre	Type	Requis	Description
project_id	string	oui	Uid du projet auquel la carte appartient (la carte est créée sur le tableau kanban du projet)
list_id	string		Uid de la liste ; omettre pour placer dans le backlog
position	integer
type	enum : story | bug | chore | research
title	string	oui
description	string		AgileHero Markup (AHM) — jamais en markdown ou HTML ; lisez get_ahm_spec d'abord. Surface de description : pas de tableaux, couleurs, alignement ou discussions.
epic_id	string		Uid de l'épopée ; doit déjà exister sur le projet
estimation	enum : 0 | 1 | 2 | 3 | 5 | 8 | 13		Estimation de complexité en points d'histoire (échelle de Fibonacci), pas une estimation de temps
due_date	string		Date ISO-8601
assigned_to	tableau de string		Uids d'utilisateurs assignés, découvrables via list_project_users
labels	tableau de string		Noms d'étiquettes ; les noms inconnus sont créés sur le projet
checklists	tableau d'objets		Chaque { name, items : [{ description, checked }] } ; les éléments conservent l'ordre fourni
cards_relations	tableau d'objets		Chaque { type, target_card_id (un uid de carte sur le même tableau) }
links	tableau d'objets		Chaque { url, description }
attachments	tableau d'objets		Chaque { url, name } ; le fichier est récupéré depuis l'url

update_carddestructif

Mettez à jour une carte existante par son uid. Pour les collections, préférez les champs delta add_*/remove_* (modifications incrémentales sûres : add_labels, remove_assignees, add_checklist_items, check_items, …) ; les champs de collection simples (labels, assigned_to, checklists, cards_relations, links, attachments) REMPLACENT l'état précédent de manière destructive et ne peuvent pas être combinés avec leurs deltas. Utilisez move_card pour changer de liste ou de position, et preview_description_update / update_description pour modifier la description.

Paramètre	Type	Requis	Description
id	string	oui	UID de la carte
type	enum: story | bug | chore | research
title	string
epic_id	string
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Estimation de complexité en points de story (échelle de Fibonacci), pas une estimation de temps
due_date	string		Date ISO-8601
assigned_to	array of string		UID des utilisateurs assignés, découvrables via list_project_users ; remplace les assignés de la carte
labels	array of string		Noms des étiquettes ; les noms inconnus sont créés sur le projet ; remplace les étiquettes de la carte
checklists	array of object		Chaque { name, items: [{ description, checked }] } ; les éléments conservent l'ordre fourni ; remplace les listes de contrôle de la carte
cards_relations	array of object		Chaque { type, target_card_id (un UID de carte sur le même tableau) } ; remplace les relations de la carte
links	array of object		Chaque { url, description } ; remplace les liens de la carte
attachments	array of object		Chaque { url, name } ; le fichier est récupéré depuis l'url ; remplace les pièces jointes de la carte
add_labels	array of string		Ajoute des étiquettes par nom (les noms inconnus sont créés) ; conserve les étiquettes existantes
remove_labels	array of string		Supprime des étiquettes par nom (insensible à la casse) ; les noms absents sont sans effet
add_assignees	array of string		Ajoute des assignés par UID utilisateur ; conserve les assignés existants
remove_assignees	array of string		Supprime des assignés par UID utilisateur ; les UID absents sont sans effet
add_checklist_items	array of object		Ajoute des éléments : chaque { checklist, description, checked? } — la liste de contrôle nommée est créée si elle n'existe pas
check_items	array of object		Marque les éléments comme terminés, correspondance par description exacte dans la liste de contrôle nommée
uncheck_items	array of object		Marque les éléments comme non terminés (même correspondance que check_items)
remove_checklist_items	array of object		Supprime des éléments ; les éléments absents sont sans effet
add_relations	array of object		Ajoute des relations ; conserve les relations existantes
remove_relations	array of object		Supprime les relations correspondantes ; les absentes sont sans effet
add_links	array of object		Ajoute des liens : chaque { url, description? } ; conserve les liens existants
remove_links	array of string		Supprime des liens par url exacte ; les urls absentes sont sans effet

delete_carddestructive

Supprime en douceur une carte par son UID : elle quitte le tableau et toutes les listes, ses relations avec d'autres cartes sont supprimées, toute session d'estimation la concernant est désactivée, et les éléments de tableau blanc qui lui sont liés sont déliés. L'epic auquel elle appartenait n'est pas supprimé. Il n'y a pas de restauration via MCP.

Paramètre	Type	Requis	Description
id	string	oui	UID de la carte

move_card

Déplace une carte vers une autre liste (ou change sa position dans la même liste). Seules les cartes d'un tableau kanban peuvent être déplacées ; les cartes des tableaux rétrospectifs sont rejetées. Passez une chaîne vide pour list_id afin de déplacer la carte vers le backlog kanban. Une liste s'affiche de haut en bas depuis sa position la plus élevée, donc la position 0 est le BAS de la liste. Omettez position pour rejoindre la fin de la file (le bas, position 0) dans le backlog et dans les listes to_do et in_progress, ou le haut d'une liste done.

Paramètre	Type	Requis	Description
id	string	oui	UID de la carte
list_id	string	oui	UID de la liste cible ; une chaîne vide déplace vers le backlog (kanban uniquement)
position	integer		Placement dans la cible : 0 est le bas et la position la plus élevée est le haut. Doit être entre 0 et le nombre d'autres cartes déjà dans la cible. Omettez-le pour rejoindre la fin de la file (position 0) dans le backlog et dans les listes to_do et in_progress, ou le haut d'une liste done.

create_epic

Crée un epic sur un projet. Seuls project_id et name sont requis. description est en AgileHero Markup — jamais en markdown ou HTML ; lisez d'abord get_ahm_spec. Les UID des assignés proviennent de list_project_users. Les listes de contrôle, liens et pièces jointes peuvent être fournis dans le même appel. Renvoie le nouvel UID de l'epic — ce que create_card / update_card acceptent comme epic_id, et ce que create_roadmap_slot planifie.

Paramètre	Type	Requis	Description
project_id	string	oui	UID du projet auquel appartient l'epic
name	string	oui
description	string		AgileHero Markup (AHM) — jamais en markdown ou HTML ; lisez d'abord get_ahm_spec. Surface de description : pas de tableaux, couleurs, alignement ou discussions.
color	string		Couleur hexadécimale comme #0060F0
start_date	string		Date ISO-8601
end_date	string		Date ISO-8601
assigned_to	array of string		UID des utilisateurs assignés, découvrables via list_project_users
checklists	array of object		Chaque { name, items: [{ description, checked }] } ; les éléments conservent l'ordre fourni
links	array of object		Chaque { url, description }
attachments	array of object		Chaque { url, name } ; le fichier est récupéré depuis l'url

update_epicdestructive

Met à jour un epic existant par son UID ; seuls les champs fournis sont modifiés. Pour les collections, privilégiez les champs delta add_*/remove_* (modifications incrémentales sûres) ; les champs de collection simples (assigned_to, checklists, links, attachments) REMPLACENT l'état précédent de manière destructive et ne peuvent pas être combinés avec leurs deltas. Utilisez preview_description_update / update_description pour modifier la description.

Paramètre	Type	Requis	Description
id	string	oui	UID de l'epic
name	string
color	string		Couleur hexadécimale comme #0060F0
start_date	string		Date ISO-8601
end_date	string		Date ISO-8601
assigned_to	array of string		UID des utilisateurs assignés, découvrables via list_project_users ; remplace les assignés de l'epic
checklists	array of object		Chaque { name, items: [{ description, checked }] } ; remplace les listes de contrôle de l'epic
links	array of object		Chaque { url, description } ; remplace les liens de l'epic
attachments	array of object		Chaque { url, name } ; le fichier est récupéré depuis l'url ; remplace les pièces jointes de l'epic
add_assignees	array of string		Ajoute des assignés par UID utilisateur ; conserve les assignés existants
remove_assignees	array of string		Supprime des assignés par UID utilisateur ; les UID absents sont sans effet
add_checklist_items	array of object		Ajoute des éléments : chaque { checklist, description, checked? } — la liste de contrôle nommée est créée si elle n'existe pas
check_items	array of object		Marque les éléments comme terminés, correspondance par description exacte dans la liste de contrôle nommée
uncheck_items	array of object		Marque les éléments comme non terminés (même correspondance que check_items)
remove_checklist_items	array of object		Supprime des éléments ; les éléments absents sont sans effet
add_links	array of object		Ajoute des liens : chaque { url, description? } ; conserve les liens existants
remove_links	array of string		Supprime des liens par url exacte ; les urls absentes sont sans effet

delete_epicdestructive

Supprime en douceur un epic par son UID. Ses cartes ne sont PAS supprimées — elles restent sur le tableau, détachées de l'epic. Les créneaux de feuille de route de l'epic sont, eux, définitivement supprimés (un créneau planifie un epic, il n'a donc pas de sens sans lui), et les éléments de tableau blanc liés à l'epic sont déliés.

Paramètre	Type	Requis	Description
id	string	oui	UID de l'epic

create_comment

Ajoute un commentaire à une carte ou à un epic. Fournissez exactement un de card_id ou epic_id. Le contenu est en AgileHero Markup (AHM, surface de commentaire : pas de tableaux, médias, couleurs, alignement ou discussions) — jamais en markdown ou HTML ; lisez d'abord get_ahm_spec. Le commentaire est attribué à l'utilisateur connecté au nom duquel ce client agit et apparaît dans les réponses ultérieures de get_card / get_epic. Les commentaires ne peuvent pas être modifiés via MCP ; delete_comment supprime les vôtres (corrigez les erreurs en supprimant puis en republiant). Passez parent_comment_id pour répondre à un commentaire existant. Les fils sont sur un seul niveau : répondre à une réponse rattache le nouveau commentaire à la racine du fil de cette réponse, donc n'essayez pas d'imbriquer les réponses. Le parent doit être un commentaire sur la même carte ou le même epic — un UID provenant d'ailleurs est rejeté.

Paramètre	Type	Requis	Description
card_id	string		UID de la carte à commenter (mutuellement exclusif avec epic_id)
epic_id	string		UID de l'epic à commenter (mutuellement exclusif avec card_id)
content	string	oui	Corps du commentaire en AgileHero Markup (AHM)
parent_comment_id	string		UID facultatif d'un commentaire sur la MÊME carte ou le même epic auquel répondre. Omettez-le pour un commentaire de premier niveau. Répondre à une réponse normalise vers la racine du fil de cette réponse (les fils sont sur un seul niveau).

delete_commentdestructive

Supprime un commentaire que VOUS avez publié (les commentaires sont attribués à l'utilisateur connecté au nom duquel ce client agit — les commentaires des autres ne peuvent pas être supprimés). Le modèle de correction est supprimer + publier un commentaire corrigé avec create_comment. Un commentaire supprimé qui a des réponses reste visible comme une pierre tombale dans son fil. Les UID des commentaires proviennent de get_card / get_epic.

Paramètre	Type	Requis	Description
id	string	oui	UID du commentaire