Teilen über

Erste Schritte mit Azure MCP Server mit Visual Studio

Der Azure MCP-Server verwendet das Model Context Protocol (MCP), um Integrationen zwischen KI-Apps und externen Tools und Datenquellen zu standardisieren, sodass KI-Systeme Vorgänge ausführen können, die kontextbewusst von Ihren Azure-Ressourcen sind.

In diesem Artikel erfahren Sie, wie Sie die folgenden Aufgaben ausführen:

  • Installieren und authentifizieren Sie sich beim Azure MCP-Server.
  • Stellen Sie eine Verbindung mit Azure MCP Server mithilfe des GitHub Copilot-Agentmodus in Visual Studio her.
  • Führen Sie Eingabeaufforderungen aus, um Azure MCP Server-Vorgänge zu testen und mit Azure-Ressourcen zu interagieren.

Voraussetzungen

Installieren des Azure MCP-Servers

Visual Studio verwendet eine Datei mit dem Namen mcp.json , um nach MCP-Serverkonfigurationen zu suchen, einschließlich konfigurationen, die von anderen Entwicklungsumgebungen eingerichtet wurden. MCP-Serverkonfigurationen werden aus den folgenden Verzeichnissen gelesen, in der folgenden Reihenfolge:

  1. %USERPROFILE%\.mcp.json: Dient als globale MCP-Serverkonfiguration für einen bestimmten Benutzer. Fügen Sie hier einen MCP-Server hinzu, damit er für alle Visual Studio-Lösungen geladen wird.
  2. <SOLUTIONDIR>\.vs\mcp.json: Spezifisch für Visual Studio und lädt nur die angegebenen MCP-Server für einen bestimmten Benutzer, für die angegebene Lösung.
  3. <SOLUTIONDIR>\.mcp.json: Eine MCP-Konfiguration auf Lösungsebene, die Sie in der Quellcodeverwaltung für ein Repository nachverfolgen können.
  4. <SOLUTIONDIR>\.vscode\mcp.json: Bereich des Repositorys/der Lösung und in der Regel nicht in der Quellcodeverwaltung enthalten.
  5. <SOLUTIONDIR>\.cursor\mcp.json: Bereich des Repositorys/der Lösung und in der Regel nicht in der Quellcodeverwaltung enthalten.

Hinweis

Einige dieser Standorte erfordern .mcp.json, während andere mcp.jsonerfordern.

Azure MCP Server ist als NuGet-Paket oder als NPM-Paket verfügbar. Die folgenden Optionen veranschaulichen zwei der am häufigsten verwendeten Ansätze zum Herstellen einer Verbindung mit Azure MCP Server aus Visual Studio.

Hinweis

Alternativ können Sie die GitHub Copilot für Azure-Erweiterung verwenden, um Azure MCP zu installieren.

Führen Sie die folgenden Schritte aus, um Azure MCP Server für ein bestimmtes Verzeichnis zu installieren:

  1. Erstellen Sie eine neue Datei im Stammverzeichnis Der Lösung mit dem Namen .mcp.json. Verwenden Sie Visual Studio, um diese Datei so zu bearbeiten, dass das JSON-Schema automatisch angewendet wird.

  2. Fügen Sie in der .mcp.json Datei den folgenden JSON-Code für Ihr bevorzugtes Paket hinzu:

    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. Speichern Sie die Änderungen.

  4. Öffnen Sie GitHub Copilot, und wählen Sie den Agentmodus aus.

  5. Wählen Sie das Symbol "Tools" aus, um die verfügbaren Tools anzuzeigen. Suchen Sie nach Azure MCP Server , um die Ergebnisse zu filtern.

Screenshot, der zeigt, wie Azure MCP Server in Visual Studio konfiguriert wird.

Visual Studio 2026 enthält Azure MCP Server-Tools mit dem Azure- und KI-Entwicklungs-Workload. So stellen Sie sie zur Verfügung:

  1. Öffnen Sie das Visual Studio Installer-Tool.

  2. Wählen Sie "Ändern" aus, um verfügbare Arbeitslasten anzuzeigen.

  3. Wählen Sie auf der Registerkarte "Workloads " die Option "Azure" und "KI-Entwicklung" aus.

  4. Überprüfen Sie im Bereich "Installationsdetails ", ob GitHub Copilot ausgewählt ist, das die folgenden Komponenten enthält:

    • GitHub Copilot
    • GitHub Copilot für Azure
    • Azure MCP-Server

  5. Wählen Sie beim Herunterladen die Option "Installieren" aus , um den Installationsprozess abzuschließen.

