Registrare e individuare i server MCP nell'inventario delle API

Questo articolo descrive come usare il Centro API di Azure per gestire un inventario (o registro) di server MCP (Remote Or Local Model Context Protocol) e aiutare gli stakeholder a individuarli tramite il portale del Centro API. I server MCP espongono API back-end o origini dati in modo standard agli agenti di intelligenza artificiale e ai modelli che li usano.

Come illustrato in questo articolo, è possibile registrare server MCP remoti o locali usando il portale di Azure in modo simile al modo in cui si registrano API e altri asset. Il Centro API fornisce anche collegamenti ai server MCP partner che è possibile registrare nell'inventario.

Informazioni sui server MCP

Gli agenti di intelligenza artificiale stanno diventando ampiamente adottati a causa di funzionalità LLM (Large Language Model) avanzate. Tuttavia, anche i modelli più avanzati affrontano limitazioni a causa del loro isolamento dai dati esterni. Ogni nuova origine dati richiede potenzialmente implementazioni personalizzate per estrarre, preparare e rendere accessibili i dati per i modelli.

Il protocollo MCP ( Model Context Protocol ) consente di risolvere questo problema. MCP è uno standard aperto per la connessione di modelli e agenti di intelligenza artificiale con origini dati esterne, ad esempio origini dati locali (database o file di computer) o servizi remoti (sistemi disponibili su Internet, ad esempio database remoti o API).

Architettura MCP

MCP segue un'architettura client-server in cui un'applicazione host può connettersi a più server. Ogni volta che l'host mcp o il client necessita di uno strumento, si connette al server MCP. Il server MCP si connette quindi a un database o a un'API. Gli host e i server MCP si connettono tra loro tramite il protocollo MCP.

L'architettura MCP è basata su JSON-RPC 2.0 per la messaggistica. La comunicazione tra client e server avviene su livelli di trasporto definiti e supporta principalmente due modalità di funzionamento:

• Server MCP remoti : i client MCP si connettono ai server MCP tramite Internet, stabilendo una connessione tramite eventi HTTP e inviati dal server e autorizzando l'accesso client MCP alle risorse nell'account dell'utente tramite OAuth.

• Server MCP locali I client MCP si connettono ai server MCP nello stesso computer, usando input/output standard come metodo di trasporto locale.

Prerequisiti

• Un centro API. Se non si ha ancora un centro API, vedere la guida introduttiva per Creare un centro API.
• Un endpoint dell'URL del server MCP remoto o un pacchetto server MCP da registrare.
• (Per un server MCP remoto) Un ambiente nel centro API da associare al server MCP. L'ambiente è la posizione del server MCP, ad esempio una piattaforma di gestione API o un servizio di calcolo.

Registrare un server MCP remoto

Per registrare un server MCP remoto:

1. Accedere al portale di Azure e passare al centro API.
2. Nel menu della barra laterale, in Inventario, selezionare Asset.
3. Seleziona + Registra un asset>server MCP.
   
4. Nel modulo Registra un server MCP specificare le informazioni sul server MCP:
   1. Immettere un titolo per il server MCP. Il Centro API genera automaticamente un'identificazione in base al titolo, ma è possibile modificarla, se necessario.
   2. Immettere un riepilogo e una descrizione per il server MCP per fornire un contesto più dettagliato.
   3. Facoltativamente, immettere un URL icona per associare un'immagine al server MCP.
   4. In Casi d'uso specificare facoltativamente un nome e una descrizione per uno o più casi d'uso per il server MCP.
   5. Sotto Telecomandi, eseguire le operazioni seguenti:
      1. Selezionare + Aggiungi remoto.
      2. Immettere un URL di runtime per il server MCP.
      3. Selezionare un ambiente del Centro API che corrisponde alla posizione del server MCP, ad esempio una piattaforma di gestione API o un servizio di calcolo.
      4. Seleziona Salva.
      5. Facoltativamente, ripetere i passaggi precedenti per aggiungere più remote se il server MCP ha più endpoint o viene distribuito in più ambienti.
   6. Facoltativamente, selezionare Aggiungi repository per fornire un URL a un repository di codice associato al server MCP.
   7. In Titolo versione specificare un titolo della versione, l'identificazione della versione e il ciclo di vita della versione per il server MCP. Scopri di più sulle versioni nel Centro API.
   8. Facoltativamente, aggiungere collegamenti alla documentazionedi licenza ed esterna e informazioni associate per il server MCP.
   9. Fare clic su Crea.

Definizioni per il server MCP remoto

Il Centro API genera automaticamente le definizioni OpenAPI seguenti per un server MCP remoto e le associa alla versione del server registrata:

