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

Cet article explique comment utiliser azure API Center pour gérer un inventaire (ou registre) des serveurs MCP (Remote Model Context Protocol) et aider les parties prenantes à les découvrir à l’aide du portail du Centre d’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.

À 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.

Inscrire manuellement un serveur MCP dans votre inventaire d’API

Les sections suivantes décrivent comment ajouter manuellement à l’inventaire un serveur MCP distant dans votre centre d’API.

Type d’API MCP

Inscrivez manuellement un serveur MCP dans votre inventaire du centre d’API comme vous inscrivez d’autres API, en spécifiant le type d’API en tant que MCP. Pour inscrire une API à l’aide du portail Azure, consultez Tutoriel : Inscrire des API dans votre inventaire d’API.

Comme décrit dans les sections suivantes, lorsque vous inscrivez un serveur MCP, vous pouvez spécifier un environnement, un déploiement et une définition.

Environnement et déploiement pour le serveur MCP

Dans le Centre des API, spécifiez un environnement et un déploiement pour votre serveur MCP. L’environnement est l’emplacement du serveur MCP, tel qu’une plateforme de gestion des API ou un service de calcul, et le déploiement est une URL d’exécution pour le service MCP.

Pour plus d’informations sur la création d’un environnement et d’un déploiement, consultez Tutoriel : Ajouter des environnements et des déploiements pour les API.

Définition du serveur MCP distant

Si vous le souhaitez, ajoutez une définition d’API pour un serveur MCP distant au format OpenAPI 3.0. La définition de l’API doit inclure un point de terminaison d’URL pour le serveur MCP. Pour obtenir un exemple d’ajout d’une définition OpenAPI, consultez Tutoriel : Inscrire des API dans votre inventaire d’API.

Vous pouvez utiliser la définition d’API OpenAPI 3.0 légère suivante pour votre serveur MCP, qui inclut un url point de terminaison pour le serveur MCP :

{
  "openapi": "3.0.0",
  "info": {
    "title": "Demo MCP server",
    "description": "Very basic MCP server that exposes mock tools and prompts.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://my-mcp-server.contoso.com"
    }
  ]
}

Inscrire un serveur MCP partenaire

Azure API Center fournit une liste organisée de serveurs MCP partenaires que vous pouvez ajouter à votre inventaire des API. Cette liste inclut des serveurs MCP à partir de services Microsoft tels qu’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 Microsoft Azure, accédez à votre centre API.
2. Dans le menu de la barre latérale, sous Découvrir, sélectionnez MCP (préversion).
3. Parcourez les serveurs MCP partenaires disponibles. Sélectionnez Inscrire pour ajouter un serveur MCP à votre inventaire d’API. Suivez les instructions à l’écran s’il y en a pour terminer l’inscription.

Lorsque vous ajoutez un serveur MCP partenaire, le centre d’API configure automatiquement les éléments suivants :

• 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 une définition OpenAPI pour le serveur MCP s’il est disponible auprès du partenaire.

Pour générer et inscrire un serveur MCP Logic Apps, consultez Générer et inscrire un serveur MCP Logic Apps.

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

Configurez votre portail du Centre d’API pour permettre aux développeurs et aux autres parties prenantes de votre organisation de découvrir des serveurs MCP dans votre inventaire des API. Les utilisateurs peuvent parcourir et filtrer les serveurs MCP dans l’inventaire et afficher des détails tels que le point de terminaison d’URL du serveur MCP, s’ils sont disponibles dans la définition de l’API du serveur MCP.

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 Centre API pour créer et inscrire des API depuis Visual Studio Code.
• Pour obtenir un exemple en direct de la façon dont Azure API Center peut alimenter votre registre MCP privé et prêt pour l’entreprise, consultez Centre MCP.