Condividi tramite

Guida introduttiva: Integrare il server MCP di Azure con l'interfaccia della riga di comando di GitHub Copilot

In questa guida introduttiva si apprenderà come connettere il server MCP (Azure Model Context Protocol) all'interfaccia della riga di comando di GitHub Copilot. Questa integrazione consente a GitHub Copilot di interagire con le risorse di Azure direttamente dal terminale.

Prerequisiti

Accedere al server MCP di Azure per lo sviluppo locale

Il server MCP di Azure esegue l'autenticazione con Microsoft Entra ID usando la libreria di identità di Azure per .NET. Il server supporta due modalità di autenticazione:

  • Modalità Broker: usa l'autenticazione nativa del sistema operativo (ad esempio Gestione Account Web di Windows) con InteractiveBrowserCredential.
  • Modalità catena di credenziali: prova più metodi di autenticazione in sequenza: variabili di ambiente, Visual Studio Code, Visual Studio, interfaccia della riga di comando di Azure, Azure PowerShell, interfaccia della riga di comando per sviluppatori di Azure e autenticazione interattiva del browser.

Accedere usando uno dei metodi seguenti:

  1. Aprire il riquadro comandi (Ctrl+Shift+P o Cmd+Shift+P su Mac).
  2. Eseguire Azure: accedere e seguire le istruzioni.

Dopo l'accesso, il server MCP di Azure può autenticare ed eseguire operazioni sui servizi di Azure in base alle autorizzazioni.

Aggiungere il server MCP di Azure

L'interfaccia della riga di comando di GitHub Copilot supporta i server MCP tramite la /mcp famiglia di comandi.

  1. Aprire il terminale.

  2. Avviare l'interfaccia della riga di comando di GitHub Copilot in modalità interattiva:

    copilot

  3. Nella sessione interattiva eseguire il comando seguente per aprire il modulo di configurazione del server MCP:

    /mcp add

  4. Compilare i campi di configurazione con i valori seguenti:

    Campo Value
    Nome server azure-mcp
    Tipo di server 1 (Locale)
    Comando npx -y @azure/mcp@latest server start
    Variabili di ambiente (lasciare vuoto: utilizza l'autenticazione CLI di Azure)
    Strumenti *

    Annotazioni

    Se si preferisce usare .NET, impostare il comando su dotnet dnx -p Azure.Mcp server start.

  5. Premere CTRL+S (o Cmd+S in macOS) per salvare la configurazione del server.

  6. Al termine, premere esc per chiudere la configurazione del server.

Verificare la connessione

Verificare di aver configurato correttamente il server MCP di Azure e che l'interfaccia della riga di comando di GitHub Copilot lo riconosca:

  1. Nella sessione CLI di Copilot, esegui:

    /mcp show

  2. Esaminare l'output. Dovresti vedere azure-mcp elencato nella configurazione:

    ● MCP Server Configuration:
  • azure-mcp (local): Command: npx

Total servers: 1
Config file: ~/.copilot/mcp-config.json

Usare il server MCP di Azure

Dopo la connessione, è possibile usare il linguaggio naturale per interagire con le risorse di Azure.

  1. Nella sessione CLI di GitHub Copilot, digitare un prompt che richieda il contesto di Azure. Per esempio:

    > List my Azure resource groups.

  2. GitHub Copilot identifica la finalità e usa gli azure-mcp strumenti per recuperare le informazioni. Stampa una risposta che elenca i gruppi di risorse di Azure, in modo analogo a:

    I found the following resource groups in your subscription:

- **my-resource-group-1** (East US)
- **dev-environment** (West Europe)
- **production-app** (Central US)

Gestire i server MCP

Gestire i server MCP configurati usando i comandi seguenti:

  • Elenco server:/mcp show
  • Rimuovere un server:/mcp remove azure-mcp
  • Ottenere assistenza:/mcp help

Passaggi successivi

  • Last updated on