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.

Si votre organisation ou entreprise a configuré une URL de registre et une stratégie de liste d'autorisation, ces paramètres s’appliquent à Copilot pour CLI. L’URL de Registre configurée s’affiche en tant que source de découverte et seuls les serveurs autorisés par la stratégie de liste blanche peuvent s’exécuter.

Vous pouvez ajouter des serveurs MCP de la manière suivante :

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. Appuyez sur Ctrl+S pour enregistrer la configuration. Le serveur MCP est ajouté et disponible immédiatement sans redémarrer l’interface CLI.

Utilisation de la copilot mcp add sous-commande

Vous pouvez ajouter des serveurs MCP à partir du terminal à l’aide de la copilot mcp add sous-commande, sans entrer en mode interactif. Le serveur est ajouté à la configuration utilisateur à l’adresse ~/.copilot/mcp-config.json.

Pour les serveurs locaux (stdio), fournissez la commande après --:

Shell
copilot mcp add SERVER-NAME -- COMMAND [ARGS...]

Pour les serveurs distants (HTTP/SSE), spécifiez le transport et fournissez l’URL :

Shell
copilot mcp add --transport http SERVER-NAME URL

Vous pouvez également passer des options supplémentaires :

  • --env KEY=VALUE: définissez des variables d’environnement pour le serveur. Répétez cette opération pour plusieurs variables.
  • --header "HEADER: VALUE": définissez des en-têtes HTTP pour les serveurs distants. Répétez cette opération pour plusieurs en-têtes.
  • --transport TRANSPORT: Définissez le type de transport (stdio, httpou sse). La valeur par défaut est stdio.
  • --tools TOOLS: spécifiez les outils à activer. Utilisez * pour tous les outils (par défaut), une liste séparée par des virgules ou "" pour aucun.
  • --timeout MS: définissez un délai d’expiration en millisecondes.

Examples

Ajoutez un serveur stdio local :

Shell
copilot mcp add context7 -- npx -y @upstash/context7-mcp

Ajoutez un serveur local avec des variables d’environnement :

Shell
copilot mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Ajoutez un serveur HTTP distant :

Shell
copilot mcp add --transport http notion \
  https://mcp.notion.com/mcp

Ajoutez un serveur distant avec un en-tête d’autorisation :

Shell
copilot mcp add --transport http \
  --header "Authorization: Bearer YOUR-TOKEN" \
  stripe https://mcp.stripe.com

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 Configurer des serveurs MCP pour votre référentiel.

Recherche et installation à partir du Registre

Remarque

La /mcp search commande est actuellement une fonctionnalité expérimentale. Pour l’utiliser, commencez Copilot pour CLI par l’option --experimental de ligne de commande ou entrez /experimental on pendant une session.

Vous pouvez découvrir et installer des serveurs MCP directement à partir du GitHub Registre MCP à l’aide de la /mcp search commande en mode interactif. Cela vous permet de parcourir les serveurs disponibles, d’afficher leurs détails et de les installer sans remplir manuellement le formulaire de configuration.

Si votre organisation a configuré une URL de registre MCP personnalisée, /mcp search se connecte à ce registre au lieu du registre par défaut GitHub .

  1. En mode interactif, entrez /mcp search pour parcourir les serveurs principaux par étoiles ou /mcp search QUERY pour rechercher un serveur spécifique. Par exemple:

    /mcp search context7

  2. Une liste navigable au clavier des serveurs correspondants s’affiche. Utilisez les touches de direction pour parcourir les résultats.

  3. Sélectionnez un serveur pour ouvrir son formulaire de configuration. Le formulaire est prérempli avec la configuration du serveur à partir du Registre. Renseignez tous les champs requis, tels que les clés d’API ou les jetons.

  4. Appuyez sur Ctrl+S pour enregistrer. Le serveur est ajouté à votre mcp-config.json puis démarré immédiatement.

Gestion des serveurs MCP

Vous pouvez gérer vos serveurs MCP configurés à l’aide des commandes /mcp en mode interactif ou des sous-commandes copilot mcp depuis le terminal.

Utilisation des commandes /mcp en mode interactif

  • 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 copilot mcp de sous-commandes à partir du terminal

Vous pouvez également gérer les serveurs MCP à partir du terminal sans entrer en mode interactif.

  • Répertoriez tous les serveurs configurés :

    Shell
    copilot mcp list

    Répertorie les serveurs de toutes les sources de configuration (utilisateur, espace de travail et plug-in). Ajouter --json pour la sortie JSON.

  • Afficher les détails du serveur :

    Shell
    copilot mcp get SERVER-NAME

    Affiche le type, l’état et les outils disponibles d’un serveur. Ajouter --json pour la sortie JSON.

  • Supprimez un serveur :

    Shell
    copilot mcp remove SERVER-NAME

    Supprime le serveur de la configuration utilisateur.

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