Protocole MCP (Model Context Protocol)

Connectez Copilot à des outils et données externes via des serveurs MCP (Model Context Protocol).

Dans cet article

Présentation du Model Context Protocol (MCP)

Le protocole MCP (Model Context Protocol) est une norme ouverte qui définit la façon dont les applications partagent le contexte avec de grands modèles de langage (LLMs). MCP fournit un moyen standardisé de connecter des modèles IA à différentes sources de données et outils, leur permettant ainsi de travailler ensemble plus efficacement.

Vous pouvez utiliser MCP pour étendre les capacités de GitHub Copilot en l'intégrant à un large éventail d’outils et de services existants. MCP fonctionne sur toutes les surfaces principales Copilot , que vous travailliez dans un IDE, en utilisant GitHub Copilot CLI, en travaillant dans le GitHub Copilot appou en déléguant des tâches à un agent sur GitHub.com. Vous pouvez également utiliser MCP pour créer de nouveaux outils et services qui fonctionnent avec Copilot, ce qui vous permet de personnaliser et d’améliorer votre expérience.

Par exemple, vous pouvez connecter un outil de suivi des problèmes afin que Copilot puisse rechercher un bogue tout en travaillant sur un correctif, sans vous demander de copier le problème dans la conversation.

Pour plus d’informations sur MCP, consultez la documentation officielle MCP. Pour obtenir la liste organisée des serveurs MCP des partenaires et de la communauté, consultez le GitHub Registre MCP.

Les entreprises et les organisations peuvent choisir d’activer ou de désactiver l’utilisation de MCP pour les membres de leur organisation ou de leur entreprise via la stratégie Serveurs MCP dans Copilot. Cette politique est désactivée par défaut. Consultez Gestion des stratégies et fonctionnalités pour GitHub Copilot dans votre entreprise et Gestion des stratégies et des fonctionnalités pour GitHub Copilot dans votre organisation. La stratégie MCP s’applique uniquement aux utilisateurs qui disposent d’un abonnement Copilot Business ou Copilot Enterprise provenant d’une organisation ou d’une entreprise qui configure la stratégie. Copilot Free, Copilot Pro, Copilot Pro+, ou Copilot Maxn’ont pas leur accès à MCP régi par cette stratégie.

MCP complète le contexte que vous fournissez via des invites, des fichiers et des instructions. Il ajoute des connexions à des outils et des données, plutôt que de remplacer des instructions sur le fonctionnement de l’agent. Pour obtenir des conseils sur les prompts et la gestion du contexte, consultez Prompts et contexte pour GitHub Copilot.

Connectez un service une fois via des serveurs MCP vérifiés GitHub(connecteurs), puis utilisez la connexion entre les interfaces prises en charge Copilot sans refaire la configuration ni vous connecter séparément dans chacune d’elles. Ces connexions fonctionnent également dans des sessions s’exécutant dans un bac à sable cloud Copilot, mais pas dans les sessions exécutées sur GitHub Actions. Consultez « connecteurs Copilot ».

Où vous pouvez utiliser MCP

La configuration mcP dépend de l’emplacement où vous utilisez Copilot:

  • Le GitHub Copilot app : Vous pouvez utiliser des serveurs MCP configurés pour votre référentiel ou dans votre configuration locale Copilot. Vous pouvez également découvrir et installer d’autres serveurs MCP à partir de l’onglet Personnaliser .
  • Copilot CLI: GitHub Copilot CLI prend en charge les serveurs MCP locaux et distants. Le GitHub serveur MCP est intégré et disponible sans configuration supplémentaire.
  • Copilot cloud agent (y compris automations) et Copilot code review: GitHub.com prend en charge les serveurs MCP configurés au niveau du référentiel. La configuration s’applique à Copilot cloud agent, automations et Copilot code review. Le serveur MCP GitHub et le serveur MCP Playwright sont configurés par défaut.
  • IDEs : les serveurs MCP sont pris en charge dans Visual Studio Code, Visual Studio, IDE JetBrains, Xcode et Eclipse. Les options de connexion et d’authentification dépendent de l’IDE. Consultez « Étendre GitHub Copilot Chat avec des serveurs MCP (Model Context Protocol) ».

Chat sur GitHub.com a des outils préconfigurés, tels que des outils pour la création de branches et la recherche de code. Ceci est distinct des paramètres MCP du référentiel pour Copilot cloud agent et Copilot code review. Consultez « GitHub Copilot sur GitHub.com et GitHub Mobile ».

