GitHub MCP Server : le guide complet du serveur officiel (version 2.0)

Publié le · Développement & SDK · 4 min de lecture

Par Amir N., éditeur de serveurmcp.com · Mis à jour le 8 octobre 2026

GitHub MCP Server est le serveur MCP officiel de GitHub. Il permet à votre assistant d’IA de lire le code, de gérer issues et pull requests, de suivre GitHub Actions ou d’analyser les alertes de sécurité, directement depuis la conversation.

Sa version 2.0, publiée le 6 octobre 2026, ajoute des sorties typées pour les clients compatibles avec la révision 2026-07-28 du protocole. Ce guide couvre l’installation, la configuration et les bonnes pratiques.

GitHub MCP Server en bref

  • Éditeur : GitHub, serveur officiel et open source.
  • Deux versions : un serveur distant hébergé par GitHub, à l’adresse https://api.githubcopilot.com/mcp/, ou un serveur local, en image Docker ou en binaire.
  • Connexion : OAuth ou jeton d’accès personnel (PAT).
  • Contrôle : groupes d’outils activables à la carte et mode lecture seule.

Les nouveautés de la version 2.0

La version 2.0 type les entrées et les sorties de ses outils, et ajoute des schémas de sortie. GitHub vise les agents qui pratiquent le Code Mode ou l’appel d’outils programmatique : ils exploitent mieux une réponse dont la structure est connue d’avance.

Ces schémas ne sont annoncés qu’aux clients qui déclarent la révision 2026-07-28 du protocole MCP ou une plus récente. La version 2.0.1, publiée le 7 octobre, corrige le chemin du module Go, désormais github.com/github/github-mcp-server/v2.

Serveur distant ou serveur local ?

Critère Serveur distant Serveur local
Hébergement Par GitHub Sur votre machine, en Docker ou en binaire
Connexion OAuth, selon le client, ou PAT Connexion OAuth au premier lancement, ou PAT
GitHub Enterprise Server Non pris en charge Pris en charge
Mises à jour Gérées par GitHub À faire vous-même

Attention aux anciens tutoriels : le paquet npm @modelcontextprotocol/server-github est déprécié depuis avril 2025. Utilisez le serveur officiel de GitHub.

Installer GitHub MCP Server

Dans Claude Code

Version distante, avec un jeton :

claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer VOTRE_PAT"

Version locale, avec connexion OAuth dans le navigateur au premier lancement, sans jeton à créer :

claude mcp add github -e GITHUB_OAUTH_CALLBACK_PORT=8085 -- docker run -i --rm -p 127.0.0.1:8085:8085 -e GITHUB_OAUTH_CALLBACK_PORT ghcr.io/github/github-mcp-server

Version locale, avec un jeton :

claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=VOTRE_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Dans VS Code

Le dépôt officiel propose des boutons d’installation en un clic, pour la version distante comme pour la version locale. Activez ensuite le mode Agent de Copilot Chat pour démarrer le serveur.

Dans Claude Desktop

La version locale se déclare dans claude_desktop_config.json :

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "VOTRE_PAT" }
    }
  }
}

Le validateur de configuration vérifie ce fichier, et notre guide pour ajouter un serveur MCP à Claude détaille les autres options.

Choisir ses outils

Le serveur regroupe ses outils par ensembles. N’activez que ceux dont vous avez besoin : l’assistant choisit mieux ses outils, et la surface de risque diminue.

Ensemble Rôle
context Informations sur l’utilisateur et son contexte GitHub, fortement recommandé
repos Dépôts, fichiers et commits
issues Lecture et gestion des issues
pull_requests Lecture et gestion des pull requests
actions Workflows GitHub Actions et CI/CD
code_security Alertes de sécurité, comme le code scanning

La liste se passe avec l’option --toolsets, ou la variable GITHUB_TOOLSETS avec Docker :

github-mcp-server --toolsets repos,issues,pull_requests,actions,code_security

L’option --tools active des outils précis. Le mode lecture seule, avec --read-only ou GITHUB_READ_ONLY=1, écarte tous les outils d’écriture, même ceux demandés explicitement.

Cinq usages concrets

  • Trier : « Résume les issues ouvertes étiquetées bug et propose un ordre de priorité. »
  • Relire : « Relis la pull request 42 et liste les risques de régression. »
  • Déboguer la CI : « Pourquoi le dernier workflow GitHub Actions a-t-il échoué ? »
  • Sécuriser : « Liste les alertes de code scanning critiques et propose un correctif. »
  • Documenter : « Crée une issue à partir de ce message d’erreur, avec les étapes pour reproduire. »

Bonnes pratiques de sécurité

  • Préférez OAuth : aucun jeton à stocker. Avec un PAT, créez un jeton à portée fine, limité aux dépôts nécessaires.
  • Activez la lecture seule pour l’exploration et l’analyse.
  • Ne commitez jamais un jeton : GitHub recommande une variable d’environnement et un fichier .env exclu de Git.
  • Méfiez-vous du contenu des issues publiques : un texte malveillant peut tenter de détourner l’assistant.

Notre checklist de sécurité MCP complète ces règles.

Questions fréquentes

GitHub MCP Server est-il gratuit ?

Le serveur est open source. Sa version distante s’utilise avec votre compte GitHub, par OAuth ou avec un jeton.

Quelle est l’adresse du serveur GitHub MCP distant ?

https://api.githubcopilot.com/mcp/.

Peut-on utiliser GitHub MCP Server en lecture seule ?

Oui, avec l’option --read-only ou la variable GITHUB_READ_ONLY=1.

Le paquet @modelcontextprotocol/server-github fonctionne-t-il encore ?

Il est déprécié depuis avril 2025. Utilisez le serveur officiel de GitHub, en version distante ou locale.

Qu’apporte la version 2.0 ?

Des entrées et sorties typées, avec des schémas de sortie réservés aux clients compatibles avec la révision 2026-07-28 du protocole.

Sources

D’autres serveurs sont classés par usage dans notre sélection 2026.

Recevez gratuitement le guide complet du MCP

Une newsletter simple, sans spam. Désinscription en un clic.