Présentation du MCP
Le serveur MCP de GitScrum offre aux assistants IA un accès opérationnel complet à votre stack de gestion de projets via le Model Context Protocol.
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.
Le serveur MCP de GitScrum connecte les assistants IA à votre espace de travail GitScrum via le Model Context Protocol. Il expose 29 outils avec plus de 160 opérations réparties en 6 catégories, offrant à votre assistant IA les mêmes capacités opérationnelles que celles utilisées quotidiennement par votre équipe dans l'application web GitScrum — gestion des tâches, planification de sprints, suivi du temps, CRM, analytiques et bien plus.
Tout ce que votre équipe fait dans l'application web GitScrum, votre assistant IA peut désormais le faire par conversation en langage naturel.
Qu'est-ce que le Model Context Protocol ?
Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA d'interagir avec des outils externes et des sources de données de manière structurée et sécurisée. Au lieu de copier-coller des données entre votre outil de gestion de projet et votre assistant IA, MCP crée un pont direct.
Avec le serveur MCP de GitScrum en cours d'exécution, votre assistant IA peut :
- Interroger vos espaces de travail, projets et tâches en temps réel
- Créer et mettre à jour des tâches, sprints, user stories et epics
- Suivre le temps, générer des rapports de standup et consulter les analytiques
- Gérer les clients, factures et propositions via le CRM ClientFlow
- Rechercher dans l'ensemble de votre stack de gestion de projets
Tout cela se fait en langage naturel. Vous posez une question à votre assistant IA ou lui donnez une instruction, et il appelle les outils MCP GitScrum appropriés en arrière-plan.
Pourquoi utiliser MCP pour la gestion de projets
La gestion de projet traditionnelle nécessite un changement de contexte constant — ouvrir des onglets de navigateur, parcourir des tableaux de bord, remplir des formulaires. MCP élimine cette friction en permettant à votre assistant IA de gérer le travail opérationnel pendant que vous restez concentré sur l'essentiel.
Opérations en langage naturel. Au lieu de naviguer dans des menus pour créer une tâche, dites « Crée un bug haute priorité dans le projet Auth pour le problème de timeout de connexion » et l'assistant IA gère le mappage des champs, la sélection du projet et la création de la tâche.
Intelligence inter-outils. Votre assistant IA peut corréler les données entre les outils. Demandez « Quels projets dépassent le budget et ont des tâches en retard ? » et il interroge le suivi budgétaire, les filtres de tâches et les données de sprint en une seule conversation.
Automatisation sans scripts. Des workflows complexes qui nécessiteraient des scripts API deviennent conversationnels. « Crée un sprint pour la semaine prochaine, ajoute les 5 premières tâches du backlog et assigne-les à l'équipe frontend » exécute plusieurs opérations séquentiellement.
Visibilité pour toute l'équipe. Tout membre de l'équipe disposant d'un client compatible MCP peut interagir avec les mêmes données de projet. Développeurs, managers et parties prenantes bénéficient tous d'un accès conversationnel au stack de gestion de projets.
Catégories d'outils
Le serveur MCP de GitScrum organise ses 29 outils en six catégories. Chaque outil utilise un paramètre action consolidé, réduisant les tokens de contexte LLM d'environ 80 % par rapport à des définitions d'outils individuelles.
Core
Les outils fondamentaux pour les opérations quotidiennes de gestion de projet.
| Outil | Actions clés | Objectif |
|---|---|---|
task | my today get create update complete subtasks filter by_code duplicate move notifications | Gestion complète du cycle de vie des tâches |
sprint | list all get kpis create update stats reports progress metrics | Planification et suivi des sprints |
workspace | list get | Navigation dans les espaces de travail |
project | list get stats tasks workflows types efforts labels members | Configuration et données des projets |
time | active start stop logs analytics team reports productivity timeline | Suivi du temps et productivité |
Planning
Outils pour le grooming du backlog, le story mapping et la configuration des workflows.
| Outil | Actions clés | Objectif |
|---|---|---|
user_story | list get create update all | Gestion des user stories |
epic | list create update | Planification au niveau des epics |
label | list create update attach detach toggle | Taxonomie des labels |
task_type | list create update assign | Configuration des types de tâches |
workflow | create update | Étapes du workflow Kanban |
Collaboration
Outils pour la communication d'équipe, la documentation et la gestion des connaissances.
| Outil | Actions clés | Objectif |
|---|---|---|
discussion | all channels channel messages send search unread markread createchannel update_channel | Messagerie d'équipe et canaux |
comment | list add update | Commentaires sur les tâches et éléments |
wiki | list get create update search | Documentation de projet |
note | list get create update share revisions | Notes personnelles et partagées |
note_folder | list create update move | Organisation des notes |
search | — | Recherche en texte intégral sur toutes les données |
ClientFlow CRM
Outils de gestion de la relation client, facturation et propositions.
| Outil | Actions clés | Objectif |
|---|---|---|
client | list get create update contacts interactions add_interaction | Gestion des clients |
invoice | list get stats create update issue send mark_paid | Cycle de vie des factures |
proposal | list get stats create update send approve reject convert | Gestion des propositions |
clientflow_dashboard | 8 rapports | Analytiques et reporting CRM |
clientflowcrossworkspace | 4 rapports | Données CRM inter-espaces de travail |
Insights PRO
Analytiques avancées, automatisation des standups et suivi budgétaire.
| Outil | Actions clés | Objectif |
|---|---|---|
standup | summary completed blockers team stuck digest contributors | Rapports de standup automatisés |
analytics | 10 rapports | Analytiques du tableau de bord manager |
activity | feed userfeed notifications activities taskworkflow | Fil d'activité et piste d'audit |
budget | projectsatrisk overview consumption burn_down alerts events | Suivi budgétaire et alertes |
Authentification
Outils de gestion sécurisée des sessions.
| Outil | Description |
|---|---|
auth_login | Initier le flux OAuth 2.0 device code |
auth_complete | Compléter l'autorisation via le navigateur |
auth_status | Vérifier la session en cours et la validité du token |
auth_logout | Effacer les identifiants stockés localement |
Clients supportés
Le serveur MCP de GitScrum fonctionne avec tout client implémentant le Model Context Protocol. Clients testés et vérifiés :
| Client | Plateforme | Configuration |
|---|---|---|
| Claude Desktop | macOS, Windows | claudedesktopconfig.json |
| GitHub Copilot | VS Code | .vscode/mcp.json |
| Cursor | macOS, Windows, Linux | Paramètres MCP de Cursor |
| Windsurf | macOS, Windows, Linux | Paramètres MCP de Windsurf |
| Continue | VS Code, JetBrains | Configuration Continue |
Tous les clients utilisent le même binaire du serveur MCP. La seule différence est l'emplacement et le format du fichier de configuration pour chaque client.
Modèle de sécurité
Le serveur MCP de GitScrum est conçu autour du principe du moindre privilège avec plusieurs couches de protection.
| Couche | Protection |
|---|---|
| Opérations | Uniquement CREATE, READ, UPDATE. DELETE est bloqué aux niveaux MCP et API. |
| Authentification | OAuth 2.0 Device Grant (RFC 8628) — les identifiants ne transitent jamais par le serveur MCP. |
| Transport | Communication exclusivement HTTPS avec TLS 1.2 minimum. |
| Stockage des tokens | Système de fichiers local (~/.gitscrum/auth.json) avec permissions restreintes. |
| Limitation de débit | Verrouillage automatique après des tentatives d'authentification échouées. |
Aucune opération DELETE. C'est un choix de conception délibéré. Les assistants IA ne doivent pas pouvoir détruire définitivement les données de projet. Toutes les opérations destructives doivent être effectuées via l'application web GitScrum Studio, où une confirmation humaine est requise.
Exemples de conversations
Voici des exemples pratiques de ce que vous pouvez accomplir en langage naturel :
Vous : "Qu'est-ce que j'ai à faire aujourd'hui ?"
IA : Récupère vos tâches du jour sur tous les projets.
Vous : "Crée un sprint pour la semaine prochaine avec les 5 premières tâches du backlog"
IA : Crée le sprint, assigne les tâches et définit le calendrier.
Vous : "Montre-moi quels projets dépassent le budget"
IA : Retourne les données de burn-down et signale les projets à risque.
Vous : "Envoie la proposition Q1 à Acme Corp"
IA : Crée la proposition, associe le client et l'envoie.
Vous : "Qu'est-ce que l'équipe a livré cette semaine ?"
IA : Génère un résumé de standup avec le travail accompli et les blocages.Architecture
Le serveur MCP s'exécute comme un processus local sur votre machine. Il communique avec les clients IA via le Model Context Protocol (transport stdio) et avec l'API de GitScrum via HTTPS.
┌────────────────┐ MCP (stdio) ┌──────────────┐ HTTPS ┌─────────────┐
│ Assistant IA │ ◄──────────────────► │ Serveur MCP │ ◄───────────► │ API GitScrum│
│ (Claude, etc) │ │ (local) │ │ (cloud) │
└────────────────┘ └──────────────┘ └─────────────┘- L'assistant IA envoie des appels d'outils via le protocole MCP
- Le serveur MCP valide les requêtes, gère l'authentification et transmet à l'API GitScrum
- L'API GitScrum traite la requête avec un contrôle d'accès complet et retourne des données structurées
Le serveur est sans état entre les sessions, à l'exception du token d'authentification stocké localement. Aucune donnée de projet n'est mise en cache ou stockée sur le disque.
Prérequis
| Prérequis | Minimum |
|---|---|
| Node.js | 18.0.0 ou supérieur |
| npm | 8.0.0 ou supérieur |
| Compte GitScrum | Plan gratuit ou payant |
| Client MCP | Tout client compatible MCP |
Étapes suivantes
- Démarrage rapide : Installez et authentifiez-vous en moins de 5 minutes.
- Configuration : Configuration détaillée pour Claude Desktop, GitHub Copilot, Cursor et autres clients.
- Authentification : Plongée dans le flux OAuth 2.0 Device Grant.
- Sécurité : Modèle de sécurité enterprise, gestion des erreurs et bonnes pratiques.