API's detecteren met de AZURE API Center MCP-server

De Azure API Center MCP-server maakt de API-catalogus van uw organisatie beschikbaar als een systeemeigen hulpprogrammaoppervlak voor AI-agents en agentische werkstromen. Wanneer u de MCP-server van API Center inschakelt, maakt u uw API's en AI-assets detecteerbaar door het groeiende ecosysteem van MCP-compatibele AI-clients, waaronder Visual Studio Code Copilot, Claude Code en aangepaste agents.

De Azure API Center MCP-server bevat de volgende hulpprogramma's die agents gebruiken om assets te detecteren en op te halen uit de inventaris van uw API-centrum (register).

Tool Beschrijving
mcp_registry_search Doorzoekt het API Center-register om API's en AI-assets te detecteren op naam, type of metagegevens. Retourneert overeenkomende resultaten, waaronder assettype (REST, MCP, invoegtoepassing, vaardigheid), levenscyclusstatus en beschrijvingen.
mcp_registry_fetch Haalt gedetailleerde informatie over een specifieke API of AI-asset op uit het register, inclusief implementatie-eindpunten, versies, definities en bijbehorende specificaties.

Prerequisites

  • Een API-centrum in uw Azure-abonnement. Als u er nog geen hebt, raadpleegt u quickstart: Uw API-centrum maken.

  • Een of meer API's of AI-assets die zijn geregistreerd in uw API Center-inventaris, zoals MCP-servers of vaardigheden.

  • De API Center-portal is ingeschakeld en ingesteld voor uw API-centrum. Zie Uw API Center-portal instellen en aanpassen voor meer informatie. De toegangsmethode die u kiest voor de portal (anonieme of Microsoft Entra ID-verificatie) bepaalt hoe ontwikkelaars zich verifiëren wanneer ze toegang hebben tot de MCP-server.

  • Een met MCP compatibele client zoals Visual Studio Code met Copilot, Claude Code of een aangepaste agent.

  • Zorg ervoor dat het MCP CLI-hulpprogramma is geïnstalleerd voor CLI-gebruik.

De AZURE API Center MCP-server inschakelen

De MCP-server inschakelen met behulp van de Azure-portal:

  1. Ga in Azure Portal naar uw API-centrum.
  2. Selecteer gegevens-API-instellingen in het zijbalkmenu onder Verbruik.
  3. Selecteer onder MCP-eindpuntAPI Center MCP-eindpunt inschakelen.

Schermopname van het MCP-eindpunt van API Center in de portal.

Het MCP-servereindpunt volgt deze vorm:

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

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

Important

Je kunt het MCP-eindpunt alleen inschakelen voor de Standard-tier. Als je API Center in de Gratis-laag valt, moet je upgraden naar Standard om de MCP-server in te schakelen. Voor meer informatie over het upgraden van uw API-centrum, zie de FAQ.

Verbinding maken met de MCP-server

Nadat u de API Center MCP-server hebt ingeschakeld, kunnen ontwikkelaars het MCP-servereindpunt detecteren wanneer ze zich aanmelden bij de API Center-portal. Ontwikkelaars kunnen verbinding maken met de MCP-server met behulp van een MCP-client, zoals Visual Studio Code of de MCP CLI. Voor de verbinding zijn het MCP-servereindpunt en de juiste verificatiereferenties vereist, indien geconfigureerd.

Zie Een MCP-server toevoegen aan Claude Code om verbinding te maken met de MCP-server met behulp van Claude Code.

Verbinding maken via VS Code

Ontwikkelaars kunnen de MCP-serverconfiguratie toevoegen aan hun Visual Studio Code settings.json-bestand onder de sleutel mcp.

  1. Open Visual Studio Code en druk op Ctrl+Shift+P (of Cmd+Shift+P op Mac).

  2. Zoek naar Open User Settings (JSON).

  3. Plak het volgende fragment onder de mcp sleutel en sla het bestand op. Vervang de url waarde door het MCP-servereindpunt van uw API Center.

    {
      "servers": {
        "api-center": {
          "url": "https://myapicenter.data.eastus.azure-apicenter.ms/mcp",
          "type": "http"
        }
      },
      "inputs": []
    }
    
  4. VS Code Copilot automatisch detecteert en maakt verbinding met de MCP-server.

Verbinding maken via CLI

Ontwikkelaars kunnen de MCP CLI gebruiken om rechtstreeks verbinding te maken met de server en de registerhulpprogramma's aan te roepen.

  1. Maak verbinding met de MCP-server met behulp van een opdracht zoals in het volgende voorbeeld. Vervang de URL door het MCP-servereindpunt van uw API Center.

    mcp connect http https://myapicenter.data.eastus.azure-apicenter.ms/mcp
    
  2. Zoek in het register naar assets:

    mcp run mcp_registry_search --query "customer-support"
    
  3. Details ophalen voor een specifieke asset:

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