Inscrire et découvrir des serveurs MCP dans votre inventaire d’API

Cet article explique comment utiliser Azure Centre d’API pour gérer un inventaire (ou registry) de serveurs MCP (Remote Model Context Protocol) distants ou locaux et aider les parties prenantes à les découvrir via le portail du Centre des API. Les serveurs MCP exposent des API back-end ou des sources de données de manière standard aux agents et modèles IA qui les consomment.

Comme indiqué dans cet article, vous pouvez inscrire des serveurs MCP distants ou locaux à l’aide du portail Azure comme vous inscrivez des API et d’autres ressources. Le Centre d’API fournit également des liens vers les serveurs MCP partenaires que vous pouvez inscrire dans votre inventaire.

À propos des serveurs MCP

Les agents IA sont de plus en plus largement adoptés en raison des fonctionnalités améliorées du modèle de langage volumineux (LLM). Toutefois, même les modèles les plus avancés sont confrontés à des limitations en raison de leur isolation à partir de données externes. Chaque nouvelle source de données nécessite potentiellement des implémentations personnalisées pour extraire, préparer et rendre les données accessibles pour les modèles.

Le protocole MCP ( Model Context Protocol ) permet de résoudre ce problème. MCP est une norme ouverte pour connecter des modèles et des agents IA avec des sources de données externes telles que des sources de données locales (bases de données ou fichiers ordinateurs) ou des services distants (systèmes disponibles sur Internet, tels que des bases de données ou des API distantes).

Architecture MCP

MCP suit une architecture client-serveur où une application hôte peut se connecter à plusieurs serveurs. Chaque fois que votre hôte ou client MCP a besoin d’un outil, il se connecte au serveur MCP. Le serveur MCP se connecte ensuite à une base de données ou une API, par exemple. Les hôtes et serveurs MCP se connectent les uns avec les autres via le protocole MCP.

L’architecture MCP repose sur JSON-RPC 2.0 pour la messagerie. La communication entre les clients et les serveurs se produit sur des couches de transport définies et prend en charge principalement deux modes d’opération :

• Serveurs MCP distants : les clients MCP se connectent aux serveurs MCP via Internet, établissent une connexion à l’aide d’événements HTTP et envoyés par le serveur (SSE) et autorisent l’accès du client MCP aux ressources sur le compte de l’utilisateur à l’aide d’OAuth.

• Serveurs MCP locaux Les clients MCP se connectent aux serveurs MCP sur le même ordinateur, à l’aide d’une entrée/sortie standard comme méthode de transport locale.

Prerequisites

• Un centre d’API. Si vous n’avez pas encore de centre d’API, consultez le guide de démarrage rapide pour créer un centre d’API.
• URL de point de terminaison de serveur MCP distant ou package de serveur MCP que vous souhaitez enregistrer.
• (Pour un serveur MCP distant) Environnement dans votre centre d’API à associer au serveur MCP. L’environnement est l’emplacement du serveur MCP, tel qu’une plateforme de gestion des API ou un service de calcul.

Inscrire un serveur MCP distant

Pour inscrire un serveur MCP distant :

1. Connectez-vous au portail Azure et accédez à votre centre d’API.
2. Dans le menu de la barre latérale, sous Inventaire, sélectionnez Ressources.
3. Sélectionnez + Enregistrer une ressourceserveur MCP.
   
4. Dans le formulaire Inscrire un serveur MCP , fournissez les informations sur le serveur MCP :
   1. Entrez un titre pour le serveur MCP. Le Centre d’API génère automatiquement une identification basée sur le titre, mais vous pouvez la modifier si nécessaire.
   2. Entrez un résumé et une description pour le serveur MCP pour fournir plus de contexte à ce sujet.
   3. Si vous le souhaitez, entrez une URL d’icône pour associer une image au serveur MCP.
   4. Sous Cas d’utilisation, indiquez éventuellement un nom et une description pour un ou plusieurs cas d’usage pour le serveur MCP.
   5. Sous Remotes, procédez comme suit :
      1. Sélectionnez + Ajouter à distance.
      2. Entrez une URL d’exécution pour le serveur MCP.
      3. Sélectionnez un environnement centre d’API qui correspond à l’emplacement du serveur MCP, tel qu’une plateforme de gestion des API ou un service de calcul.
      4. Cliquez sur Enregistrer.
      5. Si vous le souhaitez, répétez les étapes précédentes pour ajouter d’autres distances si le serveur MCP a plusieurs points de terminaison ou est déployé dans plusieurs environnements.
   6. Si vous le souhaitez, sélectionnez Ajouter un référentiel pour fournir une URL à un référentiel de code associé au serveur MCP.
   7. Sous Titre de version, fournissez un titre de version, une identification de version et un cycle de vie de version pour le serveur MCP. En savoir plus sur les versions dans le Centre API.
   8. Si vous le souhaitez, ajoutez des liens de documentation licence et externe et des informations associées pour le serveur MCP.
   9. Cliquez sur Créer.

