Outils MCP

Outil de requête central pour les agents qui décident sur quoi travailler. Filtre les tâches accessibles de l’utilisateur authentifié par projet, colonne, étiquette, responsable, statut, fenêtres de création ou d’échéance et priorité, avec un tri configurable. Utilisez created_after pour faire ressortir le nouveau travail. Renvoie une liste compacte prête à la décision. Chaque requête est limitée aux projets dont l’utilisateur est propriétaire ou membre.

Récupère tous les tableaux et leurs colonnes pour un projet donné. Nécessite l’appartenance au projet. Fournissez le nom du projet ou un mot-clé pour le localiser.

Liste les jalons d’un projet avec des informations de progression. Affiche pour chaque jalon son nom, ses dates, son nombre de tâches et son pourcentage d’achèvement. Utilisez-le pour trouver les jalons existants avant d’en créer ou d’affecter des tâches. Sans projet précisé, liste les jalons de tous les projets accessibles.

Récupère tous les projets dont l’utilisateur authentifié est membre. Renvoie les noms de projet, les rôles utilisateur (owner, admin, member ou guest), le nombre de membres et le type de plan du propriétaire du projet.

Liste tous les tableaux d’un projet, y compris l’id de chaque tableau, le nombre de colonnes et le nombre de tâches. Nécessite l’appartenance au projet. Utilisez-le pour découvrir les tableaux avant de créer des tâches ou un nouveau tableau. Fournissez le nom du projet ou un mot-clé pour localiser le projet.

Récupère les tâches affectées à l’utilisateur authentifié. Renvoie les noms, échéances, priorités, colonnes du tableau, état d’achèvement et liens directs vers chaque tâche.

Signale les changements récents dans les projets accessibles de l’utilisateur authentifié ; c’est l’outil qu’un agent interroge pour trier les nouveaux bugs. Renvoie trois sections compactes dans une fenêtre de temps : tâches nouvellement CREATED, tâches récemment UPDATED créées avant la fenêtre et COMMENTS récentes sur les tâches. Limité aux projets dont l’utilisateur est propriétaire ou membre.

