Ajoutez un serveur Model Context Protocol (MCP) à votre agent en tant qu’outil (GitHub Copilot) (aperçu)

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Le protocole de contexte de modèle (MCP) est une norme permettant d’exposer des outils à un agent. Lorsque vous ajoutez un serveur MCP à votre agent, celui-ci peut utiliser tous les outils que le serveur expose lors d’une conversation.

Utilisez ce guide pratique lorsque vous souhaitez ajouter un serveur MCP à un agent alimenté par le harness GitHub Copilot. Pour un aperçu des types d’outils, voir Outils disponibles pour les agents (GitHub Copilot).

L’onglet MCP dans la boîte de dialogue Ajouter un outil liste les serveurs MCP déjà publiés pour votre organisation, tels que les services Microsoft 365, Foundry IQ et Fabric IQ.

  1. Connectez-vous à Copilot Studio et ouvrez votre agent.

  2. Dans la barre de navigation de l’agent, sélectionnez l’onglet Build .

  3. Dans le panneau composants à droite, sélectionnez Outils, puis Ajouter outil.

  4. Dans la boîte de dialogue Ajouter un outil , sélectionnez l’onglet MCP , puis sélectionnez un serveur.

  5. Sur la page de détails du serveur, consultez sa description et, si disponible, le lien Docs pour des informations sur les fonctions du serveur. Sélectionnez Ajouter.

  6. Ce qui se passe ensuite dépend du serveur :

    • Certains serveurs (par exemple, les serveurs Microsoft 365 propriétaires, tels que Mail) se connectent automatiquement à l’aide de votre identité de connexion, et le serveur est ajouté directement.
    • D’autres serveurs vous invitent à créer une connexion, avec des champs spécifiques à ce serveur (par exemple, un nom d’affichage et un type d’authentification, ou une URL de point de terminaison et une clé API). Indiquez les valeurs demandées et sélectionnez Créer.

    Ces valeurs sont spécifiques à chaque serveur. Utilisez le lien Docs du serveur, si disponible, pour les détails de configuration.

Comme chaque serveur peut nécessiter des valeurs de connexion différentes et changer indépendamment de Copilot Studio, cet article ne liste pas les champs pour chaque serveur. Appuyez-vous sur la description intégrée au produit et sur le lien Docs du serveur que vous ajoutez.

Ajoutez un serveur MCP personnalisé par URL

Utilisez ce chemin pour connecter un serveur MCP qui n’est pas déjà publié dans la galerie.

Prerequisites

  • Un agent créé dans la nouvelle expérience. Consultez Créer un agent.
  • L'URL d'un serveur MCP accessible depuis Copilot Studio. En savoir plus dans Créer un serveur MCP (Model Context Protocol).
  • Toutes les informations d’identification requises par le serveur, telles qu’une clé API ou un identifiant client et un secret pour un schéma d’authentification pris en charge.

Ajouter un serveur MCP depuis l’onglet Build

  1. Connectez-vous à Copilot Studio et ouvrez votre agent.

  2. Dans la barre de navigation de l’agent, sélectionnez l’onglet Build .

  3. Dans le panneau composants à droite, sélectionnez Outils.

  4. Dans la boîte de dialogue Ajouter un outil, sélectionnez Ajouter à côté de la barre de recherche, puis sélectionnez Protocole de contexte modèle (MCP).

  5. Sur la page Ajouter le serveur MCP , saisissez les détails suivants :

    • Nom : un nom court et descriptif qui aide l’agent à décider quand utiliser les outils de ce serveur. Ce nom correspond au nom que l’assistant voit.
    • Description : un résumé d’une ou deux phrases de ce que fait le serveur et du moment où l’agent doit l’utiliser.
    • URL serveur : le point de terminaison HTTPS du serveur MCP.
    • Authentification : choisissez la méthode d’authentification requise par le serveur, et entrez les identifiants ou les valeurs de configuration dont cette méthode a besoin.

  6. Sélectionnez Ajouter pour connecter.

    Copilot Studio contacte le serveur MCP, négocie l’établissement d’une liaison du protocole, puis répertorie les outils exposés par le serveur.

  7. Consultez la liste des outils qui apparaissent.

    Pour chaque outil, vérifiez le nom et la description. Si un outil n’a pas de description claire, les réponses des agents impliquant cet outil sont moins fiables. Demandez à l’auteur du serveur MCP d’améliorer la description avant de vous fier à l’outil en production.

  8. Sélectionnez Enregistrer pour finir d’ajouter le serveur.

Le serveur apparaît dans la liste des outils de l’agent dans l’onglet Build .

Tester le serveur

Après avoir ajouté le serveur, testez-le avant de publier l’agent.

  1. Sélectionnez l’onglet Aperçu .

  2. Posez à l’agent une question qui nécessite l’un des outils du serveur.

  3. Passez en revue la réponse de l’agent. Ouvrez la trace d’activité pour vérifier quel outil a été invoqué, quels arguments ont été transmis et ce que l’outil a retourné. Voir Utiliser la trace d’activité pour déboguer votre agent.

Si l’agent n’invoque pas l’outil quand vous l’attendez, affinez le nom du serveur, la description du serveur ou les instructions de l’agent. Les noms et descriptions des outils individuels proviennent du serveur MCP lui-même. Si cela doit changer, demandez à l’auteur du serveur MCP de les mettre à jour. Pour plus d’informations, consultez Configurer les détails et les instructions de l’agent.

Gérez le serveur après l’avoir ajouté

Pour supprimer un serveur MCP ou en désactiver un temporairement, utilisez le flux de gestion d’outils standard. En savoir plus sur Gérer et supprimer des outils dans un agent (GitHub Copilot).

Si l’URL, l’authentification ou les outils exposés d’un serveur changent après l’ajouter, modifiez l’entrée serveur dans la même boîte de dialogue Outils pour rafraîchir la connexion et relisez la liste d’outils.

Limits

  • Chaque agent peut se connecter à plusieurs serveurs MCP, mais le nombre total d’instances de serveur MCP qui s’exécutent simultanément dans une seule conversation est plafonné. Si vous ajoutez plus de serveurs MCP que la limite ne l’autorise et que l’agent essaie de tous les utiliser lors du même tour, les serveurs supplémentaires sont ignorés et leurs outils ne sont pas disponibles lors de ce tour.
  • Gardez le nombre de serveurs MCP attachés à un agent individuel petit, et supprimez les serveurs que vous n’utilisez plus, afin que l’agent ait la possibilité d’invoquer les serveurs qui vous intéressent.
  • Chaque serveur MCP compte dans le nombre total d’outils qu’un agent peut héberger.
  • Dernière mise à jour :