Introduzione al server MCP di Azure con Visual Studio Code

Il server MCP di Azure usa il protocollo MCP (Model Context Protocol) per standardizzare le integrazioni tra app di intelligenza artificiale e strumenti esterni e origini dati, consentendo ai sistemi di intelligenza artificiale di eseguire operazioni con riconoscimento del contesto delle risorse di Azure.

In questo articolo si apprenderà come completare le attività seguenti:

• Installare ed eseguire l'autenticazione nel server MCP di Azure
• Connettersi al server MCP di Azure usando la modalità agente Di GitHub Copilot in Visual Studio Code
• Eseguire richieste per testare le operazioni del server MCP di Azure e interagire con le risorse di Azure

Prerequisiti

• Un account Azure con una sottoscrizione attiva
• Visual Studio Code
• GitHub Copilot Estensione di Visual Studio Code

Installare il server MCP di Azure

Selezionare una delle opzioni seguenti per installare il server MCP di Azure in Visual Studio Code:

Installazione dell'estensione

1. Per installare l'estensione server MCP di Azure per Visual Studio Code, selezionare il collegamento seguente:

   

   Suggerimento

   Per un'esperienza ottimale del server MCP di Azure, installare GitHub Copilot per Azure, che include e usa l'estensione Server MCP di Azure. GitHub Copilot per Azure semplifica il flusso di lavoro di sviluppo e migliora la produttività nella piattaforma Azure.

2. Dopo aver installato l'estensione, aprire GitHub Copilot e selezionare Modalità agente. Per altre informazioni sulla modalità agente, vedere la documentazione di Visual Studio Code.

3. Aggiornare l'elenco degli strumenti per visualizzare Il server MCP di Azure come opzione disponibile:

   

Autenticazione con Azure

Il server MCP di Azure offre un'esperienza di autenticazione senza problemi usando gli account Di Azure e l'ID Microsoft Entra. Per usare il server MCP di Azure, è prima necessario eseguire l'autenticazione in Azure usando strumenti di sviluppo locali, ad esempio l'interfaccia della riga di comando di Azure, l'interfaccia della riga di comando per sviluppatori di Azure, Visual Studio o Visual Studio Code. Il server MCP di Azure individua automaticamente le credenziali da questi strumenti e le usa per eseguire l'autenticazione ai servizi di Azure.

1. Ad esempio, per accedere usando l'interfaccia della riga di comando di Azure:

   az login
   

2. Verificare lo stato di autenticazione eseguendo il comando seguente per visualizzare l'account e la sottoscrizione con cui si è attualmente connessi:

   az account show
   

3. Verificare che l'account utente disponga delle assegnazioni di ruolo appropriate per i servizi di Azure con cui si vuole interagire. Le risorse di Azure a cui si intende accedere con il server MCP di Azure devono già esistere all'interno della sottoscrizione di Azure. Ad esempio, le assegnazioni di ruolo comuni includono:

   • Collaboratore ai dati di archiviazione BLOB : lettura e scrittura di dati BLOB negli account di archiviazione.
   • Collaboratore account di archiviazione - gestisce le configurazioni dell'account di archiviazione.
   • Collaboratore - gestione delle risorse generale della tua sottoscrizione.
   • Lettore : accesso in sola lettura alle risorse di Azure.

   Per altre informazioni sulle assegnazioni di ruolo e sull'autenticazione di sviluppo locale, vedere Autenticare le app .NET nei servizi di Azure durante lo sviluppo locale.

Installazione della directory

È anche possibile installare manualmente il server MCP di Azure per una directory specifica:

1. Aprire una directory vuota o una directory di progetto esistente in Visual Studio Code.

2. Nella radice della cartella creare una .vscode cartella se non ne esiste già una.

3. All'interno della .vscode cartella creare un nuovo file denominato mcp.json aggiungere il codice JSON seguente:

   {
     "servers": {
       "Azure MCP Server": {
         "command": "npx",
         "args": [
           "-y",
           "@azure/mcp@latest",
           "server",
           "start"
         ]
       }
     }
   }
   

4. Salvare le modifiche apportate a mcp.json.

5. Aprire GitHub Copilot e selezionare Modalità agente.

6. Selezionare l'icona degli strumenti per visualizzare gli strumenti disponibili. Cercare Server MCP di Azure per filtrare i risultati.

   

   Per altre informazioni sulla modalità agente, vedere la documentazione di Visual Studio Code.

Usare le istruzioni per testare il server MCP di Azure

1. Aprire GitHub Copilot e selezionare Modalità agente.

2. Immettere un prompt che fa sì che l'agente usi gli strumenti del server MCP di Azure, ad esempio Elenca i gruppi di risorse di Azure.

3. Per autenticare il server MCP di Azure, Copilot richiede l'accesso ad Azure tramite il browser.

   Annotazioni

   Copilot non chiederà di accedere ad Azure se l'autenticazione è già stata eseguita tramite altri strumenti locali, ad esempio l'interfaccia della riga di comando di Azure.

4. Copilot richiede l'autorizzazione per eseguire l'operazione necessaria del server MCP di Azure per la richiesta. Selezionare Continua o usare la freccia per selezionare un comportamento più specifico:

   • La sessione corrente esegue sempre l'operazione nella sessione corrente dell'agente Di GitHub Copilot.
   • L'area di lavoro corrente esegue sempre il comando per l'area di lavoro corrente di Visual Studio Code.
   • Consenti sempre di impostare l'operazione per l'esecuzione sempre per qualsiasi sessione in modalità agente Di GitHub Copilot o per qualsiasi area di lavoro di Visual Studio Code.

   

   L'output per il prompt precedente dovrebbe essere simile al testo seguente:

   The following resource groups are available for your subscription:
   
   1. **DefaultResourceGroup-EUS** (Location: `eastus`)
   2. **rg-testing** (Location: `centralus`)
   3. **rg-azd** (Location: `eastus2`)
   4. **msdocs-sample** (Location: `southcentralus`)
   14. **ai-testing** (Location: `eastus2`)
   
   Let me know if you need further details or actions related to any of these resource groups!
   

5. Esplorare e testare le operazioni MCP di Azure usando altre richieste pertinenti, ad esempio:

   List all of the storage accounts in my subscription
   Get the available tables in my storage accounts
   

Passaggi successivi

Altre informazioni sugli strumenti del server MCP di Azure