MCP pour Copilot cloud agent

Les sections suivantes décrivent les valeurs par défaut et la configuration MCP pour Copilot cloud agent, y compris automations. Les paramètres MCP au niveau du référentiel s’appliquent également à Copilot code review, comme indiqué ci-dessous. Pour d’autres surfaces, utilisez les guides de configuration dans Next steps.

Serveurs MCP par défaut

Copilot cloud agent commence par deux serveurs MCP configurés :

  • GitHub fournit l’accès aux données du dépôt, telles que les tickets et les pull requests. Par défaut, il utilise un jeton spécialement délimité avec un accès en lecture seule au dépôt actuel. L’accès à des ressources en dehors de ce référentiel nécessite de configurer explicitement des informations d’identification avec un accès plus large.
  • Playwright fournit des outils pour lire, interagir et prendre des captures d’écran de pages web. Par défaut, il peut uniquement accéder aux ressources web dans le propre environnement de l’agent via localhost ou 127.0.0.1.

Ces valeurs par défaut sont spécifiques à l’environnement cloud. Par exemple, Copilot CLI inclut le GitHub serveur MCP sans configuration supplémentaire, mais vous configurez d’autres serveurs séparément.

Serveurs MCP personnels

Les serveurs MCP personnels se connectent Copilot à des outils et des données pour votre propre flux de travail. Configurez un serveur une fois pour le rendre disponible dans chaque session cloud que vous démarrez. Ces serveurs sont disponibles uniquement pour vous et n’affectent pas les autres utilisateurs qui travaillent dans le même référentiel.

Avant de configurer un serveur MCP personnel, vérifiez si le service dont vous avez besoin est couvert par des serveurs MCP vérifiés par GitHub (connecteurs). GitHub- Les serveurs MCP vérifiés sont disponibles dans les sessions cloud et locales, et GitHub gère la configuration et l’authentification du serveur MCP pour vous. En revanche, les serveurs MCP personnels prennent uniquement en charge l’authentification basée sur des clés et ne sont disponibles que dans les environnements de bac à sable dans le cloud. Consultez « connecteurs Copilot ».

Utilisez des serveurs MCP personnels pour les connexions souhaitées entre les référentiels ou qui nécessitent vos propres informations d’identification. Pour fournir une configuration partagée pour les collaborateurs travaillant dans un référentiel particulier, utilisez plutôt la configuration au niveau du référentiel .

  1. Accédez à votre Copilot page d’accueil à github.com/copilot.
  2. Dans le menu de gauche, cliquez sur le menu Personnaliser .
  3. Vérifiez si le service dont vous avez besoin est couvert par un serveur MCP vérifié par GitHub.
  4. Si un GitHubserveur MCP vérifié ne couvre pas vos besoins et que vous souhaitez configurer votre propre serveur MCP, sélectionnez le menu déroulant Ajouter, puis cliquez sur serveur MCP.
  5. Entrez le nom du serveur, le type de transport, l’URL ou la commande de démarrage, ainsi que d’autres configurations requises.
  6. Si l’authentification est requise, créez des secrets dans Personal MCP server secrets avec des noms commençant par COPILOT_MCP_, comme COPILOT_MCP_API_KEY, et référencez-les dans la configuration du serveur.
  7. Cliquez sur Ajouter un serveur.

Par défaut, les secrets de serveur MCP personnels sont disponibles dans les sessions associées à votre compte personnel. Vous pouvez également autoriser leur utilisation dans certaines organisations sélectionnées afin d’y utiliser vos serveurs authentifiés.

Limitations

  • Les serveurs MCP personnels sont disponibles dans chaque session cloud. Vous ne pouvez pas choisir actuellement les serveurs à activer pour une session individuelle.
  • Les serveurs HTTP et SSE MCP personnalisés ne prennent pas en charge les paramètres de requête dans leurs URL. Transmettez ces valeurs en tant qu’en-têtes de requête à la place.
  • Si un serveur n’est pas disponible, vérifiez sa configuration et vérifiez que les secrets requis existent et sont disponibles pour le compte ou l’organisation où la session s’exécute.
  • Vous pouvez utiliser jusqu’à 50 serveurs MCP au total dans les configurations au niveau personnel et au niveau du dépôt.

Configuration au niveau du dépôt

