Tâches

Open Source — GitScrum MCP Server est open source sous la licence MIT. Disponible sur npm et sur GitHub. Serveur Model Context Protocol pour GitScrum — Claude, GitHub Copilot, Cursor et tout client compatible MCP disposent d'un accès opérationnel complet à votre stack de gestion de projets.

L'outil task est l'outil le plus complet du serveur MCP de GitScrum. Avec 12 actions couvrant l'intégralité du cycle de vie des tâches, il gère tout, des listes de tâches personnelles et planifications quotidiennes au filtrage avancé, la duplication de tâches et les déplacements inter-projets. Chaque opération que votre équipe effectue sur le tableau Kanban, votre assistant IA peut l'exécuter en langage naturel.

Cet outil unique et consolidé remplace ce qui serait autrement des dizaines de points de terminaison API individuels. L'assistant IA détermine quelle action appeler en fonction de votre instruction en langage naturel, mappe votre intention aux paramètres corrects et retourne des résultats structurés sur lesquels vous pouvez agir immédiatement.

Aperçu des actions

Vues personnelles des tâches

Les actions my et today ne nécessitent aucun paramètre. Le serveur MCP vous identifie via votre session authentifiée et retourne les tâches sur tous vos projets.

my retourne chaque tâche qui vous est actuellement assignée, quel que soit le projet ou le statut. C'est l'équivalent d'ouvrir votre tableau de bord personnel des tâches dans l'application web GitScrum. Les résultats incluent le titre de la tâche, le nom du projet, le statut, la priorité, la date d'échéance et les assignés.

today restreint le périmètre aux tâches dues aujourd'hui ou explicitement planifiées pour aujourd'hui. C'est votre vue de planification quotidienne — les tâches qui nécessitent votre attention immédiate.

notifications récupère vos notifications liées aux tâches ainsi que le nombre de non-lus. Cela inclut les mentions, changements d'assignation, mises à jour de statut et commentaires sur vos tâches.

Vous :  "Qu'est-ce que j'ai à faire ?"
IA :    Appelle task action=my → retourne votre liste complète de tâches

Vous :  "Qu'est-ce que je dois terminer aujourd'hui ?"
IA :    Appelle task action=today → retourne les tâches du jour

Vous :  "Est-ce que j'ai de nouvelles notifications ?"
IA :    Appelle task action=notifications → retourne les notifications avec le nombre de non-lus

Créer des tâches

L'action create construit une nouvelle tâche en un seul appel. Tous les champs optionnels — sprint, user story, colonne, type, effort, assignés, labels, dates et estimations — peuvent être définis à la création. Aucun appel de mise à jour ultérieur n'est nécessaire.

Paramètres requis

Paramètres optionnels

Résolution intelligente des colonnes

Vous pouvez spécifier les colonnes par nom au lieu d'un ID numérique. Lorsque vous passez column: "In Progress", le serveur MCP récupère la configuration du workflow du projet, trouve la colonne correspondante par nom (insensible à la casse) et la résout vers le bon workflow_id. Si le nom de la colonne ne correspond à aucune colonne existante, le serveur retourne une erreur avec la liste des colonnes disponibles pour que l'assistant IA puisse suggérer des alternatives.

Exemples de prompts

Vous :  "Crée une tâche 'Corriger la validation du login' dans le projet backend"
IA :    Appelle task action=create avec title, project_slug, company_slug

Vous :  "Crée un bug 'Fuite mémoire dans le tableau de bord' assigné à @sarah dans le sprint en cours"
IA :    Appelle task action=create avec title, is_bug=true, usernames=["sarah"], sprint_slug

Vous :  "Ajoute une sous-tâche 'Écrire les tests unitaires' sous la tâche [uuid]"
IA :    Appelle task action=create avec title, parent_id=[uuid]

Vous :  "Crée une tâche haute priorité 'Déployer le hotfix' due demain avec 2h d'estimation"
IA :    Appelle task action=create avec title, effort_id, due_date, estimated_minutes=120

Mettre à jour des tâches

L'action update modifie n'importe quel champ d'une tâche existante. Seuls les champs que vous spécifiez sont modifiés — tous les autres champs restent inchangés.

Paramètres requis

Paramètres optionnels

Tous les paramètres optionnels de l'action create sont disponibles dans update, plus :

Le serveur MCP gère toute la résolution d'ID nécessaire lors des mises à jour. Si vous passez sprintslug, le serveur le résout en sprintid. Si vous passez column, le serveur le résout en workflow_id. Si vous passez usernames, le serveur les mappe aux IDs des membres.

Exemples de prompts

Vous :  "Déplace la tâche GS-123 dans la colonne Done"
IA :    Récupère la tâche par code → appelle task action=update avec column="Done"

Vous :  "Assigne @john et @maria à la tâche login"
IA :    Appelle task action=update avec usernames=["john","maria"]

Vous :  "Change la date d'échéance à vendredi prochain"
IA :    Appelle task action=update avec due_date="2026-02-13"

Vous :  "Marque la tâche de déploiement comme bloqueur"
IA :    Appelle task action=update avec is_blocker=true

Vous :  "Archive toutes les tâches terminées du dernier sprint"
IA :    Filtre les tâches terminées → appelle update avec is_archived=true pour chacune

Compléter des tâches

L'action complete marque une tâche comme terminée. C'est une action dédiée plutôt qu'une mise à jour avec changement de statut, car compléter une tâche peut déclencher des workflows supplémentaires — les métriques de sprint sont mises à jour, les notifications se déclenchent et les journaux d'activité enregistrent l'événement de complétion.

Vous :  "Complète la tâche [uuid]"
IA :    Appelle task action=complete avec uuid

Vous :  "Marque la tâche de migration API comme terminée"
IA :    Trouve la tâche par nom ou code → appelle task action=complete

Filtrer les tâches

L'action filter fournit une recherche avancée multi-champs parmi les tâches d'un projet. Combinez autant de critères de filtre que nécessaire pour affiner précisément les résultats.

Paramètres requis

Paramètres de filtre

L'action filter gère automatiquement la résolution titre-vers-ID. Lorsque vous passez workflow: "In Progress", le serveur recherche la colonne de workflow par nom et filtre par son ID numérique. La même logique s'applique aux labels, types, efforts, sprints et user stories — vous passez des noms lisibles, le serveur les résout.

Exemples de prompts

Vous :  "Filtre les tâches en cours assignées à @john"
IA :    Appelle task action=filter avec status="in-progress", users="john"

Vous :  "Montre-moi tous les bloqueurs du sprint en cours"
IA :    Appelle task action=filter avec is_blocker=true, sprint=[slug du sprint en cours]

Vous :  "Trouve les bugs non assignés créés cette semaine"
IA :    Appelle task action=filter avec unassigned=true, type="Bug", created_at="2026-02-02=2026-02-06"

Vous :  "Liste toutes les tâches haute priorité avec le label 'frontend'"
IA :    Appelle task action=filter avec effort="High", labels="frontend"

Vous :  "Montre les tâches clôturées le mois dernier"
IA :    Appelle task action=filter avec closed_at="2026-01-01=2026-01-31"

Rechercher des tâches par code

Chaque tâche dans GitScrum possède un code lisible comme PROJ-123. L'action by_code récupère une tâche en utilisant ce code au lieu du UUID. C'est particulièrement utile dans les conversations où les membres de l'équipe référencent les tâches par leur code court.

Vous :  "Trouve la tâche PROJ-456"
IA :    Appelle task action=by_code avec task_code="PROJ-456"

Vous :  "Quel est le statut de AUTH-89 ?"
IA :    Appelle task action=by_code → retourne les détails complets de la tâche incluant le statut

Dupliquer des tâches

L'action duplicate clone une tâche avec toutes ses propriétés — titre, description, labels, type, effort et placement dans la colonne. C'est utile pour créer des tâches similaires sans ressaisir tous les champs, ou pour mettre en place des éléments de travail récurrents.

