Configuration

Configurez le serveur MCP de GitScrum pour Claude Desktop, GitHub Copilot, Cursor, Windsurf et autres clients IA compatibles MCP.

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.

Ce guide couvre la configuration détaillée pour chaque client MCP supporté, les variables d'environnement, l'utilisation avec Docker, les arguments personnalisés et les étapes de vérification. Si vous avez suivi le Démarrage rapide et avez besoin d'options de configuration plus avancées, ceci est votre référence.

Claude Desktop

Claude Desktop lit sa configuration MCP depuis un fichier JSON sur votre système de fichiers local.

Emplacement du fichier de configuration

Plateforme	Chemin
macOS	`~/Library/Application Support/Claude/claudedesktopconfig.json`
Windows	`%APPDATA%\Claude\claudedesktopconfig.json`

Si le fichier n'existe pas, créez-le manuellement. Assurez-vous que les répertoires parents existent.

Configuration minimale

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

Ceci indique à Claude Desktop de démarrer le serveur MCP de GitScrum via npx, qui télécharge et exécute automatiquement la dernière version.

Ajout à une configuration existante

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

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

Avec une installation globale

Si vous avez installé le serveur globalement avec npm install -g @gitscrum-studio/mcp-server, référencez directement le binaire :

{
  "mcpServers": {
    "gitscrum": {
      "command": "gitscrum-mcp-server"
    }
  }
}

Avec des variables d'environnement

Pour transmettre des variables d'environnement au processus du serveur MCP :

{
  "mcpServers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"],
      "env": {
        "GITSCRUM_API_URL": "https://services.gitscrum.com"
      }
    }
  }
}

Appliquer les modifications

Redémarrez Claude Desktop après avoir modifié le fichier de configuration. Claude Desktop lit la configuration uniquement au démarrage. Après le redémarrage, les outils GitScrum apparaissent automatiquement dans la liste d'outils de Claude.

VS Code avec GitHub Copilot

GitHub Copilot lit les configurations de serveurs MCP depuis un fichier JSON dans votre espace de travail ou vos paramètres utilisateur.

Configuration d'espace de travail (par projet)

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

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

Cette configuration s'applique uniquement à l'espace de travail actuel. Les membres de l'équipe qui ouvrent le même projet auront également le serveur MCP de GitScrum configuré automatiquement si le fichier est versionné.

Configuration au niveau utilisateur (globale)

Pour rendre le serveur MCP de GitScrum disponible dans tous les espaces de travail VS Code, ajoutez-le à vos paramètres utilisateur VS Code. Ouvrez les paramètres (Ctrl+, / Cmd+,), recherchez « mcp » et ajoutez la configuration du serveur. Alternativement, modifiez settings.json :

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

Vérification

Après avoir enregistré la configuration :

Ouvrez le panneau GitHub Copilot Chat
Tapez : « Liste mes espaces de travail GitScrum »
Copilot devrait invoquer le serveur MCP et retourner les données de votre espace de travail

Si les outils n'apparaissent pas, rechargez la fenêtre : Ctrl+Shift+P → « Developer: Reload Window ».

Cursor

Cursor supporte les serveurs MCP via son système de configuration.

Emplacement du fichier de configuration

Plateforme	Chemin
macOS	`~/.cursor/mcp.json`
Windows	`%USERPROFILE%\.cursor\mcp.json`
Linux	`~/.cursor/mcp.json`

Configuration

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

Via l'interface des paramètres Cursor

Alternativement, naviguez vers Paramètres Cursor → MCP et ajoutez un nouveau serveur :

Nom : gitscrum
Commande : npx
Arguments : -y @gitscrum-studio/mcp-server

Appliquer les modifications

Redémarrez Cursor après avoir modifié la configuration. Les outils GitScrum apparaissent dans la liste d'outils du panneau IA de Cursor.

Windsurf

Windsurf lit la configuration MCP depuis son fichier de paramètres.

Configuration

Ajoutez à votre configuration MCP Windsurf :

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

Redémarrez Windsurf après l'enregistrement pour activer le serveur.

Continue (VS Code / JetBrains)

Continue supporte les serveurs MCP via son fichier de configuration.

Fichier de configuration

Modifiez ~/.continue/config.json et ajoutez le serveur GitScrum au tableau mcpServers :

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