Les serveurs MCP au niveau du dépôt connectent Copilot aux outils et aux données pour le travail dans un dépôt spécifique. Les administrateurs de référentiel configurent ces serveurs dans les paramètres de référentiel sur GitHub.com, et la configuration est disponible pour toute personne disposant d’un accès en écriture au référentiel. Ces paramètres s’appliquent à la fois à Copilot in the cloud (y compris automations) et à Copilot code review. Vous pouvez désactiver l’utilisation de l’outil MCP pour la révision du code séparément.

Utilisez la configuration au niveau du référentiel lorsque les collaborateurs ont besoin des mêmes outils, tels qu’un suivi des problèmes partagés ou un service de documentation. Pour les serveurs qui nécessitent une authentification, utilisez un compte de service pour Copilot plutôt que des informations d’identification personnelles. Les serveurs au niveau du référentiel ne peuvent pas référencer les secrets de serveur MCP personnels.

Vous pouvez utiliser des serveurs personnels et des serveurs au niveau du référentiel ensemble. Si les deux configurations définissent un serveur portant le même nom, la configuration au niveau du référentiel est prioritaire.

Ce paramètre de dépôt est distinct des fichiers de configuration MCP du projet utilisés par Copilot CLI. Utilisez le guide de configuration de votre Surface plutôt que de supposer que le même emplacement de configuration s’applique partout.

Automations peut utiliser des outils de ces serveurs MCP, mais seuls les outils que vous sélectionnez pour chaque automation. Consultez « Automatisations Copilot ».

Avertissement

Lorsque vous déléguez le travail à Copilot en le mentionnant avec @mentioning ou en lui attribuant un ticket ou une pull request, Copilot utilise des outils MCP configurés de manière autonome et ne demande pas d’approbation avant de les appeler. Pour ces flux de travail, passez en revue chaque serveur et autorisez uniquement les outils et l’accès nécessaires à vos tâches.

Lorsque vous configurez des serveurs MCP pour une utilisation par Copilot cloud agent et Copilot code review, gardez à l’esprit les points suivants :

  • Copilot cloud agent et Copilot code review prennent uniquement en charge les outils MCP. Ils ne prennent pas actuellement en charge les ressources ni les instructions fournies par le serveur MCP.
  • Pour les serveurs MCP configurés dans les paramètres du référentiel ou les profils d’agent personnalisés, Copilot cloud agent et Copilot code review ne prennent actuellement pas en charge les serveurs distants qui utilisent OAuth pour l’authentification et l’autorisation.

Copilot code review nécessite également que les outils déclarent annotations.readOnlyHint: true. Les outils avec cette annotation manquante ou définie à false sont exclus.

Pour connaître les procédures de configuration, d’authentification et de validation, consultez Configurer des serveurs MCP pour votre référentiel.

Serveurs MCP pour les agents personnalisés

Pour Copilot cloud agent, un profil d’agent peut définir des serveurs MCP pour cet agent personnalisé, plutôt que de les rendre disponibles pour chaque agent travaillant dans le référentiel. La mcp-servers propriété de profil n’est pas utilisée par les agents personnalisés s’exécutant directement dans les IDE.

Pour Copilot cloud agentles configurations de serveur par défaut sont traitées en premier, puis les configurations d’agent personnalisées, puis les paramètres du référentiel. Les configurations ultérieures peuvent remplacer les paramètres antérieurs. Cet ordre ne décrit pas la priorité des fichiers de projet dans Copilot CLI.

Pour connaître le format de profil, les propriétés prises en charge et les règles de traitement, consultez Configuration des agents personnalisés.

Bonnes pratiques

  • Passez en revue les serveurs tiers avant de les activer. Vérifiez leurs outils, exigences d’authentification et accès aux données par rapport aux exigences de votre organisation.
  • Activez uniquement les outils nécessaires à la tâche. Dans les paramètres du référentiel, utilisez le champ tools pour autoriser explicitement certains outils, de préférence en lecture seule, plutôt que d’activer chaque outil. Dans automations, sélectionnez les outils spécifiques dont vous avez besoin.
  • Limitez la portée des informations d’identification aux ressources requises. N’élargissez pas l’accès du jeton Copilot cloud agent par défaut, sauf si la tâche en a besoin.
  • Validez la configuration avant de vous appuyer dessus. Vérifiez quels serveurs et outils sont disponibles dans votre session d’agent. Pour obtenir des instructions de configuration pour votre environnement, consultez les étapes suivantes.

À propos du GitHub serveur MCP

Le GitHub serveur MCP est un serveur MCP (Model Context Protocol) fourni et géré par GitHub.