Renvoie la tâche sur laquelle l’utilisateur authentifié a actuellement un minuteur actif (nom, numéro #, started_at, durée écoulée), ou un message clair indiquant qu’aucun minuteur n’est actif. Appelez cet outil avant StartStopTimetrackTool lorsque vous devez connaître l’état actuel plutôt que deviner depuis une bascule.

Récupère les détails complets d’une tâche précise, y compris description, responsables, listes de tâches, sous-tâches, dépendances et commentaires récents. Les tâches peuvent être trouvées par ID ou en recherchant leur nom et leur description.

Récupère les tâches dont les échéances arrivent dans le nombre de jours indiqué, 7 par défaut, y compris les tâches en retard. Les résultats sont limités aux projets auxquels l’utilisateur authentifié appartient.

Récupère les tâches actuellement en cours pour un coéquipier précis. Recherche les utilisateurs par nom dans tous les projets partagés. Si plusieurs utilisateurs correspondent, renvoie une liste avec les e-mails pour clarification. N’affiche que les tâches des colonnes de type "in progress" ou "progressing". Renvoie noms, priorités, colonnes et liens directs.

Récupère les tâches terminées aujourd’hui, ou à une date précise, dans tous les projets dont l’utilisateur est propriétaire ou membre. Indique qui a terminé chaque tâche et quand. Utile pour les standups, rapports d’avancement et mises à jour d’équipe.

Renvoie en un appel un aperçu compact du tableau entier afin qu’un agent puisse raisonner sur son état sans nombreux aller-retours. Liste chaque colonne dans l’ordre avec son type, son nombre de tâches et jusqu’à 5 tâches ouvertes, puis les totaux ouvertes et terminées. Limité à un projet dont l’utilisateur authentifié est propriétaire ou membre.

Recherche des tâches par mot-clé dans tous les projets dont l’utilisateur authentifié est membre. Cherche dans les noms et descriptions de tâches. Renvoie jusqu’à 20 résultats avec contexte de projet et informations de priorité.

Récupère le rapport de standup quotidien de l’utilisateur authentifié pour aujourd’hui, avec toutes les tâches associées et leurs commentaires. Renvoie le standup au format markdown.

Vérifie la connectivité au serveur Taskavel MCP. Renvoie une réponse pong confirmant la connexion ainsi que l’adresse e-mail de l’utilisateur authentifié.

Affecte, remplace ou retire les responsables d’une tâche. "assign" ajoute un utilisateur sans retirer les responsables existants, "replace" en fait le seul responsable et "remove" le retire. La personne ciblée doit appartenir au projet et l’utilisateur actif doit être propriétaire, administrateur ou membre.

Affecte ou retire des tâches d’un jalon. Actions : "assign" pour définir le jalon et "remove" pour l’effacer. Fonctionne sur une ou plusieurs tâches. Si le jalon n’existe pas, suggère de le créer. Nécessite le rôle propriétaire, administrateur ou membre.

Ajoute un commentaire à une tâche. Nécessite le rôle propriétaire, administrateur ou membre dans le projet. Les invités ne peuvent pas commenter.

Active ou désactive le fait que l’utilisateur appelant observe une tâche, c’est-à-dire soit abonné à ses notifications. Tout membre du projet peut observer une tâche.

Crée un nouveau jalon dans un projet. Les jalons regroupent les tâches liées et suivent la progression vers un objectif. Fournissez au minimum le projet et le nom du jalon. Nécessite le rôle propriétaire, administrateur ou membre.

Crée un projet complet en un appel. Passez seulement un nom pour obtenir un tableau par défaut, ou une structure complète conçue par vous-même (colonnes, jalons, tâches). L’agent appelant est le générateur ; cet outil persiste seulement la structure et n’exécute PAS le pipeline asynchrone de génération IA payant. Le créateur devient propriétaire du projet.

Crée un nouveau tableau dans un projet, éventuellement initialisé depuis un modèle. Nécessite le rôle propriétaire, administrateur ou membre. Les invités ne peuvent pas créer de tableaux. Fournissez au minimum le nom du projet et celui du tableau.

Crée une nouvelle étiquette dans un projet. Les étiquettes ont un nom, une couleur facultative et une description facultative. Nécessite le rôle propriétaire, administrateur ou membre.

Crée une nouvelle tâche dans un projet. Nécessite le rôle propriétaire, administrateur ou membre. Fournissez au minimum le nom du projet et celui de la tâche.

Définit ou efface la priorité d’une tâche. Utilisez priority_name, par exemple "High Priority", "Medium Priority" ou "Low Priority", ou priority_id pour définir, ou clear=true pour retirer la priorité. Nécessite le rôle propriétaire, administrateur ou membre.

Démarre ou arrête le suivi du temps sur une tâche. Passez `action: "stop"` pour arrêter explicitement : c’est une opération sans effet sûre qui ne démarre jamais de minuteur si cette tâche n’en a pas. Passez `action: "start"` pour démarrer explicitement : c’est sans effet si le minuteur de cette tâche est déjà actif. Démarrer un minuteur arrête toujours d’abord tout autre minuteur actif de cet utilisateur ; un seul minuteur fonctionne à la fois et la réponse nomme l’autre tâche. Omettez `action` pour l’ancien comportement de bascule : il arrête le minuteur si celui de cette tâche est actif, sinon en démarre un en arrêtant d’abord tout autre minuteur actif. Utilisez GetRunningTimerTool d’abord si vous devez connaître l’état avant de décider. Nécessite le rôle propriétaire, administrateur ou membre.

Déplace plusieurs tâches vers une colonne cible. Filtrez les tâches par nom de coéquipier, jalon ou colonne actuelle. Un administrateur ou propriétaire peut déplacer les tâches de tout membre. Si la colonne cible est introuvable, l’outil liste les colonnes disponibles. Nécessite le rôle propriétaire ou administrateur.

Déplace une tâche vers une autre colonne du tableau. Utile pour changer son état, par exemple de "To Do" à "In Progress" ou "Done". Nécessite le rôle propriétaire, administrateur ou membre.

Duplique une tâche, y compris ses listes de contrôle, étiquettes et responsables. La nouvelle tâche est nommée "(duplicated) <original name>" et appartient à l’utilisateur appelant. Nécessite le rôle propriétaire, administrateur ou membre.

Gère les listes de contrôle d’une tâche et leurs éléments. Une liste de contrôle regroupe des éléments légers à cocher. Utilisez action=create_checklist pour ajouter une liste, add_item pour ajouter un élément, toggle_item pour basculer un élément terminé ou non, et list pour lire toutes les listes avec leur progression. Nécessite le rôle propriétaire, administrateur ou membre.

Gère le rapport de standup quotidien de l’utilisateur authentifié. Ajoutez des tâches au standup du jour, définissez des commentaires par tâche ou un résumé. Crée le standup du jour s’il n’existe pas.

Gère les dépendances entre deux tâches. L’action "add" par défaut lie task_id et related_task_id réciproquement : un lien "blocked_by" sur task_id crée un lien "blocks" correspondant sur related_task_id, et inversement. L’action "remove" détache le lien dans les deux sens. Nécessite le rôle propriétaire, administrateur ou membre.

Gère les étiquettes d’une tâche. Actions : "add" attache des étiquettes sans retirer les existantes, "remove" détache des étiquettes précises et "set" remplace toutes les étiquettes. Fournissez tag_names ou tag_ids. Nécessite le rôle propriétaire, administrateur ou membre.

Gère les rappels d’une tâche. Utilisez action=add pour planifier un rappel, list pour lire les rappels de la tâche ou remove pour en supprimer un par id. Nécessite le rôle propriétaire, administrateur ou membre.

Gère les sous-tâches d’une tâche parente. Une sous-tâche est une tâche liée à sa parente. Utilisez action=create pour ajouter une sous-tâche, éventuellement avec une échéance, ou action=list pour lire les sous-tâches de la parente. Nécessite le rôle propriétaire, administrateur ou membre.

Invite un utilisateur à un projet par e-mail. Seuls les propriétaires et administrateurs peuvent inviter des membres. Les limites du plan gratuit s’appliquent, avec un maximum de 5 membres. Envoie un e-mail d’invitation à l’adresse indiquée.

Met à jour un jalon existant. Peut modifier le nom, la description, les dates et la couleur. Résolvez-le par milestone_id ou recherchez son nom dans un projet. Nécessite le rôle propriétaire, administrateur ou membre.

Met à jour une tâche existante. Prend en charge le renommage, la description, les échéances et le marquage terminé ou non. L’achèvement est validé contre les sous-tâches, éléments de liste de contrôle et dépendances bloquantes inachevés. Nécessite le rôle propriétaire, administrateur ou membre.

IMPORTANT : utilisez CET outil lorsque l’utilisateur veut répondre à un commentaire. comment_id est le numéro affiché comme #xxx dans l’interface Taskavel. Exemple : l’utilisateur dit "reply to comment #1276" : utilisez cet outil avec comment_id=1276. Prend en charge la mention d’utilisateurs par nom ou e-mail.

Téléverse une pièce jointe, comme une capture d’écran, un journal ou un PDF, vers une tâche. Envoyez les octets bruts encodés en base64 dans file_base64 avec un file_name incluant l’extension, par exemple "screenshot.png". Un préfixe URI de données tel que "data:image/png;base64,..." est accepté et retiré. Maximum 10 MB par fichier après décodage ; le fichier compte aussi dans le quota de stockage du propriétaire du projet. Extensions autorisées : images (jpg, jpeg, png, gif, webp, heic, svg), vidéo (mp4, mov, webm, ...), audio (mp3, wav, ogg), documents (pdf, txt, md, rtf, doc, docx, xls, xlsx, ppt, pptx) et archives (zip, rar, tar, gz). Utilisez-le pour joindre des preuves à une tâche. Nécessite le rôle propriétaire, administrateur ou membre ; les invités ne peuvent pas téléverser.

Archive une tâche (suppression réversible). La tâche est masquée des tableaux mais peut être restaurée plus tard ; elle n’est pas supprimée définitivement. Nécessite le rôle propriétaire, administrateur ou membre.

Retire un membre d’un projet. Seuls les propriétaires et administrateurs peuvent retirer des membres. Le propriétaire du projet ne peut pas être retiré.

Supprime définitivement une tâche DÉJÀ ARCHIVÉE. Cette action est irréversible. Elle reflète le flux corbeille puis vider la corbeille : archivez d’abord la tâche avec ArchiveTaskTool, puis purgez-la ici depuis l’archive. Les tâches actives ne peuvent pas être supprimées définitivement en une étape. Nécessite confirm:true et le rôle propriétaire, administrateur ou membre.

Supprime un jalon d’un projet. Les tâches affectées à ce jalon sont dissociées mais ne sont PAS supprimées. Nécessite le rôle propriétaire ou administrateur. Demandez confirmation à l’utilisateur avant suppression.

Supprime définitivement une étiquette d’un projet et la dissocie de toutes les tâches. Nécessite le rôle propriétaire, administrateur ou membre. Utilisez tag_id ou tag_name pour identifier l’étiquette.