GitScrum / Docs

Activité

Gestion du flux d'activité via MCP. Suivez et surveillez toutes les activités du projet, les changements et les actions de l'équipe dans des flux d'activité en temps réel.

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 activity fournit 5 actions pour surveiller les flux d'activité du projet à chaque niveau — des changements de tâches individuelles aux flux d'événements à l'échelle de l'espace de travail. Chaque action effectuée par votre équipe dans GitScrum génère un enregistrement d'activité, et le serveur MCP donne à votre assistant IA un accès complet à cette piste d'audit via des requêtes en langage naturel.

Les flux d'activité capturent les mises à jour de tâches, les changements de statut, les commentaires, les assignations, les actions de sprint et tous les autres événements du projet. Que vous ayez besoin d'un aperçu rapide de ce qui s'est passé en votre absence ou d'une piste d'audit complète pour la conformité, l'outil activity fournit le périmètre et la granularité appropriés.


Aperçu des actions

ActionObjectifParamètres requis
projectFlux d'activité d'un projet spécifiquecompanyslug, projectslug
taskHistorique d'activité d'une tâche spécifiquetaskuuid, companyslug, project_slug
userFlux d'activité d'un utilisateur spécifiquecompany_slug
workspaceFlux d'activité de l'ensemble de l'espace de travailcompany_slug
feedFlux d'activité agrégé avec événements combinéscompany_slug

Activité du projet

L'action project retourne le flux d'activité d'un projet spécifique — toutes les mises à jour de tâches, changements de statut, commentaires, événements de sprint et actions de l'équipe au sein de ce projet. Les résultats sont triés chronologiquement avec l'activité la plus récente en premier.

Paramètres

ParamètreTypeDescription
company_slugstringIdentifiant de l'espace de travail (requis)
project_slugstringIdentifiant du projet (requis)
pageintegerNuméro de page pour la pagination (optionnel)
per_pageintegerRésultats par page (optionnel)
You:  "Montre l'activité récente du projet Backend"
AI:   Appelle activity action=project → retourne le flux d'activité chronologique

You:  "Que s'est-il passé sur le projet Backend aujourd'hui ?"
AI:   Appelle activity action=project → l'IA filtre les entrées du jour

You:  "Y a-t-il eu des changements de statut sur le projet Mobile App cette semaine ?"
AI:   Appelle activity action=project → l'IA filtre les événements de changement de statut

Activité d'une tâche

L'action task retourne l'historique complet d'activité d'une tâche spécifique — chaque changement, commentaire, assignation, transition de statut et mise à jour depuis la création de la tâche. C'est la piste d'audit complète d'un élément de travail individuel.

Paramètres

ParamètreTypeDescription
task_uuidstringUUID de la tâche (requis)
company_slugstringIdentifiant de l'espace de travail (requis)
project_slugstringIdentifiant du projet (requis)
You:  "Que s'est-il passé sur la tâche PROJ-42 ?"
AI:   Recherche la tâche par code → appelle activity action=task
      → retourne l'historique complet de la tâche avec tous les changements

You:  "Montre-moi l'historique complet de la tâche d'intégration des paiements"
AI:   Résout la tâche → appelle activity action=task
      → retourne la liste chronologique de tous les événements

You:  "Qui a changé la priorité de PROJ-42 ?"
AI:   Appelle activity action=task → l'IA identifie l'événement de changement de priorité et l'auteur

You:  "Quand cette tâche a-t-elle été passée en En cours ?"
AI:   Appelle activity action=task → l'IA trouve l'événement de changement de statut avec l'horodatage

Activité d'un utilisateur

L'action user retourne le flux d'activité d'un membre de l'équipe spécifique — toutes ses actions à travers les projets de l'espace de travail. Utile pour comprendre les contributions individuelles, préparer des évaluations de performance ou suivre ce sur quoi un collègue a travaillé.

Paramètres

ParamètreTypeDescription
company_slugstringIdentifiant de l'espace de travail (requis)
usernamestringNom d'utilisateur de la personne ciblée (optionnel — utilise l'utilisateur courant par défaut)
pageintegerNuméro de page pour la pagination (optionnel)
You:  "Sur quoi John a-t-il travaillé ?"
AI:   Appelle activity action=user avec username="john"
      → retourne l'activité récente de John à travers tous les projets

You:  "Montre mon activité récente"
AI:   Appelle activity action=user → retourne votre propre flux d'activité

You:  "Qu'a fait Sarah sur le projet Backend la semaine dernière ?"
AI:   Appelle activity action=user avec username="sarah"
      → l'IA filtre les résultats sur le projet Backend et la période de la semaine dernière

Activité de l'espace de travail

L'action workspace retourne le flux d'activité de l'ensemble de l'espace de travail — chaque événement de chaque projet. Cela fournit la vue la plus large de l'activité organisationnelle, utile pour les administrateurs d'espace de travail et les managers supervisant plusieurs projets.

Paramètres

