Démarrage rapide

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.

Mettez en route le serveur MCP de GitScrum en moins de 5 minutes. À la fin de ce guide, votre assistant IA aura un accès complet à vos espaces de travail, projets, tâches, sprints GitScrum et bien plus.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Si Node.js n'est pas installé, téléchargez-le depuis nodejs.org. La version LTS est recommandée.

Installation

Option 1 : Exécuter avec npx (recommandé)

Aucune installation nécessaire. Le serveur MCP s'exécute directement via npx, qui télécharge et lance automatiquement la dernière version :

npx -y @gitscrum-studio/mcp-server

Cette approche est recommandée car :

• Utilise toujours la dernière version
• Aucun package global à maintenir
• Aucune mise à jour manuelle requise
• Fonctionne immédiatement sur tous les systèmes d'exploitation

Option 2 : Installation globale

Si vous préférez une installation persistante :

npm install -g @gitscrum-studio/mcp-server

Après l'installation globale, le binaire du serveur est disponible sous le nom gitscrum-mcp-server dans votre PATH. Pour mettre à jour ultérieurement :

npm update -g @gitscrum-studio/mcp-server

Configurer votre client

Choisissez votre client IA et ajoutez le serveur MCP de GitScrum à sa configuration.

Claude Desktop

Localisez le fichier de configuration de Claude Desktop :

• macOS : ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows : %APPDATA%\Claude\claudedesktopconfig.json

Si le fichier n'existe pas, créez-le. Ajoutez la configuration suivante :

