Individuare le API con il server MCP del Centro API Azure

Il server MCP del Centro API Azure espone il catalogo API dell'organizzazione come superficie di strumenti nativa per gli agenti di intelligenza artificiale e i flussi di lavoro agenti. Quando si abilita il server MCP del Centro API, le API e gli asset di intelligenza artificiale sono individuabili dall'ecosistema crescente di client di intelligenza artificiale compatibili con MCP, tra cui Visual Studio Code Copilot, Claude Code e agenti personalizzati.

Il server MCP del Centro API Azure espone gli strumenti seguenti usati dagli agenti per individuare e recuperare gli asset dall'inventario del centro API (registro).

Prerequisiti

• Un centro API nella sottoscrizione Azure. Se non ne hai uno, vedere Avvio rapido: Creare il centro API.

• Una o più API o asset di intelligenza artificiale registrati nell'inventario del centro API, ad esempio server MCP o competenze.

• Il portale dell'API Center è stato abilitato e configurato per il tuo Centro API. Per informazioni dettagliate, vedere Configurare e personalizzare il portale di Centro API. Il metodo di accesso scelto per il portale (autenticazione anonima o Microsoft Entra ID) determina il modo in cui gli sviluppatori eseguono l'autenticazione quando accedono al server MCP.

• Un client compatibile con MCP, ad esempio Visual Studio Code con Copilot, Claude Code o un agente personalizzato.

• Per utilizzare la CLI, assicurarsi che lo strumento MCP CLI sia installato.

Abilitare il server MCP del Centro API Azure

Per abilitare il server MCP tramite il portale di Azure:

1. Nel portale di Azure passare al centro API.
2. Nel menu della barra laterale, in Consumo, selezionare Impostazioni API dati.
3. In Endpoint MCP, seleziona Abilita endpoint MCP di API Center.

L'endpoint server MCP segue questo formato:

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

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

Connettersi al server MCP

Dopo aver abilitato il server MCP del Centro API, gli sviluppatori possono individuare l'endpoint server MCP quando accedono al portale del Centro API. Gli sviluppatori possono connettersi al server MCP usando un client MCP, ad esempio Visual Studio Code o l'interfaccia della riga di comando mcp. La connessione richiede l'endpoint server MCP e le credenziali di autenticazione appropriate, se configurate.

Per connettersi al server MCP usando Claude Code, vedere Aggiungere un server MCP a Claude Code.

Connettersi tramite VS Code

Gli sviluppatori possono aggiungere la configurazione del server MCP al file Visual Studio Code settings.json nella chiave mcp.

1. Aprire Visual Studio Code e premere Ctrl+Shift+P (o Cmd+Shift+P in Mac).

2. Cerca Apri impostazioni utente (JSON).

3. Incollare il frammento di codice seguente sotto la mcp chiave e salvare il file. Sostituisci il valore url con l'endpoint del server MCP di API Center.

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

4. VS Code Copilot rileva e si connette automaticamente al server MCP.

Connettersi tramite CLI

Gli sviluppatori possono usare l'interfaccia della riga di comando mcp per connettersi direttamente al server e richiamare gli strumenti del Registro di sistema.

1. Connettersi al server MCP usando un comando simile all'esempio seguente. Sostituisci l'URL con l'endpoint del server MCP di API Center.

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

2. Cerca gli asset nel registro:

   mcp run mcp_registry_search --query "customer-support"
   

3. Recuperare i dettagli per un asset specifico:

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

Contenuti correlati

• Configurare e personalizzare il portale di Centro API
• Abilitare l'individuazione dei plug-in del Centro API da un marketplace di plug-in