Screenshot, der zeigt, wie Copilot mit Visual Studio-Workloads installiert wird.

Für Azure authentifizieren

Azure MCP Server bietet eine nahtlose Authentifizierung mit Azure-Konten und Microsoft Entra-ID. Um Azure MCP Server zu verwenden, müssen Sie sich zuerst mit lokalen Entwicklungstools wie Azure CLI, Azure Developer CLI, Visual Studio oder Visual Studio Code bei Azure authentifizieren. Azure MCP Server erkennt Ihre Anmeldeinformationen automatisch aus diesen Tools und verwendet sie zum Authentifizieren bei Azure-Diensten.

  1. So melden Sie sich beispielsweise mit der Azure CLI an:

    az login

  2. Überprüfen Sie Ihren Authentifizierungsstatus, indem Sie den folgenden Befehl ausführen, um zu sehen, mit welchem Konto und welchem Abonnement Sie derzeit angemeldet sind:

    az account show

  3. Stellen Sie sicher, dass Ihr Benutzerkonto über die entsprechenden Rollenzuweisungen für die Azure-Dienste verfügt, mit der Sie interagieren möchten. Die Azure-Ressourcen, auf die Sie mit Azure MCP Server zugreifen möchten, müssen bereits in Ihrem Azure-Abonnement vorhanden sein. Zu den allgemeinen Rollenzuweisungen gehören beispielsweise:

    • Blob Storage Data Contributor – Blob-Daten in Speicherkonten lesen und schreiben.
    • Speicherkonto-Beitragender – Speicherkontokonfigurationen verwalten.
    • Mitwirkender – Allgemeine Ressourcenverwaltung in Ihrem Abonnement.
    • Reader – Schreibgeschützter Zugriff auf Azure-Ressourcen.

    Weitere Informationen zu Rollenzuweisungen und der lokalen Entwicklungsauthentifizierung finden Sie unter Authentifizieren von .NET-Apps für Azure-Dienste während der lokalen Entwicklung.

Verwenden von Eingabeaufforderungen zum Testen des Azure MCP-Servers

  1. Öffnen Sie GitHub Copilot, und wählen Sie den Agentmodus aus.

  2. Geben Sie eine Eingabeaufforderung ein, die bewirkt, dass der Agent Azure MCP Server-Tools verwendet, z. B. "Meine Azure-Ressourcengruppen auflisten".

  3. Um Azure MCP Server zu authentifizieren, fordert Copilot Sie auf, sich mit dem Browser bei Azure anzumelden.

    Hinweis

    Copilot fordert Sie nicht auf, sich bei Azure anzumelden, wenn Sie bereits über andere lokale Tools wie die Azure CLI authentifiziert sind.

  4. Copilot fordert die Berechtigung an, den erforderlichen Azure MCP Server-Vorgang für Ihre Eingabeaufforderung auszuführen. Wählen Sie "Dieses Mal zulassen " aus, oder verwenden Sie den Pfeil, um ein spezifisches Verhalten auszuwählen:

    • Legen Sie immer fest, dass der Vorgang immer für jede GitHub Copilot Agent Mode-Sitzung oder einen beliebigen Visual Studio Code-Arbeitsbereich ausgeführt wird.
    • In dieser Sitzung zulassen führt den Vorgang immer in der aktuellen GitHub Copilot Agenten Modus Sitzung aus.

    Screenshot, der zeigt, wie Azure MCP Server-Tools in Visual Studio ausgeführt werden.

    Die Ausgabe für die vorherige Eingabeaufforderung sollte dem folgenden Text ähneln:

    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. Erkunden und testen Sie die Azure MCP-Vorgänge mithilfe anderer relevanter Eingabeaufforderungen, z. B.:

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

Nächste Schritte

Weitere Informationen zu Azure MCP Server-Tools

  • Last updated on