Si vous avez déjà d'autres serveurs MCP dans le tableau, ajoutez l'entrée GitScrum :

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

Variables d'environnement

Le serveur MCP de GitScrum reconnaît les variables d'environnement suivantes :

Variable	Valeur par défaut	Description
`GITSCRUM_TOKEN`	(aucune)	Remplacer l'authentification stockée par un token API direct. Contourne le flux OAuth Device Grant.
`GITSCRUMAPIURL`	`https://services.gitscrum.com`	Remplacer le point de terminaison API. Pour le développement et les tests uniquement.

Définir les variables d'environnement

Dans la configuration du client (recommandé pour les paramètres par serveur) :

{
  "mcpServers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"],
      "env": {
        "GITSCRUM_TOKEN": "your-token-here"
      }
    }
  }
}

Au niveau du shell (s'applique à tous les processus) :

# macOS/Linux
export GITSCRUM_TOKEN=your-token-here

# Windows PowerShell
$env:GITSCRUM_TOKEN = "your-token-here"

# Windows CMD
set GITSCRUM_TOKEN=your-token-here

Important : GITSCRUM_TOKEN contourne le flux OAuth sécurisé. Utilisez-le uniquement dans les pipelines CI/CD ou les environnements automatisés où l'authentification via le navigateur n'est pas pratique. Pour l'utilisation interactive, utilisez toujours le flux OAuth Device Grant.

Utilisation avec Docker

Si vous exécutez des environnements de développement dans des conteneurs Docker, vous pouvez inclure le serveur MCP dans votre configuration Docker.

Dockerfile

FROM node:18-alpine

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

ENTRYPOINT ["gitscrum-mcp-server"]

Docker Compose avec montage de volume

Pour persister l'authentification entre les redémarrages de conteneur, montez le répertoire de tokens :

services:
  mcp:
    image: node:18-alpine
    command: npx -y @gitscrum-studio/mcp-server
    volumes:
      - ~/.gitscrum:/root/.gitscrum

Docker avec variable d'environnement

Pour les environnements conteneurisés, transmettez directement le token :

services:
  mcp:
    image: node:18-alpine
    command: npx -y @gitscrum-studio/mcp-server
    environment:
      - GITSCRUM_TOKEN=${GITSCRUM_TOKEN}

Note : Lors de l'exécution dans Docker, le flux OAuth Device Grant peut ne pas fonctionner comme prévu puisque le serveur MCP s'exécute à l'intérieur du conteneur mais le navigateur est sur l'hôte. Utilisez GITSCRUM_TOKEN pour les environnements Docker.

Arguments serveur personnalisés

Le serveur MCP accepte les arguments de ligne de commande suivants :

Argument	Description
`--version`	Affiche la version du serveur et quitte
`--help`	Affiche les arguments disponibles

Vérifier la version installée

npx -y @gitscrum-studio/mcp-server --version

Vérifier la connexion

Après avoir configuré votre client, vérifiez que le serveur MCP fonctionne correctement.

Étape 1 : Vérifier le démarrage du serveur

Demandez à votre assistant IA :

Vérifie le statut d'authentification GitScrum

Si le serveur fonctionne, vous obtiendrez une réponse sur votre état d'authentification (soit « authentifié » soit « non authentifié »).

Étape 2 : S'authentifier

Si vous n'êtes pas authentifié, connectez-vous :

Connexion à GitScrum

Complétez le flux OAuth dans le navigateur tel que décrit dans Authentification.

Étape 3 : Tester une opération de lecture

Après l'authentification, testez avec une lecture simple :

Liste mes espaces de travail GitScrum

Vous devriez voir les noms de vos espaces de travail. Cela confirme :

Le serveur MCP fonctionne
L'authentification est opérationnelle
La connexion API est valide
Votre compte dispose d'un accès aux espaces de travail

Étape 4 : Tester une opération d'écriture

Créez une tâche de test pour vérifier l'accès en écriture :

Crée une tâche appelée "Test du serveur MCP" dans [nom de votre projet]

Si la tâche est créée avec succès, votre serveur MCP est pleinement opérationnel.

Mise à jour du serveur MCP

Avec npx (automatique)

Si vous utilisez npx -y @gitscrum-studio/mcp-server dans votre configuration, les mises à jour sont automatiques. Chaque fois que le serveur MCP démarre, npx vérifie la dernière version et la télécharge si une version plus récente est disponible.

Pour forcer une mise à jour vers la dernière version :

npx -y @gitscrum-studio/mcp-server@latest --version

Avec une installation globale

Si vous avez installé globalement, mettez à jour manuellement :

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

Vérifiez votre version actuelle :

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

Verrouillage de version

Pour figer une version spécifique (utile pour les équipes qui ont besoin d'un comportement cohérent) :

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

Remplacez 1.2.3 par le numéro de version souhaité. Cela empêche les mises à jour automatiques et garantit que tous les membres de l'équipe utilisent la même version.

Résumé de la configuration

Référence rapide pour tous les clients supportés :

Client	Fichier de configuration	Clé de configuration	Redémarrage requis
Claude Desktop (macOS)	`~/Library/Application Support/Claude/claudedesktopconfig.json`	`mcpServers`	Oui
Claude Desktop (Windows)	`%APPDATA%\Claude\claudedesktopconfig.json`	`mcpServers`	Oui
VS Code (espace de travail)	`.vscode/mcp.json`	`servers`	Recharger la fenêtre
VS Code (global)	`settings.json` utilisateur	`mcp.servers`	Recharger la fenêtre
Cursor (macOS/Linux)	`~/.cursor/mcp.json`	`mcpServers`	Oui
Cursor (Windows)	`%USERPROFILE%\.cursor\mcp.json`	`mcpServers`	Oui
Windsurf	Paramètres MCP Windsurf	`mcpServers`	Oui
Continue	`~/.continue/config.json`	`mcpServers` (tableau)	Dépend du client

Tous les clients utilisent la même commande de serveur MCP :

npx -y @gitscrum-studio/mcp-server

Dépannage de la configuration

Erreurs de syntaxe JSON

Les fichiers de configuration doivent contenir du JSON valide. Erreurs courantes :

Virgules en fin de ligne après la dernière propriété d'un objet
Guillemets manquants autour des clés ou des valeurs de chaîne
Guillemets simples au lieu de guillemets doubles

Utilisez un validateur JSON ou le mode de langage JSON de votre éditeur pour détecter les erreurs de syntaxe avant l'enregistrement.

Problèmes de cache npx

Si npx ne récupère pas la nouvelle version :

# Vider le cache npx
npx clear-npx-cache

# Ou spécifier explicitement la dernière version
npx -y @gitscrum-studio/mcp-server@latest

Erreurs de permissions sur le fichier de token

Si le serveur MCP ne peut pas lire ou écrire ~/.gitscrum/auth.json :

# macOS/Linux : Corriger les permissions
mkdir -p ~/.gitscrum
chmod 700 ~/.gitscrum
chmod 600 ~/.gitscrum/auth.json

# Windows PowerShell : Vérifier que vous êtes propriétaire du fichier
Get-Acl "$env:USERPROFILE\.gitscrum\auth.json" | Format-List

Node.js introuvable

Si le client signale que npx ou node est introuvable, assurez-vous que Node.js est dans votre PATH système. Certains clients (notamment les applications de bureau) peuvent ne pas hériter du PATH de votre shell. Vous pouvez fournir le chemin complet vers npx :

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

Sous Windows, utilisez le chemin complet :

{
  "mcpServers": {
    "gitscrum": {
      "command": "C:\\Program Files\\nodejs\\npx.cmd",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Utiliser MCP Inspector pour le débogage

L'outil MCP Inspector vous permet d'interagir directement avec le serveur MCP, en contournant le client IA :

npx @modelcontextprotocol/inspector node dist/index.js

Cela ouvre un inspecteur dans le navigateur où vous pouvez appeler individuellement les outils et voir les réponses brutes. Utile pour vérifier que le serveur fonctionne indépendamment de la configuration de votre client IA.

Étapes suivantes

Démarrage rapide : Installation accélérée et premières commandes.
Authentification : Plongée dans le flux OAuth 2.0 Device Grant.
Sécurité : Modèle de sécurité enterprise et bonnes pratiques.
Présentation du MCP : Référence complète des outils avec les 29 outils et plus de 160 opérations.