Ajout de serveurs MCP pour CLI de GitHub Copilot

Le Model Context Protocol (MCP) est une norme ouverte qui définit la manière dont les applications partagent du contexte avec les grands modèles de langage (LLM). Vous pouvez connecter des serveurs MCP à CLI de GitHub Copilot pour accorder à Copilot l’accès aux outils externes, sources de données et services. Pour une vue d'ensemble de MCP, veuillez consulter la section À propos du Model Context Protocol (MCP).

Ajout d’un serveur MCP

Remarque

Le serveur GitHub MCP est intégré à Copilot CLI et est déjà disponible sans aucune configuration supplémentaire. Les étapes ci-dessous concernent l’ajout d’autres serveurs MCP.

Vous pouvez ajouter des serveurs MCP à l’aide de la commande interactive /mcp add dans l’interface CLI ou en modifiant directement le fichier de configuration.

Pour obtenir des instructions d’installation, des outils disponibles et des URL pour des serveurs MCP spécifiques, consultez le GitHub MCP Registry.

Utilisation de la commande `/mcp add`

En mode interactif, entrez /mcp add. Un formulaire de configuration s’affiche. Utilisez Tab pour naviguer entre les champs.
En regard du nom du serveur, entrez un nom unique pour le serveur MCP. Il s’agit du nom que vous allez utiliser pour faire référence au serveur.

En regard du type de serveur, sélectionnez un type en appuyant sur le numéro correspondant. Les types suivants sont disponibles :

     **Local** ou **STDIO** : démarre un processus local et communique sur l’entrée/sortie standard (`stdin`/`stdout`). Les deux options fonctionnent de la même façon. 
     **STDIO** est le nom de type de protocole MCP standard. Choisissez cette option si vous souhaitez que votre configuration soit compatible avec VS Code, Copilot, agent de codage, et d’autres clients MCP.

     **HTTP** ou **SSE** : se connecte à un serveur MCP distant. 
     **HTTP** utilise le transport HTTP Streamable.               **SSE** utilise le protocole HTTP avec les événements envoyés par le serveur, qui est déconseillé dans la spécification MCP, mais toujours pris en charge pour la rétrocompatibilité. <!-- markdownlint-disable-line GHD046 -->

Les champs restants dépendent du type de serveur que vous avez sélectionné :
- Si vous avez choisi Local ou STDIO :
  - À côté de Commande, entrez la commande pour démarrer le serveur, y compris les arguments. Par exemple : npx @playwright/mcp@latest. Cela correspond aux propriétés command et args dans le fichier de configuration JSON.
  - En regard des variables d’environnement, spécifiez éventuellement les variables d’environnement dont le serveur a besoin, telles que les clés d’API ou les jetons, en tant que paires clé-valeur JSON. Par exemple : {"API_KEY": "YOUR-API-KEY"}. La PATH variable est automatiquement héritée de votre environnement. Toutes les autres variables d’environnement doivent être configurées ici.
- Si vous avez choisi HTTP ou SSE :
  - À côté de l’URL, collez l’URL du serveur distant. Par exemple : https://mcp.context7.com/mcp.
  - À côté des en-têtes HTTP, vous pouvez éventuellement spécifier des en-têtes HTTP en tant que JSON. Par exemple : {"CONTEXT7_API_KEY": "YOUR-API-KEY"}.
En regard des outils, spécifiez les outils du serveur qui doivent être disponibles. Entrez * pour inclure tous les outils, ou fournissez une liste séparée par des virgules des noms d’outils (pas besoin de guillemets). La valeur par défaut est *.

       <kbd>Appuyez sur Ctrl</kbd>+<kbd>S</kbd> pour enregistrer la configuration. Le serveur MCP est ajouté et disponible immédiatement sans redémarrer l’interface CLI.

Modification du fichier de configuration

Vous pouvez également ajouter des serveurs MCP en modifiant le fichier de configuration à l’adresse ~/.copilot/mcp-config.json. Cela est utile si vous souhaitez partager des configurations ou ajouter plusieurs serveurs à la fois.

L’exemple suivant montre un fichier de configuration avec un serveur local et un serveur HTTP distant :

JSON

{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR-API-KEY"
      },
      "tools": ["*"]
    }
  }
}

{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR-API-KEY"
      },
      "tools": ["*"]
    }
  }
}

Pour plus d’informations sur la configuration du serveur MCP, consultez Extension de l'agent de codage GitHub Copilot avec le protocole de contexte de modèle (MCP).

Gestion des serveurs MCP

Vous pouvez gérer vos serveurs MCP configurés à l’aide des commandes suivantes /mcp dans Copilot CLI.

        **Répertorier les serveurs MCP configurés :** Utilisez la commande `/mcp show`. Cela affiche tous les serveurs MCP configurés et leur état actuel.

        **Affichez des détails sur un serveur spécifique :** Utilisez la commande `/mcp show SERVER-NAME`. Cela affiche l’état du serveur spécifié et la liste des outils qu’il fournit.

        **Modifiez la configuration d’un serveur :** Utilisez la commande `/mcp edit SERVER-NAME`.

        **Supprimez un serveur :** Utilisez la commande `/mcp delete SERVER-NAME`.

        **Désactivez un serveur :** Utilisez la commande `/mcp disable SERVER-NAME`. Un serveur désactivé reste configuré, mais n’est pas utilisé par Copilot pour la session active.

        **Activez un serveur précédemment désactivé :** Utilisez la commande `/mcp enable SERVER-NAME`.

Utilisation de serveurs MCP

Une fois que vous avez ajouté un serveur MCP, Copilot peut automatiquement utiliser les outils qu'il fournit lorsque ceux-ci sont pertinents pour votre requête. Vous pouvez également référencer directement un serveur MCP et des outils spécifiques dans un terminal pour garantir leur utilisation.

Lectures complémentaires

        [AUTOTITLE](/copilot/concepts/about-mcp)

        [AUTOTITLE](/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp)

        [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp)