Condividi tramite

Introduzione al server MCP di Azure con Visual Studio

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.
  • Eseguire richieste per testare le operazioni del server MCP di Azure e interagire con le risorse di Azure.

Prerequisiti

Installare il server MCP di Azure

Visual Studio usa un file denominato mcp.json per verificare la presenza di configurazioni del server MCP, incluse le configurazioni configurate da altri ambienti di sviluppo. Le configurazioni del server MCP vengono lette dalle directory seguenti, nell'ordine seguente:

  1. %USERPROFILE%\.mcp.json: funge da configurazione globale del server MCP per un utente specifico. Aggiungere un server MCP qui per caricarlo per tutte le soluzioni di Visual Studio.
  2. <SOLUTIONDIR>\.vs\mcp.json: specifico per Visual Studio e carica solo i server MCP specificati per un utente specifico, per la soluzione specificata.
  3. <SOLUTIONDIR>\.mcp.json: una configurazione MCP a livello di soluzione che è possibile tenere traccia nel controllo del codice sorgente per un repository.
  4. <SOLUTIONDIR>\.vscode\mcp.json: ambito del repository/soluzione e in genere non incluso nel controllo del codice sorgente.
  5. <SOLUTIONDIR>\.cursor\mcp.json: ambito del repository/soluzione e in genere non incluso nel controllo del codice sorgente.

Annotazioni

Alcune di queste posizioni richiedono .mcp.json mentre altre richiedono mcp.json.

Il server MCP di Azure è disponibile come pacchetto NuGet o come pacchetto NPM. Le opzioni seguenti illustrano due degli approcci più comuni per connettersi al server MCP di Azure da Visual Studio.

Annotazioni

In alternativa, è possibile usare l'estensione GitHub Copilot per Azure per installare Azure MCP

Completare la procedura seguente per installare il server MCP di Azure per una directory specifica:

  1. Creare un nuovo file nella radice della soluzione denominata .mcp.json. Usare Visual Studio per modificare questo file in modo che venga applicato automaticamente lo schema JSON.

  2. All'interno del .mcp.json file aggiungere il codice JSON seguente per il pacchetto preferito:

    NuGet:

    {
  "servers": {
      "Azure MCP Server": {
          "command": "dnx",
          "args": [
              "Azure.Mcp",
              "--source",
              "https://api.nuget.org/v3/index.json",
              "--yes",
              "--",
              "azmcp",
              "server",
              "start"
          ],
          "type": "stdio"
      }
  }
}

    NPM

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

  3. Salvare le modifiche.

  4. Aprire GitHub Copilot e selezionare Modalità agente.

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

Screenshot che mostra come configurare il server MCP di Azure in Visual Studio.

Visual Studio 2026 include gli strumenti server MCP di Azure con il carico di lavoro di sviluppo di Azure e AI. Per renderli disponibili:

  1. Aprire lo strumento di installazione di Visual Studio.

  2. Selezionare Modifica per visualizzare i carichi di lavoro disponibili.

  3. Nella scheda Carichi di lavoro selezionare Sviluppo di Azure e intelligenza artificiale.

  4. Nel pannello Dettagli installazione verificare che Sia selezionato GitHub Copilot , che include i componenti seguenti:

    • GitHub Copilot
    • GitHub Copilot per Azure
    • Server MCP di Azure

  5. Selezionare Installa durante il download per completare il processo di installazione.

Screenshot che mostra come installare Copilot usando i carichi di lavoro di Visual Studio.

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.

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 richiede l'accesso 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 Consenti questa volta o usare la freccia per selezionare un comportamento più specifico:

    • 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.
    • Consenti in questa sessione esegue sempre l'operazione nella sessione corrente della modalità agente Di GitHub Copilot.

    Screenshot che mostra come eseguire gli strumenti del server MCP di Azure in Visual Studio.

    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`)
5. **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

  • Last updated on