Registrare i server MCP ospitati in Funzioni di Azure nel Centro API di Azure

Dopo aver ospitato il server MCP in remoto su Azure Functions, registrarlo nel Centro API di Azure. Il Centro API di Azure gestisce un inventario (o un registro) di server MCP remoti in modo che siano facilmente individuabili nell'organizzazione. Tutti i server MCP registrati vengono visualizzati nel portale del Centro API per i team dell'organizzazione.

Suggerimento

Il nome del Centro API diventa il nome del catalogo degli strumenti privato nel filtro del Registro di sistema. Scegliere un nome informativo che consenta agli utenti di identificare il catalogo degli strumenti dell'organizzazione.

Creare le risorse

1. Accedere al portale di Azure, quindi creare una risorsa del Centro API di Azure, se non ne è già disponibile una.

2. Creare un ambiente nella risorsa del Centro API. Per Tipo di server> selezionare FunzionidiAzure.

Registrare il server MCP

Registrare il server MCP remoto aggiungendolo come API:

1. Nel riquadro di navigazione a sinistra della risorsa Centro API, selezionare API.

2. Selezionare + Registra un'API. Nella tabella seguente vengono forniti valori di esempio per le impostazioni necessarie. È anche possibile compilare le impostazioni facoltative, ad esempio la descrizione del server MCP, il repository, la documentazione esterna e altre informazioni visualizzate nel portale del Centro API.

   Impostazione	Value
   Titolo API	Immettere un nome descrittivo per il server MCP, ad esempio Weather MCP Server.
   Identificazione	Questo valore viene generato automaticamente in base al titolo dell'API, ma è possibile modificarlo.
   Tipo di API	MCP
   Runtime URL	Immettere l'endpoint server MCP, ad esempio https://contoso.azurewebsites.net/mcp
   Ambiente	Selezionare l'ambiente creato in precedenza.
   Titolo della versione	Immettere un titolo di versione di propria scelta, ad esempio v1.
   Identificazione della versione	Dopo aver immesso il titolo precedente, il Centro API di Azure genera questo identificatore, che è possibile sostituire.
   Ciclo di vita della versione	Selezionare il valore più appropriato nell'elenco a discesa, ad esempio Test o Produzione.

3. Fare clic su Crea.

   Verrà visualizzato il server MCP registrato come API nell'elenco.

Aggiornare la definizione del server

1. Creare una definizione API per un server MCP remoto in formato OpenAPI 3.0. Questa definizione è necessaria in modo che il portale di Centro API mostri l'endpoint URL del server MCP. Salva la definizione dove puoi accedervi. È necessario caricarlo nel passaggio successivo.

   Definizione dell'API OpenAPI 3.0 di esempio per il server MCP:

   {
       "openapi": "3.0.0",
       "info": {
           "title": "Weather MCP server",
           "description": "MCP server with tools returning weather forecast and alerts.",
           "version": "1.0"
       },
       "servers": [
           {
               "url": "https://my-mcp-server.azurewebsites.net/mcp"
           }
       ]
   }
   

2. Aggiornare la definizione del server:

   a. Nel menu a sinistra trovare Asset -> API.

   b. Selezionare il nome del server MCP per aprire la registrazione.

   c. Nel menu a sinistra trovare Dettagli -> Versioni.

   d. In "Versione" trovare ed espandere "v1". Selezionare quindi Definizione trasmettebile per... per aprire la definizione.

   d. Selezionare Sostituisci.

   e. Nel riquadro laterale visualizzato modificare "Versione specifica" in 3.0, quindi caricare la definizione dall'ultimo passaggio.

   f. Selezionare Sostituisci.

Configurare il portale di Centro API

1. Configurare il portale se non ne è già disponibile uno.

2. Dopo aver configurato il portale, è possibile accedervi all'indirizzo https://<service-name>.portal.<location>.azure-apicenter.ms. Sostituire <service-name> e <location> con il nome del centro API e la posizione in cui è stata distribuita. È necessario accedere per visualizzare i server MCP registrati.

3. Quando si seleziona un nome del server, viene aperto un riquadro che mostra le informazioni in base ai dati forniti durante la registrazione del server e alla definizione dell'API caricata. Gli utenti con accesso al portale possono connettersi ai server di propria scelta copiando l'URL dell'endpoint o l'installazione nell'integrazione di Visual Studio Code.

   

Articoli correlati

Informazioni sui server MCP in Gestione API di Azure