Ajout de serveurs MCP pour CLI GitHub Copilot

Étendez Copilotles fonctionnalités en connectant des serveurs MCP (Model Context Protocol) pour fournir des outils et un contexte supplémentaires.

Dans cet article

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 GitHub Copilot afin de fournir à Copilot l'accès aux outils externes, aux sources de données et aux 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 GitHub serveur MCP est intégré Copilot pour CLI et est déjà disponible sans 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 Registre MCP.

Utilisation de la commande /mcp add

  1. En mode interactif, entrez /mcp add. Un formulaire de configuration s’affiche. Utilisez Tab pour naviguer entre les champs.

  2. 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.

  3. 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, les Agent cloud Copilotclients MCP et les 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é.

  4. 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"}.

  5. 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 *.

  6.        <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": ["*"]
    }
  }
}

Pour plus d’informations sur la configuration du serveur MCP, consultez Connecter des agents à des outils externes.

Gestion des serveurs MCP

Vous pouvez gérer vos serveurs MCP configurés à l’aide des commandes suivantes /mcp dans Copilot pour 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 actuelle.

  • 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 vous pouvez utiliser automatiquement les outils qu’il fournit en cas de pertinence pour votre invite. 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