Vous :  "Duplique la tâche [uuid]"
IA :    Appelle task action=duplicate → retourne la nouvelle tâche clonée

Vous :  "Clone la tâche de rapport hebdomadaire pour la semaine prochaine"
IA :    Trouve la tâche → appelle task action=duplicate

Déplacer des tâches

L'action move transfère une tâche vers un autre projet et/ou une autre colonne de workflow. Cela nécessite le slug du projet cible et l'ID de la colonne de workflow cible, car différents projets peuvent avoir des configurations de workflow différentes.

Vous :  "Déplace la tâche GS-123 vers le projet Frontend"
IA :    Résout le slug du projet + workflow → appelle task action=move

Vous :  "Transfère la tâche API vers la colonne Done dans le projet Backend"
IA :    Appelle task action=move avec new_project_slug et new_workflow_id

Sous-tâches

L'action subtasks liste toutes les tâches enfants d'une tâche parent donnée. Combinée avec le paramètre parent_id de l'action create, vous pouvez construire des hiérarchies de tâches complètes en langage naturel.

Vous :  "Montre les sous-tâches de la tâche de migration"
IA :    Appelle task action=subtasks → retourne la liste des tâches enfants

Vous :  "Décompose la tâche de déploiement en : tester le staging, mettre à jour les configs, exécuter la migration"
IA :    Appelle task action=create trois fois avec parent_id défini sur le UUID de la tâche de déploiement

Workflow recommandé

Pour les équipes adoptant la gestion de tâches pilotée par MCP, ce workflow maximise l'efficacité :

1. Découvrir le contexte du projet

Avant de créer des tâches, récupérez les métadonnées du projet dont votre assistant IA a besoin pour les opérations suivantes.

Vous :  "Montre-moi les workflows, types et efforts du projet Backend"
IA :    Appelle project action=workflows, types, efforts → met en cache les IDs pour les opérations sur les tâches

2. Créer des tâches avec un contexte complet

Utilisez les métadonnées mises en cache pour créer des tâches entièrement configurées en un seul appel.

Vous :  "Crée un bug haute priorité 'Timeout de connexion sur mobile' dans le projet Backend,
         assigne à @sarah, ajoute au sprint en cours, label 'mobile' et 'auth'"
IA :    Un seul appel create avec tous les champs remplis

3. Suivre le travail quotidien

Utilisez les vues personnelles pour rester au courant de votre charge de travail.

Vous :  "Qu'est-ce que j'ai à faire aujourd'hui ?"
IA :    Appelle task action=today → affiche votre liste quotidienne de tâches

4. Filtrer et examiner

Utilisez le filtrage avancé pour les revues de sprint, les standups d'équipe ou le suivi de progression.

Vous :  "Montre toutes les tâches en cours pour ce sprint"
IA :    Appelle task action=filter avec status et sprint

5. Compléter et itérer

Marquez les tâches comme terminées et vérifiez la progression du sprint.

Vous :  "Complète la correction du timeout de connexion"
IA :    Appelle task action=complete → met à jour les métriques du sprint

Résolution automatique du contexte

L'outil task supporte la résolution automatique du contexte. Si l'assistant IA connaît déjà votre espace de travail et projet depuis un appel précédent dans la même conversation, il peut reporter ce contexte. Cela signifie que vous n'avez pas besoin de répéter « dans le projet Backend » pour chaque opération sur les tâches — l'assistant IA se souvient du contexte du projet depuis plus tôt dans la conversation.

Lorsqu'une tâche est créée, mise à jour ou récupérée, le serveur MCP retourne des métadonnées de contexte (companyslug, projectslug, task_uuid) que l'assistant IA utilise pour les opérations suivantes.

Étapes suivantes

• Sprints : Planifiez et suivez les sprints qui contiennent vos tâches.
• Projets : Gérez les paramètres des projets, workflows et membres d'équipe.
• Suivi du temps : Démarrez des chronomètres et enregistrez du temps sur les tâches.
• Démarrage rapide : Configurez le serveur MCP si ce n'est pas déjà fait.