Découvrir des API avec le serveur MCP du Centre d’API Azure

Le serveur MCP du Centre des API Azure expose le catalogue d'API de votre organisation en tant qu'aire d'outil native pour les agents IA et les flux de travail agentiques. Lorsque vous activez le serveur MCP du Centre des API, vous rendez vos API et ressources IA détectables par l’écosystème croissant de clients IA compatibles MCP, notamment Visual Studio Code Copilot, Claude Code et les agents personnalisés.

Le serveur MCP du centre d'API Azure expose les outils suivants que les agents utilisent pour découvrir et récupérer des ressources à partir de l'inventaire (Registre) de votre centre d'API.

Tool Description
mcp_registry_search Recherche dans le Registre du Centre d’API pour découvrir les API et les ressources IA par nom, type ou métadonnées. Retourne des résultats correspondants, notamment le type de ressource (REST, MCP, plug-in, compétence), l’état du cycle de vie et les descriptions.
mcp_registry_fetch Récupère des informations détaillées sur une API ou une ressource IA spécifique à partir du Registre, notamment des points de terminaison de déploiement, des versions, des définitions et des spécifications associées.

Prerequisites

  • Un Centre d’API dans votre abonnement Azure. Si vous n’en avez pas, consultez Démarrage rapide : Créer votre centre d’API.

  • Une ou plusieurs API ou ressources IA inscrites dans votre inventaire du centre d’API, telles que les serveurs MCP ou les compétences.

  • Le portail du centre d’API est activé et configuré pour votre centre d’API. Pour plus d’informations, consultez Configurer et personnaliser votre portail du Centre des API. La méthode d’accès que vous choisissez pour le portail (authentification anonyme ou Microsoft Entra ID) détermine comment les développeurs s’authentifient lorsqu’ils accèdent au serveur MCP.

  • Un client compatible MCP tel que Visual Studio Code avec Copilot, Claude Code ou un agent personnalisé.

  • Pour l’utilisation de l’interface CLI, vérifiez que l’outil CLI MCP est installé.

Activer le serveur MCP du Centre d’API Azure

Pour activer le serveur MCP à l’aide du portail Azure :

  1. Dans le portail Azure, accédez à votre centre d’API.
  2. Dans le menu de la barre latérale, sous Consommation, sélectionnez Paramètres de l’API de données.
  3. Sous point de terminaison MCP, sélectionnez Activer le point de terminaison MCP du Centre d’API.

Capture d’écran du point de terminaison MCP du Centre des API dans le portail.

Le point de terminaison du serveur MCP suit ce formulaire :

https://<service name>.data.<region>.azure-apicenter.ms/mcp

Exemple : https://myapicenter.data.eastus.azure-apicenter.ms/mcp

Important

Vous pouvez activer le point de terminaison MCP uniquement pour le niveau Standard. Si votre API Center est dans le niveau Gratuit, vous devez passer au Standard pour activer le serveur MCP. Pour plus d’informations sur la mise à niveau de votre centre API, consultez la FAQ.

Se connecter au serveur MCP

Une fois que vous avez activé le serveur MCP du Centre des API, les développeurs peuvent découvrir le point de terminaison du serveur MCP lorsqu’ils se connectent au portail du Centre des API. Les développeurs peuvent se connecter au serveur MCP à l’aide d’un client MCP tel que Visual Studio Code ou l’interface CLI MCP. La connexion nécessite le point de terminaison du serveur MCP et les informations d’identification d’authentification appropriées, s’ils sont configurés.

Pour vous connecter au serveur MCP à l’aide de Claude Code, consultez Ajouter un serveur MCP à Claude Code.

Se connecter via VS Code

Les développeurs peuvent ajouter la configuration du serveur MCP à leur fichier Visual Studio Code settings.json sous la clé mcp.

  1. Ouvrez Visual Studio Code et appuyez sur Ctrl+Shift+P (ou Cmd+Shift+P sur Mac).

  2. Recherchez Open User Settings (JSON).

  3. Collez l’extrait de code suivant sous la mcp clé et enregistrez le fichier. Remplacez la url valeur par le point de terminaison du serveur MCP du Centre des API.

    {
  "servers": {
    "api-center": {
      "url": "https://myapicenter.data.eastus.azure-apicenter.ms/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

  4. VS Code Copilot détecte et se connecte automatiquement au serveur MCP.

Se connecter via l’interface CLI

Les développeurs peuvent utiliser l’interface CLI MCP pour se connecter directement au serveur et appeler les outils de Registre.

  1. Connectez-vous au serveur MCP à l’aide d’une commande comme l’exemple suivant. Remplacez l’URL par le point de terminaison du serveur MCP du Centre d’API.

    mcp connect http https://myapicenter.data.eastus.azure-apicenter.ms/mcp

  2. Recherchez les actifs dans le registre :

    mcp run mcp_registry_search --query "customer-support"

  3. Récupérer les détails d’une ressource spécifique :

    mcp run mcp_registry_fetch --id "my-agent-skill"

Contenu connexe

  • Last updated on