ParamètreTypeDescription
company_slugstringIdentifiant de l'espace de travail (requis)
pageintegerNuméro de page pour la pagination (optionnel)
per_pageintegerRésultats par page (optionnel)
You:  "Montre le flux d'activité de l'espace de travail"
AI:   Appelle activity action=workspace → retourne le flux d'activité inter-projets

You:  "Que se passe-t-il sur tous les projets en ce moment ?"
AI:   Appelle activity action=workspace → l'IA résume l'activité récente par projet

You:  "Y a-t-il eu des changements critiques dans l'espace de travail aujourd'hui ?"
AI:   Appelle activity action=workspace → l'IA filtre les événements à fort impact

Flux agrégé

L'action feed retourne un flux d'activité combiné et agrégé qui fusionne les événements de multiples sources en un flux unifié. Similaire à workspace mais optimisé pour la consultation — les événements sont regroupés et dédupliqués pour faciliter le parcours.

Paramètres

ParamètreTypeDescription
company_slugstringIdentifiant de l'espace de travail (requis)
You:  "Montre-moi le flux d'activité"
AI:   Appelle activity action=feed → retourne le flux d'activité agrégé

You:  "Donne-moi un résumé de ce que l'équipe a fait aujourd'hui"
AI:   Appelle activity action=feed → l'IA résume et regroupe par membre ou par projet

Patterns de surveillance de l'activité

Les flux d'activité servent différents objectifs selon votre rôle et contexte. Voici les patterns de surveillance courants :

Rattrapage quotidien

Lorsque vous commencez votre journée, utilisez le flux du projet ou de l'espace de travail pour voir ce qui s'est passé en votre absence.

You:  "Que s'est-il passé sur le projet Backend depuis hier ?"
AI:   Appelle activity action=project → l'IA filtre les événements depuis hier
      → "12 événements : 3 tâches complétées, 2 nouvelles tâches créées, 4 commentaires,
         2 changements de statut, 1 mise à jour de sprint"

Investigation d'une tâche

Lorsque vous avez besoin de comprendre pourquoi une tâche est dans son état actuel, l'activité de la tâche fournit l'historique complet.

You:  "Pourquoi PROJ-42 est-elle bloquée ?"
AI:   Appelle activity action=task → examine l'historique pour les événements de blocage
      → "PROJ-42 a été déplacée en Bloqué il y a 2 jours par Sarah.
         Commentaire : 'En attente des identifiants d'accès à l'API tierce'"

Revue de performance de l'équipe

Utilisez les flux d'activité utilisateur pour préparer les réunions 1:1 ou les évaluations de performance.

You:  "Résume les contributions de Mike ce mois-ci"
AI:   Appelle activity action=user avec username="mike"
      → l'IA agrège : tâches complétées, PR revues, commentaires ajoutés

You:  "Compare les niveaux d'activité de l'équipe cette semaine"
AI:   Appelle activity action=workspace → l'IA regroupe par utilisateur et compte les actions

Surveillance des changements

Suivez des types spécifiques de changements à travers l'espace de travail pour la gouvernance ou la conformité.

You:  "Y a-t-il eu des tâches supprimées cette semaine ?"
AI:   Appelle activity action=workspace → l'IA filtre les événements de suppression

You:  "Qui a effectué des changements sur le Sprint 14 ?"
AI:   Appelle activity action=project → l'IA filtre les événements liés au sprint

Cas d'utilisation de la piste d'audit

Les données d'activité servent de piste d'audit complète pour vos projets. Scénarios d'audit courants :

  • Reporting de conformité. Exportez les données d'activité pour démontrer qui a changé quoi et quand. Chaque action inclut un horodatage, un acteur et une description du changement.
  • Investigation d'incidents. Lorsque quelque chose tourne mal, remontez l'historique d'activité pour identifier la cause racine — ce qui a changé, qui l'a changé et quand.
  • Documentation des décisions. L'activité des tâches capture les commentaires et changements de statut qui documentent le raisonnement derrière les décisions. Utilisez activity action=task pour reconstituer la chronologie décisionnelle.
  • Analyse de la charge de travail. Agrégez les données d'activité utilisateur pour comprendre la répartition du travail au sein de l'équipe. Identifiez les membres surchargés ou sous-utilisés.

Pagination

Pour les projets avec un volume d'activité élevé, les résultats sont paginés. Utilisez les paramètres page et per_page pour naviguer dans les résultats. L'assistant IA gère automatiquement la pagination lorsque vous demandez des données complètes.

You:  "Montre-moi toute l'activité du projet Backend ce mois-ci"
AI:   Appelle activity action=project → parcourt les résultats page par page si nécessaire
      → retourne le résumé d'activité consolidé

Prochaines étapes

  • Analytics : Accédez aux rapports structurés de santé et de performance du projet.
  • Standup : Consultez les standups quotidiens avec les flux d'activité.
  • Budget : Surveillez l'activité financière et les changements de budget.
  • Tâches : Gérez les tâches qui génèrent les événements d'activité.