• Definizione SSE, per l'uso di eventi inviati dal server (SSE) come protocollo agentico
• Definizione streamable, per l'uso di un protocollo agentico agnostico rispetto al trasporto

Registrare un server MCP locale

È possibile registrare un server MCP installato in locale usando una gestione pacchetti, npm ad esempio o pypi.

Per registrare un server MCP locale:

1. Accedere al portale di Azure e passare al centro API.
2. Nel menu della barra laterale, in Inventario, selezionare Asset.
3. Selezionare + Registra un asset>server MCP.
4. Nel modulo Registra un server MCP specificare le informazioni sul server MCP:
   1. Immettere un titolo per il server MCP. Il Centro API genera automaticamente un'identificazione in base al titolo, ma è possibile modificarla, se necessario.
   2. Immettere un riepilogo e una descrizione per il server MCP per fornire un contesto più dettagliato.
   3. Facoltativamente, immettere un URL icona per associare un'immagine al server MCP.
   4. In Casi d'uso specificare facoltativamente un nome e una descrizione per uno o più casi d'uso per il server MCP.
   5. In Pacchetti eseguire le operazioni seguenti:
      1. Selezionare + Aggiungi pacchetto.
      2. Immettere un Registro pacchetti per l'installazione del server MCP. Ad esempio: npm.
      3. Immettere un nome pacchetto dal Registro di sistema dei pacchetti e una versione.
      4. In Hint di runtime immettere il comando di runtime usato per eseguire il server MCP. Ad esempio: npx.
      5. Negli argomenti di runtime, passare facoltativamente argomenti durante l'esecuzione del server MCP.
      6. Seleziona Salva.
      7. Facoltativamente, ripetere i passaggi precedenti per aggiungere altri pacchetti se il server MCP è disponibile in più registri pacchetti o dispone di più versioni.
   6. Facoltativamente, selezionare Aggiungi repository per fornire un URL a un repository di codice associato al server MCP.
   7. In Titolo versione specificare un titolo della versione, l'identificazione della versione e il ciclo di vita della versione per il server MCP. Scopri di più sulle versioni nel Centro API.
   8. Facoltativamente, aggiungere collegamenti alla documentazionedi licenza ed esterna e informazioni associate per il server MCP.
   9. Fare clic su Crea.

Registrare un server MCP partner

Centro API di Azure offre un elenco curato di server MCP partner che è possibile aggiungere all'inventario API. Questo elenco include i server MCP dei servizi Microsoft, ad esempio App per la logica di Azure, GitHub e altri.

Registrare uno o più server MCP partner nell'inventario API per renderli disponibili per sviluppatori e altri stakeholder dell'organizzazione.

Per registrare un server MCP partner:

1. Nel portale di Azure passare al centro API.
2. Nel menu della barra laterale, nella voce Scopri, selezionare MCP (anteprima).
3. Sfoglia i server MCP partner disponibili. Selezionare Registra per aggiungere un server MCP all'inventario API. Seguire le istruzioni visualizzate, se disponibili, per completare la registrazione.

Quando si aggiunge un server MCP partner, Centro API configura automaticamente le impostazioni seguenti:

• Crea una voce API nell'inventario API con il tipo di API impostato su MCP.
• Crea un ambiente e una distribuzione per il server MCP.
• Aggiunge le definizioni OpenAPI per il server MCP se il partner le fornisce.

Creare e registrare i propri server MCP

Per creare server MCP usando i servizi di calcolo di Azure e registrarli nel centro API, vedere gli esempi seguenti:

• Creare e registrare un server MCP di Logic Apps
• Creare e registrare un server MCP di Funzioni di Azure

Individuare i server MCP usando il portale del Centro API

Configurare il portale di Centro API in modo che gli sviluppatori e altri stakeholder dell'organizzazione possano individuare i server MCP nell'inventario API. Dal portale di Centro API gli utenti possono eseguire le operazioni seguenti:

• Esplorare e filtrare i server MCP nell'inventario.
• Per i server MCP remoti, visualizzare i dettagli, ad esempio l'endpoint URL del server MCP e la definizione dell'API, e installare il server MCP nell'ambiente Visual Studio Code.

Gestire l'accesso ai server MCP

Facoltativamente, usare le funzionalità di gestione degli accessi del Centro API per gestire chi può visualizzare e accedere ai server MCP nell'inventario. Per altre informazioni, vedere Autorizzare l'accesso alle API nel centro API.

Contenuti correlati

• Informazioni sui server MCP in Gestione API
• Importare le API nel centro API da Gestione API
• Usare l'estensione di Visual Studio per il Centro API per compilare e registrare API da Visual Studio Code.
• Per un esempio live del modo in cui il Centro API di Azure può alimentare il registro MCP privato e pronto per le aziende, visitare MCP Center.