GitScrum / Docs

Discussions

Gestion des discussions via MCP. Créez et gérez des fils de discussion thématiques pour la communication de projet, les prises de décision et le partage de connaissances.

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 discussion fournit 6 actions pour créer et gérer des fils de discussion thématiques au sein de vos projets. Les discussions sont l'alternative structurée aux messages de chat éparpillés — elles gardent les décisions architecturales, les revues de design, les propositions de fonctionnalités et les conversations d'équipe organisées et consultables dans le contexte du projet.

Chaque discussion vit à l'intérieur d'un projet, supporte les commentaires en fil de discussion et peut être ouverte ou fermée à mesure que les sujets sont résolus. Votre assistant IA peut créer des discussions, publier des commentaires, suivre les fils ouverts et clôturer les sujets résolus — le tout en langage naturel dans votre IDE ou client IA.


Aperçu des actions

ActionObjectifParamètres requis
listLister toutes les discussions d'un projetcompanyslug, projectslug
getObtenir les détails complets d'une discussionuuid, companyslug, projectslug
createCréer un nouveau fil de discussioncompanyslug, projectslug, title
updateModifier le titre, la description ou le statut d'une discussionuuid, companyslug, projectslug
comment_listLister tous les commentaires d'une discussiondiscussionuuid, companyslug, project_slug
comment_createAjouter un commentaire à un fil de discussiondiscussionuuid, companyslug, project_slug, comment

Lister les discussions