Définitions du serveur MCP distant

Le Centre d’API génère automatiquement les définitions OpenAPI suivantes pour un serveur MCP distant et les associe à la version du serveur que vous inscrivez :

• Définition SSE, pour l’utilisation d’événements envoyés par le serveur (SSE) en tant que protocole agentique
• Définition streamable, pour l’utilisation d’un protocole agentique indépendant du transport

Inscrire un serveur MCP local

Vous pouvez inscrire un serveur MCP installé localement à l’aide d’un gestionnaire de package tel que npm ou pypi.

Pour inscrire un serveur MCP local :

1. Connectez-vous au portail Azure et accédez à votre centre d’API.
2. Dans le menu de la barre latérale, sous Inventaire, sélectionnez Ressources.
3. Sélectionnez + Enregistrer une ressourceserveur MCP.
4. Dans le formulaire Inscrire un serveur MCP , fournissez les informations sur le serveur MCP :
   1. Entrez un titre pour le serveur MCP. Le Centre d’API génère automatiquement une identification basée sur le titre, mais vous pouvez la modifier si nécessaire.
   2. Entrez un résumé et une description pour le serveur MCP pour fournir plus de contexte à ce sujet.
   3. Si vous le souhaitez, entrez une URL d’icône pour associer une image au serveur MCP.
   4. Sous Cas d’utilisation, indiquez éventuellement un nom et une description pour un ou plusieurs cas d’usage pour le serveur MCP.
   5. Sous Packages, procédez comme suit :
      1. Sélectionnez + Ajouter un package.
      2. Entrez un registre de packages pour l’installation du serveur MCP. Par exemple : npm.
      3. Entrez un nom de package à partir du registre du package et d’une version.
      4. Dans l’indicateur runtime, entrez la commande runtime utilisée pour exécuter le serveur MCP. Par exemple : npx.
      5. Dans les arguments Runtime, transmettez éventuellement des arguments lors de l’exécution du serveur MCP.
      6. Cliquez sur Enregistrer.
      7. Si vous le souhaitez, répétez les étapes précédentes pour ajouter d’autres packages si le serveur MCP est disponible dans plusieurs registres de packages ou comporte plusieurs versions.
   6. Si vous le souhaitez, sélectionnez Ajouter un référentiel pour fournir une URL à un référentiel de code associé au serveur MCP.
   7. Sous Titre de version, fournissez un titre de version, une identification de version et un cycle de vie de version pour le serveur MCP. En savoir plus sur les versions dans le Centre API.
   8. Si vous le souhaitez, ajoutez des liens de documentation licence et externe et des informations associées pour le serveur MCP.
   9. Cliquez sur Créer.

Inscrire un serveur MCP partenaire

Azure Centre d’API fournit une liste organisée de serveurs MCP partenaires que vous pouvez ajouter à votre inventaire des API. Cette liste inclut des serveurs MCP de services Microsoft tels que Azure Logic Apps, GitHub et d’autres.

Inscrivez un ou plusieurs des serveurs MCP partenaires dans votre inventaire d’API pour les rendre disponibles pour les développeurs et d’autres parties prenantes de votre organisation.

Pour inscrire un serveur MCP partenaire :

1. Dans le portail Azure, accédez à votre centre d’API.
2. Dans le menu de la barre latérale, sous Découvrir, sélectionnez MCP.
3. Parcourez les serveurs MCP partenaires disponibles. Sélectionnez Inscrire pour ajouter un serveur MCP à votre inventaire d’API. Suivez les instructions à l’écran si elles sont fournies pour terminer l’inscription.

Lorsque vous ajoutez un serveur MCP partenaire, le Centre d’API configure automatiquement les paramètres suivants pour vous :

• Crée une entrée d’API dans votre inventaire d’API avec le type d’API défini sur MCP.
• Crée un environnement et un déploiement pour le serveur MCP.
• Ajoute des définitions OpenAPI pour le serveur MCP si le partenaire les fournit.

Générer et inscrire vos propres serveurs MCP

