Référence des outils MCP
AB Projects expose des outils MCP qui permettent aux assistants IA (tels que Claude) de travailler avec vos projets, tâches et documents. Lorsqu'un assistant modifie quelque chose via ces outils, cela suit le même chemin que l'application : une entrée d'historique des modifications avec la note que vous fournissez, une entrée de journal d'audit, et une carte adaptative (Adaptive Card) publiée dans le canal Microsoft Teams lié — avec l'activité de l'IA clairement signalée. Les outils en lecture seule se contentent de renvoyer des données et ne modifient rien.
Outils de projet
| Outil | Description | Paramètres |
|---|---|---|
ab_get_my_projects |
Liste tous les projets dont vous êtes membre, y compris des statistiques telles que le nombre de tâches et les taux d'achèvement. | Aucun |
ab_get_project_members |
Liste tous les membres d'un projet avec leurs rôles et leurs ID d'appartenance. Utilisez-le pour obtenir l'ID d'appartenance nécessaire à l'affectation d'une tâche. | project_id requis |
ab_get_project_options |
Obtient les ID de statut, de type et d'environnement valides pour un projet. Appelez-le d'abord avant de passer un statut, un type ou un environnement à ab_create_task ou ab_update_task. |
project_id requis |
Outils de tâche
| Outil | Description | Paramètres |
|---|---|---|
ab_get_my_tasks |
Obtient vos tâches actives — en retard, à échéance aujourd'hui et en cours. Renvoie l'ID de la tâche, le titre, la priorité, le statut, la date d'échéance et la progression. | project_id optionnel — filtrer sur un projet précis |
ab_search_tasks |
Recherche des tâches par mot-clé dans tous vos projets. | query requis — mot-clé de recherche project_id optionnel — restreindre à un projet précis |
ab_get_task |
Obtient tous les détails d'une tâche — description, dates, personne assignée, heures estimées/réelles, informations sur les sous-tâches, ID de la tâche parente, branche GitHub, et les 50 commentaires les plus récents en ligne. Le statut, le type et l'environnement sont renvoyés sous forme de noms lisibles. | project_id requis task_id requis |
ab_create_task |
Crée une nouvelle tâche. Une entrée de journal des modifications est enregistrée et une notification est publiée dans le canal Teams lié. | project_id requis title requis description optionnel — prend en charge le Markdown priority optionnel — 1 = Élevée, 2 = Moyenne, 3 = Basse (par défaut : 2) assignee_id optionnel — ID d'appartenance de la personne assignée due_date optionnel — yyyy-MM-dd status / type / environment optionnel — ID issus de ab_get_project_optionsparent_task_id optionnel — clé de ligne de la tâche parente ; lorsqu'il est défini, ceci devient une sous-tâche et l'indicateur « possède des sous-tâches » de la tâche parente se met à jour automatiquement note optionnel — motif, affiché dans le journal des modifications et le canal Teams |
ab_update_task |
Met à jour les propriétés d'une tâche — titre, description, statut, progression, priorité, personne assignée, type, environnement ou parent. Chaque modification est enregistrée dans l'historique avec la note fournie. | project_id requis task_id requis title / description optionnel (Markdown) status optionnel — nouvel ID de statut progress optionnel — 0 à 100 priority optionnel — 1/2/3 assignee_id / type / environment optionnel parent_task_id optionnel — déplacer sous un parent différent ; chaîne vide pour détacher note optionnel — motif, affiché dans le journal des modifications et le canal Teams |
ab_complete_task |
Marque une tâche comme terminée. Définit la progression à 100 % et enregistre une entrée d'achèvement dans l'historique des modifications. | project_id requis task_id requis note optionnel — note d'achèvement, affichée dans le journal des modifications et le canal Teams |
ab_add_comment |
Ajoute un commentaire à une tâche. Le commentaire apparaît dans le fil de la tâche et est intégré en ligne par ab_get_task, de sorte qu'un appel ultérieur peut le lire sans un second appel d'outil. |
project_id requis task_id requis content requis — texte du commentaire |
Outils de planning
| Outil | Description | Paramètres |
|---|---|---|
ab_get_schedule |
Obtient votre planning pour la semaine en cours — regroupé en retard, à échéance aujourd'hui et à échéance cette semaine. | project_id optionnel — filtrer sur un projet précis |
Outils de documents (Wiki)
| Outil | Description | Paramètres |
|---|---|---|
ab_get_wiki_tree |
Obtient l'arborescence de navigation des Documents (dossiers et pages) d'un projet. | project_id requis |
ab_get_wiki_article |
Lit le contenu complet d'un document, ses métadonnées et ses informations de version. | project_id requis article_id requis — issu de ab_get_wiki_tree ou ab_search_wiki |
ab_search_wiki |
Liste les documents sous un chemin de dossier précis. | project_id requis parent_path optionnel — dossier à partir duquel lister (par défaut : / pour la racine) |
ab_create_wiki_article |
Crée un nouveau document en Markdown. Publie une notification dans le canal Teams lié. | project_id requis title requis content requis — Markdown parent_path optionnel — dossier, p. ex. / ou /Engineering (par défaut : /)tags optionnel — séparés par des virgules |
ab_update_wiki_article |
Met à jour un document existant. Crée une nouvelle version avec une note de modification et publie une notification dans le canal Teams. | project_id requis article_id requis content requis — Markdown mis à jour edit_note requis — ce qui a changé ; affiché dans l'historique des versions tags optionnel — tags mis à jour séparés par des virgules |
ab_add_wiki_comment |
Ajoute un commentaire à un document. | project_id requis article_id requis content requis — texte du commentaire |
Comment les modifications de l'IA restent visibles
Lorsqu'une tâche ou un document est créé, mis à jour ou terminé via un outil MCP, AB Projects effectue automatiquement les actions suivantes :
- Enregistre la modification dans l'historique des modifications de l'élément avec le nom de l'utilisateur et la note fournie
- Écrit une entrée de journal d'opération à des fins d'audit
- Publie ou met à jour une carte adaptative (Adaptive Card) dans le canal Microsoft Teams lié au projet, avec l'activité clairement signalée comme générée par l'IA
Ainsi, les modifications pilotées par l'IA bénéficient de la même visibilité et de la même traçabilité que les modifications effectuées directement dans l'application AB Projects ou l'onglet Teams. Pour savoir comment connecter un assistant, voir Connecter des assistants IA via MCP.