L'action list retourne toutes les discussions d'un projet. Vous pouvez optionnellement filtrer par statut pour voir uniquement les fils ouverts ou fermés. Chaque discussion dans la réponse inclut son uuid, titre, statut, date de création et auteur — fournissant le contexte nécessaire pour les opérations suivantes.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace (depuis l'outil workspace)
project_slugstringIdentifiant du projet (depuis l'outil project)

Paramètres optionnels

ParamètreTypeDescription
statusstringFiltrer par statut : open ou closed
You:  "Liste toutes les discussions du projet Backend"
AI:   Appelle discussion action=list → retourne tous les fils de discussion

You:  "Montre-moi les discussions ouvertes du projet Mobile App"
AI:   Appelle discussion action=list avec status="open" → retourne les fils actifs

You:  "Y a-t-il des discussions clôturées sur la refonte de l'API ?"
AI:   Appelle discussion action=list avec status="closed" → l'IA filtre par sujet

Obtenir les détails d'une discussion

L'action get retourne l'objet discussion complet — titre, description, statut, auteur, date de création et métadonnées. C'est le point de départ lorsque vous avez besoin du contexte complet d'un fil spécifique.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la discussion (depuis la réponse list)
company_slugstringIdentifiant du workspace
project_slugstringIdentifiant du projet
You:  "Montre-moi les détails de la discussion sur le design de l'API"
AI:   Trouve la discussion par titre → appelle discussion action=get → retourne les données complètes du fil

You:  "Qu'a-t-on décidé lors de la discussion sur la revue d'architecture ?"
AI:   Appelle discussion action=get → retourne la description et le contexte

Créer des discussions

L'action create démarre un nouveau fil de discussion au sein d'un projet. Chaque discussion nécessite un titre ; la description est optionnelle mais recommandée pour fournir du contexte aux participants.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace
project_slugstringIdentifiant du projet
titlestringTitre de la discussion — clair et descriptif

Paramètres optionnels

ParamètreTypeDescription
descriptionstringCorps de la discussion au format Markdown. Utilisez-le pour cadrer le sujet, lister les options ou fournir un contexte d'arrière-plan.

Exemples de prompts

You:  "Lance une discussion sur la stratégie d'authentification API dans le projet Backend"
AI:   Appelle discussion action=create avec title="API Authentication Strategy",
      description avec le contexte du sujet

You:  "Crée une discussion 'Database Migration Plan' avec des détails sur
       le calendrier de migration PostgreSQL vers CockroachDB"
AI:   Appelle discussion action=create avec le titre et une description Markdown

You:  "Ouvre un fil sur la checklist de lancement de l'application mobile"
AI:   Appelle discussion action=create avec title="Mobile App Launch Checklist"

Mettre à jour les discussions

L'action update modifie le titre, la description ou le statut d'une discussion existante. Seuls les champs que vous spécifiez sont modifiés — tout le reste reste inchangé. Clôturer une discussion signale que le sujet est résolu.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID de la discussion
company_slugstringIdentifiant du workspace
project_slugstringIdentifiant du projet

Paramètres optionnels

ParamètreTypeDescription
titlestringTitre de la discussion mis à jour
descriptionstringCorps de la discussion mis à jour (Markdown)
statusstringChanger le statut : open ou closed
You:  "Clôture la discussion sur l'authentification API — on a décidé d'utiliser OAuth2"
AI:   Trouve la discussion → appelle discussion action=update avec status="closed"

You:  "Mets à jour le titre de la discussion sur la migration en 'Database Migration Plan v2'"
AI:   Appelle discussion action=update avec title="Database Migration Plan v2"

You:  "Rouvre la discussion sur la stratégie de déploiement"
AI:   Appelle discussion action=update avec status="open"

Commentaires sur les discussions

Les commentaires forment la conversation en fil au sein d'une discussion. Chaque commentaire supporte le formatage Markdown, permettant du contenu riche incluant des blocs de code, des liens et du texte formaté.

Lister les commentaires

L'action comment_list retourne tous les commentaires d'une discussion par ordre chronologique.

ParamètreTypeDescription
discussion_uuidstringUUID de la discussion (requis)
company_slugstringIdentifiant du workspace (requis)
project_slugstringIdentifiant du projet (requis)
You:  "Montre tous les commentaires sur la discussion d'architecture"
AI:   Appelle discussion action=comment_list → retourne les commentaires en fil

You:  "Qu'a dit l'équipe sur la refonte de l'API ?"
AI:   Trouve la discussion → appelle comment_list → résume la conversation

Créer des commentaires

L'action comment_create ajoute un nouveau commentaire à une discussion existante. Les commentaires supportent le Markdown complet — blocs de code, listes à puces, liens et texte formaté.

ParamètreTypeDescription
discussion_uuidstringUUID de la discussion (requis)
company_slugstringIdentifiant du workspace (requis)
project_slugstringIdentifiant du projet (requis)
commentstringCorps du commentaire au format Markdown (requis)
You:  "Ajoute un commentaire à la discussion API : 'Après analyse des benchmarks,
       je recommande d'utiliser GraphQL pour l'API publique'"
AI:   Appelle discussion action=comment_create avec le commentaire Markdown

You:  "Publie les avantages et inconvénients de chaque option de base de données dans le fil de migration"
AI:   Appelle discussion action=comment_create avec une liste Markdown formatée

You:  "Commente la discussion d'architecture avec les notes de la réunion d'aujourd'hui"
AI:   Appelle discussion action=comment_create avec les notes de réunion en Markdown

Workflow de communication en fil

Les discussions fonctionnent au mieux lorsqu'elles sont combinées avec d'autres outils MCP pour créer un processus de prise de décision structuré :

1. Lancer la conversation

Créez une discussion avec un cadrage clair et un contexte d'arrière-plan.

You:  "Crée une discussion 'Auth Strategy for v3 API' dans le projet Backend.
       Inclus le contexte sur notre configuration JWT actuelle et le besoin de supporter OAuth2."
AI:   Crée la discussion avec le titre et une description Markdown détaillée

2. Recueillir les avis

Les membres de l'équipe ajoutent des commentaires avec leurs analyses et recommandations.

You:  "Ajoute un commentaire avec mon analyse : OAuth2 + PKCE pour le mobile, API keys
       pour serveur-à-serveur, cookies de session pour le dashboard web"
AI:   Publie un commentaire formaté avec la recommandation technique

3. Revoir le fil

Résumez les commentaires pour synthétiser les contributions de l'équipe.

You:  "Résume les commentaires sur la discussion de stratégie d'authentification"
AI:   Appelle comment_list → génère un résumé concis de toutes les positions

4. Résoudre et agir

Clôturez la discussion et créez des tâches basées sur la décision.

You:  "Clôture la discussion sur la stratégie d'authentification et crée des tâches pour implémenter
       l'approche OAuth2 sur laquelle on s'est mis d'accord"
AI:   Met à jour le statut de la discussion à closed → crée des tâches à partir de la décision

Résolution automatique du contexte

L'outil discussion supporte la résolution automatique du contexte. Si votre assistant IA connaît déjà le workspace et le projet depuis un appel précédent dans la conversation, il conserve ce contexte. Vous pouvez dire « liste les discussions » sans spécifier le projet à chaque fois, tant que le contexte a été établi au préalable.


Prochaines étapes

  • Commentaires : Gérez les commentaires sur les tâches pour la collaboration opérationnelle.
  • Wiki : Construisez des bases de connaissances de projet pour la documentation à long terme.
  • Tâches : Créez des tâches à partir des résultats des discussions.
  • Démarrage rapide : Configurez le serveur MCP si ce n'est pas déjà fait.