{
  "mcpServers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Si vous avez déjà d'autres serveurs MCP configurés, ajoutez l'entrée "gitscrum" dans l'objet "mcpServers" existant :

{
  "mcpServers": {
    "existing-server": { ... },
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Redémarrez Claude Desktop après avoir enregistré le fichier de configuration. Les outils GitScrum apparaissent automatiquement dans la liste d'outils de Claude.

VS Code avec GitHub Copilot

Créez ou modifiez .vscode/mcp.json à la racine de votre projet :

{
  "servers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Cette configuration s'applique à l'espace de travail actuel. Pour un accès global sur tous les projets, ajoutez-la plutôt à vos paramètres utilisateur VS Code.

Après l'enregistrement, GitHub Copilot détecte automatiquement le serveur MCP. Vous pouvez vérifier en ouvrant le chat Copilot et en posant une question sur votre espace de travail GitScrum.

Cursor

Ouvrez les paramètres de Cursor et naviguez vers la section MCP, ou modifiez directement le fichier de configuration :

• macOS : ~/.cursor/mcp.json
• Windows : %USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Redémarrez Cursor après l'enregistrement. Les outils GitScrum apparaissent dans la liste d'outils de Cursor.

Windsurf

Ajoutez ce qui suit à votre configuration MCP Windsurf :

{
  "mcpServers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Continue (VS Code / JetBrains)

Ajoutez GitScrum à votre fichier de configuration Continue (~/.continue/config.json) :

{
  "mcpServers": [
    {
      "name": "gitscrum",
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  ]
}

S'authentifier

La première fois que vous interagissez avec le serveur MCP de GitScrum, vous devez vous authentifier. Le serveur utilise le OAuth 2.0 Device Authorization Grant — un flux sécurisé basé sur le navigateur.

Étape par étape

1. Demandez à votre assistant IA de se connecter. Tapez quelque chose comme :

`` Connexion à GitScrum ``

1. L'assistant IA appelle auth_login et retourne une URL de vérification et un code utilisateur. Vous verrez un message comme :

`` Ouvrez cette URL dans votre navigateur : https://gitscrum.com/device Entrez le code : ABCD-1234 ``

1. Ouvrez l'URL dans votre navigateur et entrez le code affiché. Connectez-vous à votre compte GitScrum si nécessaire, puis approuvez la demande d'accès.

1. Demandez à votre assistant IA de compléter l'authentification :

`` Complète la connexion GitScrum ``

1. L'IA appelle auth_complete et confirme que votre session est active. Votre token d'authentification est stocké localement à ~/.gitscrum/auth.json.

À partir de ce moment, le serveur MCP s'authentifie automatiquement. Les tokens se rafraîchissent en arrière-plan, vous n'aurez donc pas besoin de vous reconnecter sauf si vous vous déconnectez explicitement ou si le token expire.

Vérifier votre session

À tout moment, demandez à votre assistant IA :

Vérifie mon statut d'authentification GitScrum

L'outil auth_status retourne l'état de votre session actuelle, y compris l'utilisateur authentifié et l'accès aux espaces de travail.

Vos premières commandes

Maintenant que vous êtes authentifié, essayez ces commandes pour explorer les capacités du serveur MCP :

Explorer votre espace de travail

Liste mes espaces de travail GitScrum

Retourne tous les espaces de travail auxquels vous avez accès, avec leurs slugs et détails.

Voir vos tâches

Montre mes tâches pour aujourd'hui

Récupère les tâches qui vous sont assignées et qui sont dues ou planifiées pour aujourd'hui, sur tous les projets.

Obtenir un aperçu du projet

Montre-moi les projets de mon espace de travail

Liste tous les projets de votre espace de travail actuel avec les statistiques et les membres de l'équipe.

Créer une tâche

Crée une tâche appelée "Mettre à jour la documentation API" dans le projet Backend avec une priorité haute

Crée une nouvelle tâche avec le titre, le projet et la priorité spécifiés.

Vérifier la progression du sprint

Comment se passe le sprint en cours ?

Retourne les KPIs du sprint, les métriques de progression et les données de burndown pour le sprint actif.

Démarrer un chronomètre

Commence à suivre le temps sur la tâche PROJ-42

Démarre une session de suivi du temps sur la tâche spécifiée.

Obtenir un résumé de standup

Qu'est-ce que l'équipe a terminé hier ?

Génère un résumé de standup avec le travail accompli, les blocages et l'activité des contributeurs.

Ce qui est disponible

Voici une référence rapide de ce que vous pouvez faire via le serveur MCP :

Dépannage

« Command not found » ou échec de npx

Vérifiez que Node.js est installé en version 18+ :

node --version

Si la version est inférieure à 18, mettez à jour Node.js depuis nodejs.org.

Le serveur MCP n'apparaît pas dans le client

• Claude Desktop : Redémarrez l'application après avoir modifié le fichier de configuration. Vérifiez que la syntaxe JSON est valide.
• VS Code : Assurez-vous que le fichier .vscode/mcp.json est à la racine de l'espace de travail. Rechargez la fenêtre (Ctrl+Shift+P → « Reload Window »).
• Cursor : Redémarrez Cursor après avoir modifié le fichier de configuration.

Échec de l'authentification

• Assurez-vous d'avoir ouvert la bonne URL de vérification dans un navigateur où vous êtes connecté à GitScrum.
• Entrez le code exactement tel qu'affiché (y compris le tiret).
• Complétez le flux dans le navigateur dans les 15 minutes — les codes d'appareil expirent.
• Si le code a expiré, relancez auth_login pour obtenir un nouveau code.

Erreurs « Unauthorized » après l'authentification

Votre token a peut-être expiré. Demandez à votre assistant IA :

Déconnecte-toi de GitScrum et reconnecte-toi

Cela efface le token stocké et initie un nouveau flux d'authentification.

Limitation de débit

Si vous recevez des erreurs 429, le serveur est soumis à une limitation de débit. Attendez quelques minutes avant de faire des requêtes supplémentaires. Les limites de débit se réinitialisent automatiquement.

Étapes suivantes

• Configuration : Configuration avancée pour tous les clients, Docker, variables d'environnement et arguments personnalisés.
• Authentification : Plongée dans le flux OAuth 2.0 Device Grant, gestion des tokens et sécurité.
• Sécurité : Modèle de sécurité enterprise, restrictions d'opérations et bonnes pratiques.
• Présentation du MCP : Référence complète des outils avec les 29 outils et plus de 160 opérations.