Ajoutez un serveur Model Context Protocol (MCP) à votre agent en tant qu’outil (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, chaque outil exposé par le serveur devient disponible pour que l’agent puisse l’invoquer lors d’une conversation.

Note

Les fonctionnalités de cet article sont utilisées par des agents ou des flux de travail alimentés par le harnais GitHub Copilot.

La facturation basée sur l’utilisation s’applique à l’utilisation, à la construction, aux tests et à l’évaluation des agents. Ces actions peuvent consommer des crédits Copilot. En savoir plus dans Gérer les coûts pour les agents alimentés par le harnais GitHub Copilot.

Utilisez ce guide pratique lorsque vous souhaitez ajouter un serveur MCP à un agent dans la nouvelle expérience. Pour un aperçu des types d’outils dans la nouvelle expérience, voir Outils disponibles pour les agents.

Prerequisites

  • Un agent créé dans la nouvelle expérience. Consultez Créer un agent.
  • L'URL d'un serveur MCP accessible depuis Copilot Studio. Si vous n’en avez pas encore, voir Créer un nouveau serveur Model Context Protocol (MCP).
  • Toutes les identifiantes requises par le serveur (par exemple, 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’agent 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 la poignée de main du protocole, puis liste 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 de l’outil, la description de l’outil ou les instructions de l’agent. Voir Configurer les détails et 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. Voir Gérer et supprimer les outils dans un agent.

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.

Limites

  • Chaque agent peut se connecter à plusieurs serveurs MCP, mais le nombre total d’instances de serveur MCP pouvant s’exécuter 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.
  • Last updated on