Condividi tramite


Introduzione al server MCP di Azure in Cursor

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 l'ambiente di sviluppo basato su intelligenza artificiale di Cursor
  • 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

Per installare e configurare il server MCP di Azure su Cursor:

  1. Passare a File > Preferenze > Impostazioni Cursore

  2. Selezionare Strumenti e integrazioni nel riquadro di spostamento a sinistra.

  3. Nella sezione Strumenti MCP della pagina selezionare Nuovo server MCP per aprire il file per la mcp.json modifica.

    Screenshot che mostra come configurare un server MCP in Cursor.

  4. Aggiungere la configurazione seguente all'oggetto mcpServers JSON:

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

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 l'interfaccia di chat di Intelligenza artificiale del cursore premendo Ctrl+L o facendo clic sull'icona della chat nella barra laterale.

  2. Immettere un prompt che usa le funzionalità del server MCP di Azure, ad esempio:

    List my Azure storage accounts
    
  3. Se viene richiesto di eseguire l'autenticazione in Azure, eseguire lo strumento di autenticazione suggerito per accedere tramite il browser.

    Annotazioni

    Il cursore 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. Il cursore richiede di eseguire uno strumento per recuperare gli account di archiviazione, ad esempio storage account list. Selezionare Esegui strumento per continuare.

    L'output 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 altre 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
    Show me the configuration of my App Service instances
    

Passaggi successivi