Erste Schritte mit azure MCP Server mit Visual Studio Code

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 beim Azure MCP-Server
• Herstellen einer Verbindung mit Azure MCP Server mithilfe des GitHub Copilot-Agentmodus in Visual Studio Code
• Ausführen von Eingabeaufforderungen zum Testen von Azure MCP Server-Vorgängen und Interagieren mit Azure-Ressourcen

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement
• Visual Studio Code
• GitHub Copilot Visual Studio Code-Erweiterung

Installieren des Azure MCP-Servers

Wählen Sie eine der folgenden Optionen aus, um den Azure MCP Server in Visual Studio Code zu installieren:

Erweiterungsinstallation

1. Um die Azure MCP Server-Erweiterung für Visual Studio Code zu installieren, wählen Sie den folgenden Link aus:

   

   Tipp

   Installieren Sie GitHub Copilot für Azure, das die Azure MCP Server-Erweiterung enthält und verwendet, um eine optimale Benutzererfahrung mit Azure MCP Server zu erzielen. GitHub Copilot für Azure optimiert Ihren Entwicklungsworkflow und verbessert Ihre Produktivität auf der Azure-Plattform.

2. Nachdem Sie die Erweiterung installiert haben, öffnen Sie GitHub Copilot, und wählen Sie den Agentmodus aus. Weitere Informationen zum Agentmodus finden Sie in der Visual Studio Code-Dokumentation.

3. Aktualisieren Sie die Toolsliste, um Azure MCP Server als verfügbare Option anzuzeigen:

   

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.

Verzeichnisinstallation

Sie können Azure MCP Server auch manuell für ein bestimmtes Verzeichnis installieren:

1. Öffnen Sie ein leeres Verzeichnis oder ein vorhandenes Projektverzeichnis in Visual Studio Code.

2. Erstellen Sie im Stammverzeichnis des Ordners einen .vscode Ordner, wenn noch kein Ordner vorhanden ist.

3. Erstellen Sie innerhalb des Ordners eine neue Datei mit dem .vscode Namen mcp.json "Add the following JSON":

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

4. Speichern Sie Ihre Änderungen in mcp.json.

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

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

   

   Weitere Informationen zum Agentmodus finden Sie in der Visual Studio Code-Dokumentation.

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 "Weiter" aus, oder verwenden Sie den Pfeil, um ein spezifisches Verhalten auszuwählen:

   • Die aktuelle Sitzung führt immer den Vorgang in der aktuellen GitHub Copilot Agent Mode-Sitzung aus.
   • Der aktuelle Arbeitsbereich führt immer den Befehl für den aktuellen Visual Studio Code-Arbeitsbereich aus.
   • 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.

   

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