Pour créer des serveurs MCP à l’aide de Azure services de calcul et les inscrire dans votre centre d’API, consultez les exemples suivants :

• Générer et inscrire un serveur MCP Logic Apps
• Construires et enregistrez un serveur MCP Azure Functions

Synchroniser des serveurs MCP à partir de sources d’API

Pour automatiser l’inscription MCP et maintenir votre inventaire à jour, vous pouvez intégrer les sources en amont suivantes à votre centre d’API :

• Gestion des API Azure : si vous gérez des serveurs MCP dans Gestion des API Azure, vous pouvez activer la synchronisation automatique pour maintenir votre centre d’API à jour. Pour plus d’informations, consultez synchroniser les API depuis l'instance Gestion des API Azure.

• Référentiel Git : pour les serveurs MCP et d’autres ressources IA stockées dans un référentiel Git, vous pouvez activer la synchronisation automatique pour maintenir votre centre d’API à jour. Pour plus d’informations, consultez Synchroniser les ressources d’API à partir d’un référentiel Git.

Découvrir des serveurs MCP à l’aide du portail du Centre des API

Configurez votre portail du Centre d’API afin que les développeurs et d’autres parties prenantes de votre organisation puissent parcourir et filtrer les serveurs MCP dans l’inventaire.

• Les utilisateurs peuvent afficher des détails tels que le point de terminaison d’URL du serveur MCP et des schémas d’outil, et installer le serveur MCP dans leur environnement de Visual Studio Code.

• Une console de test intégrée permet aux utilisateurs de tester les outils serveur MCP et d’afficher les réponses directement dans le portail. Sous l’onglet Documentation d’une page de détails du serveur MCP, sélectionnez un outil, puis exécutez l’outil pour accéder à la console de test.

Gérer l’accès aux serveurs MCP

Si vous le souhaitez, utilisez les fonctionnalités de gestion des accès du Centre d’API pour gérer qui peut afficher et accéder aux serveurs MCP dans votre inventaire. Pour plus d’informations, consultez Autoriser l’accès aux API dans votre centre d’API.

Configurer les métadonnées du Registre MCP

Azure Centre d’API expose un point de terminaison de Registre MCP que vous pouvez configurer dans Visual Studio Code, GitHub Copilot ou d’autres outils pour découvrir et se connecter aux serveurs MCP dans votre inventaire.

L’URL du point de terminaison du Registre est au format suivant :

https://<your-api-center-name>.data.<region>.azure-apicenter.ms/workspaces/default/v0.1/servers

Exemple : https://contoso-api-center.data.eastus.azure-apicenter.ms/default/v0.1/servers

Le registre MCP stocke les métadonnées de découverte et de configuration standard pour les serveurs MCP, tels que le nom du serveur, l’URL et le type de transport. Vous pouvez éventuellement étendre les métadonnées en configurant des propriétés personnalisées qui apparaissent dans la _meta section des réponses du serveur MCP aux appels d’outils. Vous pouvez associer les propriétés de métadonnées de votre centre API à des espaces de noms structurés afin que les clients MCP puissent les utiliser.

Pour configurer les propriétés de métadonnées personnalisées à afficher dans la _meta section des réponses du serveur MCP :

1. Dans le portail Azure, accédez à votre centre d’API.
2. Dans le menu de la barre latérale, sous Découvrir, sélectionnez Registre MCP.
3. Sélectionnez + Configurer.
4. Pour définir un chemin d’espace de noms, sélectionnez + Ajouter un chemin.
   1. Pour ajouter une propriété de métadonnées personnalisée, sélectionnez + Ajouter une propriété et sélectionnez une propriété de métadonnées personnalisée. Répétez éventuellement cette étape pour ajouter plusieurs propriétés.
   2. Ajoutez éventuellement un sous-chemin de l’espace de noms. Sélectionnez + Ajouter un sous-chemin et répétez les étapes précédentes pour ajouter des propriétés sous le sous-chemin.
5. Confirmez la configuration en examinant le panneau d’aperçu.
6. Cliquez sur Enregistrer.

Contenu connexe

• À propos des serveurs MCP dans Gestion des API
• Importer des API dans votre Centre API depuis Gestion des API
• Utilisez l’extension Visual Studio pour le Centre des API pour générer et inscrire des API à partir de Visual Studio Code.
• Pour obtenir un exemple en direct de la façon dont Azure Centre d’API peut alimenter votre registre MCP privé et prêt pour l’entreprise, visitez MCP Center.