Se connecter aux serveurs Model Context Protocol (préversion)

Vous pouvez étendre les fonctionnalités de votre agent Foundry en la connectant à des outils hébergés sur des serveurs MCP (Remote Model Context Protocol) (apportez votre propre point de terminaison de serveur MCP). Les développeurs et les organisations gèrent ces serveurs. Les serveurs exposent des outils auxquels les clients compatibles MCP, tels que foundry Agent Service, peuvent y accéder.

MCP est une norme ouverte qui définit la façon dont les applications fournissent des outils et des données contextuelles aux modèles de langage volumineux (LLMs). Il permet une intégration cohérente et évolutive d’outils externes dans des flux de travail de modèle.

Considérations relatives à l’utilisation de services et de serveurs non-Microsoft

Votre utilisation de services non-Microsoft connectés est soumise aux conditions entre vous et le fournisseur de services. Lorsque vous vous connectez à un service non-Microsoft, certaines de vos données (telles que le contenu d’invite) sont transmises au service non-Microsoft, ou votre application peut recevoir des données du service non-Microsoft. Vous êtes responsable de votre utilisation de services et de données non-Microsoft, ainsi que des frais associés à cette utilisation.

Les serveurs MCP distants que vous décidez d’utiliser avec l’outil MCP décrit dans cet article ont été créés par des tiers, et non par Microsoft. Microsoft n’a pas testé ou vérifié ces serveurs. Microsoft n’a aucune responsabilité vis-à-vis de vous ou d’autres en ce qui concerne votre utilisation de serveurs MCP distants.

Nous vous recommandons de passer en revue et de suivre attentivement les serveurs MCP que vous ajoutez au service De l’agent Foundry. Nous vous recommandons également de vous appuyer sur des serveurs hébergés par des fournisseurs de services approuvés eux-mêmes plutôt que des proxys.

L’outil MCP vous permet de transmettre des en-têtes personnalisés, tels que des clés d’authentification ou des schémas, dont un serveur MCP distant peut avoir besoin. Nous vous recommandons de passer en revue toutes les données partagées avec des serveurs MCP distants et de consigner les données à des fins d’audit. Soyez conscient des pratiques non-Microsoft en matière de rétention et d’emplacement des données.

Fonctionnement

Vous devez fournir un serveur MCP distant (un point de terminaison de serveur MCP existant) au service Agent Foundry. Vous pouvez apporter plusieurs serveurs MCP distants en les ajoutant en tant qu’outils. Pour chaque outil, vous devez fournir une valeur unique server_label au sein du même agent et une server_url valeur qui pointe vers le serveur MCP distant. Veillez à examiner attentivement les serveurs MCP que vous ajoutez au service De l’agent Foundry.

L’outil MCP prend en charge les en-têtes personnalisés. Vous pouvez donc vous connecter aux serveurs MCP à l’aide des schémas d’authentification dont ils ont besoin ou en passant d’autres en-têtes requis par les serveurs MCP. Vous ne pouvez spécifier des en-têtes qu'en les incluant dans tool_resources à chaque exécution. De cette façon, vous pouvez placer des clés API, des jetons d’accès OAuth ou d’autres informations d’identification directement dans votre demande.

L’en-tête le plus couramment utilisé est l’en-tête d’autorisation. Les en-têtes que vous passez sont disponibles seulement pour l’exécution en cours et ne sont pas conservés.

Pour plus d’informations sur l’utilisation de MCP, consultez :

• Meilleures pratiques de sécurité sur le site web du protocole de contexte de modèle.
• Comprendre et atténuer les risques de sécurité dans les implémentations MCP dans le blog de la communauté de sécurité Microsoft.

Assistance à l'utilisation

Configuration

1. Créez un agent Foundry en suivant les étapes du guide de démarrage rapide.

2. Recherchez le serveur MCP distant auquel vous souhaitez vous connecter, par exemple le serveur MCP GitHub. Créez ou mettez à jour un agent Foundry avec un mcp outil avec les informations suivantes :

   1. server_url: URL du serveur MCP ; par exemple, https://api.githubcopilot.com/mcp/.
   2. server_label: identificateur unique de ce serveur MCP à l’agent ; par exemple, github.
   3. allowed_tools: liste facultative d’outils auxquels cet agent peut accéder et utiliser.

3. Créez une exécution et passez des informations supplémentaires sur l’outil mcp dans tool_resources avec des en-têtes :

   1. tool_label: Utilisez l’identificateur que vous avez fourni lors de la création de l’agent.
   2. headers: passez un ensemble d’en-têtes requis par le serveur MCP.
   3. require_approval: déterminez éventuellement si l’approbation est requise. Les valeurs prises en charge sont les suivantes :
      • always: un développeur doit fournir une approbation pour chaque appel. Si vous ne fournissez pas de valeur, il s’agit de la valeur par défaut.
      • never: aucune approbation n’est requise.
      • {"never":[<tool_name_1>, <tool_name_2>]}: Vous fournissez une liste d’outils qui ne nécessitent pas d’approbation.
      • {"always":[<tool_name_1>, <tool_name_2>]}: Vous fournissez une liste d’outils qui nécessitent une approbation.

4. Si le modèle tente d’appeler un outil dans votre serveur MCP avec approbation requise, vous obtenez un état d’exécution .requires_action Dans le requires_action champ, vous pouvez obtenir plus de détails sur l’outil du serveur MCP appelé, les arguments à transmettre et call_id la valeur. Passez en revue l’outil et les arguments afin que vous puissiez prendre une décision éclairée pour approbation.

5. Envoyez votre approbation à l'agent avec call_id en définissant approve sur true.

Héberger un serveur MCP local

Le runtime du service agent accepte uniquement un point de terminaison de serveur MCP distant. Si vous souhaitez ajouter des outils à partir d’un serveur MCP local, vous devez l’héberger automatiquement sur Azure Container Apps ou Azure Functions pour obtenir un point de terminaison de serveur MCP distant. Attention aux considérations suivantes lors de la tentative d’héberger des serveurs MCP locaux dans le cloud :

Contenu connexe

• Exemples de code pour l’outil Model Context Protocol