Delen via

Aan de slag met de Azure MCP-server met Visual Studio

De Azure MCP-server gebruikt het MCP (Model Context Protocol) om integraties tussen AI-apps en externe hulpprogramma's en gegevensbronnen te standaardiseren, zodat AI-systemen bewerkingen kunnen uitvoeren die contextbewust zijn voor uw Azure-resources.

In dit artikel leert u hoe u de volgende taken uitvoert:

  • Installeer en authenticeren bij de Azure MCP-server.
  • Maak verbinding met Azure MCP Server met behulp van de GitHub Copilot-agentmodus in Visual Studio.
  • Voer prompts uit om Bewerkingen van Azure MCP Server te testen en te communiceren met Azure-resources.

Vereiste voorwaarden

De Azure MCP-server installeren

Visual Studio gebruikt een bestand met de naam mcp.json om te controleren op MCP Server-configuraties, inclusief configuraties die zijn ingesteld door andere ontwikkelomgevingen. MCP-serverconfiguraties worden gelezen uit de volgende mappen, in de volgende volgorde:

  1. %USERPROFILE%\.mcp.json: fungeert als een globale MCP-serverconfiguratie voor een specifieke gebruiker. Voeg hier een MCP-server toe om deze te laden voor alle Visual Studio-oplossingen.
  2. <SOLUTIONDIR>\.vs\mcp.json: Specifiek voor Visual Studio en laadt alleen de opgegeven MCP-servers voor een specifieke gebruiker voor de opgegeven oplossing.
  3. <SOLUTIONDIR>\.mcp.json: Een MCP-configuratie op oplossingsniveau die u kunt bijhouden in broncodebeheer voor een opslagplaats.
  4. <SOLUTIONDIR>\.vscode\mcp.json: Gericht op de opslagplaats/oplossing en doorgaans niet opgenomen in broncodebeheer.
  5. <SOLUTIONDIR>\.cursor\mcp.json: Gericht op de opslagplaats/oplossing en doorgaans niet opgenomen in broncodebeheer.

Opmerking

Sommige van deze locaties vereisen .mcp.json terwijl andere mcp.jsonvereisen.

Azure MCP Server is beschikbaar als een NuGet-pakket of als NPM-pakket. De volgende opties laten twee van de meest voorkomende benaderingen zien om vanuit Visual Studio verbinding te maken met Azure MCP Server.

Voer de volgende stappen uit om Azure MCP Server te installeren voor een specifieke map:

  1. Maak een nieuw bestand in de hoofdmap van uw oplossing met de naam .mcp.json. Gebruik Visual Studio om dit bestand te bewerken, zodat het JSON-schema automatisch wordt toegepast.

  2. Voeg in het .mcp.json bestand de volgende JSON toe voor uw voorkeurspakket:

    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. Sla uw wijzigingen op.

  4. Open GitHub Copilot en selecteer agentmodus.

  5. Selecteer het pictogram Hulpprogramma's om de beschikbare hulpprogramma's weer te geven. Zoek naar Azure MCP Server om de resultaten te filteren.

Een schermopname van het configureren van Azure MCP Server in Visual Studio.

Verifiëren bij Azure

Azure MCP Server biedt een naadloze verificatie-ervaring met behulp van Azure-accounts en Microsoft Entra-id. Als u Azure MCP Server wilt gebruiken, moet u zich eerst verifiëren bij Azure met behulp van lokale ontwikkelhulpprogramma's zoals de Azure CLI, Azure Developer CLI, Visual Studio of Visual Studio Code. Azure MCP Server ontdekt automatisch uw referenties vanuit deze hulpprogramma's en gebruikt deze om bij Azure-services te authenticeren.

  1. Als u zich bijvoorbeeld wilt aanmelden met behulp van de Azure CLI:

    az login

  2. Controleer uw verificatiestatus door de volgende opdracht uit te voeren om te zien met welk account en welk abonnement u momenteel bent aangemeld:

    az account show

  3. Zorg ervoor dat uw gebruikersaccount de juiste roltoewijzingen heeft voor de Azure-services waarmee u wilt communiceren. De Azure-resources die u wilt openen met Azure MCP Server, moeten al bestaan binnen uw Azure-abonnement. Algemene roltoewijzingen zijn bijvoorbeeld:

    • Inzender voor Blob Storage-gegevens - Blob-gegevens lezen en schrijven in opslagaccounts.
    • Bijdrager aan opslagaccount - Beheer configuraties van opslagaccounts.
    • Inzender : algemeen resourcebeheer voor uw abonnement.
    • Lezer : alleen-lezentoegang tot Azure-resources.

    Zie .NET-apps verifiëren bij Azure-services tijdens lokale ontwikkeling voor meer informatie over roltoewijzingen en lokale ontwikkelingsverificatie.

Vragen gebruiken om de Azure MCP-server te testen

  1. Open GitHub Copilot en selecteer agentmodus.

  2. Voer een prompt in die ervoor zorgt dat de agent azure MCP Server-hulpprogramma's gebruikt, zoals Mijn Azure-resourcegroepen weergeven.

  3. Om Azure MCP Server te verifiëren, wordt u door Copilot gevraagd u aan te melden bij Azure met behulp van de browser.

    Opmerking

    Copilot vraagt u niet om u aan te melden bij Azure als u al bent geverifieerd via andere lokale hulpprogramma's, zoals de Azure CLI.

  4. Copilot vraagt om toestemming om de benodigde bewerking op de Azure MCP-server uit te voeren voor uw commando. Selecteer Deze keer toestaan of gebruik de pijl om een specifieker gedrag te selecteren:

    • Sta altijd toe dat de bewerking altijd wordt uitgevoerd voor elke GitHub Copilot Agent Mode-sessie of een Visual Studio Code-werkruimte.
    • In deze sessie toestaan voert de bewerking altijd uit in de huidige GitHub Copilot-agentmodus.

    Een schermopname van het uitvoeren van Azure MCP Server-hulpprogramma's in Visual Studio.

    De uitvoer voor de vorige prompt moet eruitzien als de volgende tekst:

    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. Verken en test de Azure MCP-bewerkingen met behulp van andere relevante prompts, zoals:

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

Volgende stappen

Meer informatie over Azure MCP Server-hulpprogramma's