Condividi tramite

Registrare e individuare server MCP remoti nell'inventario DELLE API

Questo articolo descrive come usare il Centro API di Azure per gestire un inventario (o registro) di server MCP (Remote Model Context Protocol) e aiutare gli stakeholder a individuarli usando 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.

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

Il diagramma seguente illustra l'architettura MCP:

Diagramma dell'architettura MCP (Model Context Protocol).

Questa architettura è costituita dai componenti seguenti:

Componente Descrizione
Host MCP Applicazioni LLM come app di chat o assistenti di intelligenza artificiale negli IDE (ad esempio GitHub Copilot in Visual Studio Code) che devono accedere a funzionalità esterne
Clienti MCP Client di protocollo, all'interno dell'applicazione host, che mantengono connessioni 1:1 con i server
Server MCP Programmi leggeri che espongono funzionalità specifiche e forniscono contesto, strumenti e richieste ai client
Protocollo MCP Livello di trasporto al centro

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.

Server MCP remoti e locali

MCP usa un'architettura client-host-server 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.

Server MCP nell'inventario API

Le sezioni seguenti descrivono come eseguire l'inventario e individuare un server MCP remoto nel Centro API.

Tipo di API MCP

Per registrare un server MCP nell'inventario del centro API, specificare il tipo di API come MCP. Per registrare un'API usando il portale di Azure, vedere Esercitazione: Registrare le API nell'inventario API.

Come descritto nelle sezioni seguenti, quando si registra un server MCP, è possibile specificare un ambiente, una distribuzione e una definizione.

Ambiente e distribuzione per il server MCP

In Centro API specificare un ambiente e una distribuzione per il server MCP. L'ambiente è la posizione del server MCP, ad esempio una piattaforma di gestione API o un servizio di calcolo, e la distribuzione è un URL di runtime per il servizio MCP.

Per informazioni sulla creazione di un ambiente e una distribuzione, vedere Esercitazione: Aggiungere ambienti e distribuzioni per le API.

Definizione per il server MCP remoto

Facoltativamente, aggiungere una definizione API per un server MCP remoto in formato OpenAPI 3.0. La definizione dell'API deve includere un endpoint URL per il server MCP. Per un esempio di aggiunta di una definizione OpenAPI, vedere Esercitazione: Registrare le API nell'inventario API.

È possibile usare la seguente definizione API OpenAPI 3.0 leggera per il server MCP, che include un url endpoint per il server MCP:

{
  "openapi": "3.0.0",
  "info": {
    "title": "Demo MCP server",
    "description": "Very basic MCP server that exposes mock tools and prompts.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://my-mcp-server.contoso.com"
    }
  ]
}

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. Gli utenti possono esplorare e filtrare i server MCP nell'inventario e visualizzare i dettagli, ad esempio l'endpoint URL del server MCP, se disponibile nella definizione API del server MCP.

Screenshot del server MCP nel portale di Centro API.

Annotazioni

L'endpoint URL per il server MCP è visibile solo nel portale di Centro API se si aggiunge una distribuzione MCP e una definizione API per il server MCP.

Contenuti correlati