Servizio app come server MCP (Model Context Protocol)

Integrare l'app Web come server Model Context Protocol (MCP) per estendere le funzionalità degli agenti di intelligenza artificiale personali leader, ad esempio GitHub Copilot Chat, Cursor e Winsurf. Esponendo le API dell'app tramite MCP, è possibile supercaricare questi agenti con le funzionalità uniche e la logica di business già fornita dall'app Web, senza grandi sforzi di sviluppo o riprogettazione.

Informazioni generali

MCP è uno standard aperto che consente agli assistenti e agli agenti di codifica di intelligenza artificiale di interagire con strumenti esterni e origini dati. Ospitando l'applicazione del servizio app come server MCP, si rende disponibile la funzionalità dell'app Web agli agenti di intelligenza artificiale come strumenti chiamabili con input e output strutturati.

Questa integrazione consente agli sviluppatori di:

  • Estendere gli assistenti AI: Estendere le funzionalità personalizzate a GitHub Copilot Chat, Cursor, Winsurf e altri agenti compatibili con MCP
  • Esporre le API esistenti: trasformare le API REST correnti in strumenti accessibili tramite intelligenza artificiale senza riscrivere il codice
  • Fornire contesto: concedere agli agenti di intelligenza artificiale l'accesso alla logica di business e ai dati dell'applicazione
  • Abilitare l'automazione: consentire agli agenti di eseguire flussi di lavoro complessi concatenando le operazioni dell'app
  • Mantenere il controllo: mantenere il controllo completo sull'autenticazione, l'autorizzazione e l'accesso ai dati

Quando usare il servizio app come server MCP

Prendi in considerazione di implementare la tua app App Service come server MCP quando vuoi:

  • Abilitare gli strumenti di sviluppo: consentire agli sviluppatori di usare agenti di intelligenza artificiale che possono interagire direttamente con le API durante la codifica
  • Creare esperienze copilote personalizzate: creare assistenti di intelligenza artificiale specializzati con una conoscenza approfondita del dominio dell'applicazione
  • Automatizzare i flussi di lavoro: abilitare gli agenti di intelligenza artificiale per eseguire operazioni in più passaggi nell'applicazione
  • Migliorare la produttività degli sviluppatori: ridurre il cambio di contesto portando le funzionalità dell'app nell'IDE
  • Sfruttare l'infrastruttura esistente: usare le app del Servizio app distribuite come strumenti degli agenti senza distribuzioni separate

Se si sta valutando dove ospitare un server MCP in Azure, confrontare il servizio app con altre opzioni in Scegliere un servizio di Azure per l'hosting di server MCP prima di selezionare la destinazione di distribuzione.

MCP è particolarmente utile per le applicazioni line-of-business, gli strumenti interni e i servizi incentrati sullo sviluppatore, in cui rendere facilmente accessibili le funzionalità agli agenti di intelligenza artificiale può migliorare notevolmente la produttività.

Funzionamento di MCP con App Service

L'applicazione del servizio app implementa il protocollo MCP esponendo un set di strumenti (funzioni) che gli agenti possono individuare e richiamare. Quando un agente di intelligenza artificiale deve eseguire un'azione:

  1. L'agente esegue una query sul server MCP per individuare gli strumenti disponibili
  2. L'agente seleziona lo strumento appropriato in base alla finalità dell'utente
  3. L'app del servizio App Service elabora la richiesta e restituisce risultati strutturati
  4. L'agente interpreta i risultati e li presenta all'utente

Il servizio app offre il supporto predefinito per le funzionalità di autenticazione e sicurezza necessarie per i server MCP di produzione, tra cui l'integrazione Microsoft Entra ID e le identità gestite.

Due modi per ospitare un server MCP nel servizio app

Il servizio app supporta due modelli per l'hosting di un server MCP. Selezionare quello che corrisponde al punto di partenza.

Usa il tuo server MCP

Aggiungere un SDK MCP al codice dell'applicazione, esporre un endpoint MCP insieme alle route esistenti e distribuire l'app nello stesso modo in cui si distribuisce qualsiasi altro codice nel servizio app. Questo metodo è la scelta giusta quando si vuole il controllo completo sulle definizioni degli strumenti, quando gli strumenti non eseguono il mapping delle operazioni 1:1 alle operazioni REST o quando si desidera esporre risorse MCP o richieste oltre agli strumenti. Le esercitazioni specifiche del linguaggio seguenti illustrano questo modello.

MCP integrato di App Service (anteprima)

Se l'app è un'API REST esistente con una specifica OpenAPI 3.x, il servizio app può ospitare un server MCP senza modifiche al codice. Basta indicare alla piattaforma la propria specifica OpenAPI e ogni operazione diventa uno strumento MCP esposto tramite HTTP streamabile. L'autenticazione, la negoziazione del protocollo, l'individuazione degli strumenti e il ricaricamento rapido delle specifiche vengono gestite dalla piattaforma.

McP predefinito è ideale quando si vuole esporre rapidamente un'API esistente ai client MCP, quando si vuole che la piattaforma continui con gli aggiornamenti del protocollo MCP o quando si vuole eseguire l'integrazione con l'autenticazione del servizio app senza scrivere codice OAuth.

Per i passaggi di configurazione, i limiti supportati e l'area di gestione, vedere Configurare il McP predefinito del servizio app.

Inizia con le esercitazioni

Contenuti correlati

  • Last updated on