GitHub Le serveur MCP peut être utilisé pour :

  • Automatiser et rationaliser les tâches liées au code.
  • Connectez des outils tiers (comme Cursor, Planche à voile ou intégrations futures) pour tirer parti GitHubdes fonctionnalités de contexte et d’IA.
  • Activer des workflows dans le cloud accessibles depuis n’importe quel appareil, sans configuration locale.
  • Appelez GitHub des outils, tels que Copilot cloud agent (nécessite GitHub Copilot un abonnement) et code scanning (nécessite GitHub Advanced Security un abonnement), pour faciliter la génération de code et l’analyse de la sécurité.

Pour savoir comment utiliser le GitHub serveur MCP, consultez Utilisation du serveur MCP GitHub dans votre IDE.

Pour savoir si votre éditeur prend en charge le GitHub serveur MCP et quelles méthodes de connexion et d’authentification sont disponibles, consultez Prise en charge par application hôte dans le github/github-mcp-server référentiel.

Accès à distance

Vous pouvez accéder à distance au serveur MCP GitHub via Copilot Chat dans Visual Studio Code sans aucune configuration locale. Le serveur distant a accès à des ensembles d’outils supplémentaires uniquement disponibles sur le serveur MCP distant GitHub . Pour obtenir la liste de ces outils, consultez ensembles d’outils supplémentaires dans le dépôt github/github-mcp-server.

Le GitHub serveur MCP peut également s’exécuter localement dans n’importe quel éditeur compatible MCP, si nécessaire.

Personnalisation de l’ensemble d’outils

Important

Passez toujours en revue le GitHub référentiel de serveur MCP sur github/github-mcp-server pour obtenir les derniers ensembles d’outils et les conseils de configuration faisant autorité.

Le GitHub serveur MCP prend en charge l’activation ou la désactivation de groupes spécifiques de fonctionnalités via des ensembles d’outils. Les ensembles d’outils vous permettent de contrôler les GitHub fonctionnalités d’API disponibles pour vos outils IA.

L’activation uniquement des ensembles d’outils dont vous avez besoin améliore les performances et la sécurité de votre assistant IA. Moins d’outils signifient une meilleure précision de sélection des outils et moins d’erreurs. La désactivation des ensembles d’outils inutilisés libère également des jetons dans la fenêtre de contexte de l’IA.

Les ensembles d’outils n’incluent pas seulement les outils, mais également les ressources MCP pertinentes et les invites le cas échéant.

Pour savoir comment configurer des ensembles d’outils pour le GitHub serveur MCP, consultez Configuration des ensembles d’outils pour le serveur MCP GitHub.

Security

Pour tous les dépôts publics et les dépôts privés couverts par GitHub Advanced Security, les interactions avec le GitHub serveur MCP sont sécurisées par la protection Push, ce qui bloque les secrets dans les réponses générées par l’IA et les empêche d’être inclus dans les actions effectuées en votre nom. Vous pouvez également analyser de manière proactive votre code pour détecter les secrets exposés à partir de votre agent de codage IA. Pour plus d’informations, consultez « Analyse des secrets avec le serveur MCP GitHub ».

À propos du GitHub Registre MCP

Le GitHub Registre MCP est une liste organisée de serveurs MCP provenant de partenaires et de la communauté. Vous pouvez utiliser ce registre pour découvrir de nouveaux serveurs MCP et trouver ceux qui répondent à vos besoins spécifiques.

Remarque

Le registreGitHub MCP est actuellement en préversion publique et susceptible de cha

Recherche d’agent

Le finder d’agent est un service de découverte qui permet GitHub Copilot de trouver les fonctionnalités appropriées, telles que les serveurs MCP, les outils, les agents et les compétences, pour une tâche au moment de l’exécution, au lieu d’exiger que toutes les fonctionnalités soient configurées à l’avance. À l’instar d’un registre MCP, il recherche un catalogue de fonctionnalités et retourne des correspondances classées qui GitHub Copilot peuvent être utilisées à la demande. L’outil de recherche d’agents implémente la spécification ouverte Agentic Resource Discovery (ARD).

Pour Copilot CLI la configuration, consultez Utilisation du localisateur d’agent. GitHub Copilot app propose une af compétence intégrée. Consultez « Compétences intégrées pour l’application GitHub Copilot ». Pour parcourir le catalogue, consultez GitHub Recherche d’agents.

Étapes suivantes