Freigeben über


Schnellstart: Integrieren von Azure MCP-Server in GitHub Copilot CLI

In dieser Schnellstartanleitung erfahren Sie, wie Sie den Azure Model Context Protocol (MCP)-Server mit der GitHub Copilot CLI verbinden. Mit dieser Integration kann GitHub Copilot direkt über Ihr Terminal mit Ihren Azure-Ressourcen interagieren.

Voraussetzungen

Anmelden bei Azure MCP Server für die lokale Entwicklung

Azure MCP Server authentifiziert sich bei Microsoft Entra ID mithilfe der Azure Identity-Bibliothek für .NET. Der Server unterstützt zwei Authentifizierungsmodi:

  • Brokermodus: Verwendet die systemeigene Authentifizierung Ihres Betriebssystems (z. B. Windows Web Account Manager) mit InteractiveBrowserCredential.
  • Modus der Anmeldeinformationskette: Es wird versucht, mehrere Authentifizierungsmethoden in einer festgelegten Reihenfolge zu verwenden: Umgebungsvariablen, Visual Studio Code, Visual Studio, Azure CLI, Azure PowerShell, Azure Developer CLI und interaktive Browserauthentifizierung.

Melden Sie sich mit einer der folgenden Methoden an:

  1. Öffnen Sie die Befehlspalette (Ctrl+Shift+P oder Cmd+Shift+P auf dem Mac).
  2. Führen Sie Azure aus: Melden Sie sich an , und folgen Sie den Anweisungen.

Nach der Anmeldung kann Azure MCP Server Vorgänge für Azure-Dienste basierend auf Ihren Berechtigungen authentifizieren und ausführen.

Hinzufügen von Azure MCP-Server

Die GitHub Copilot CLI unterstützt MCP-Server über die /mcp Befehlsfamilie.

  1. Öffnen Sie Ihr Terminal.

  2. Starten Sie die GitHub Copilot CLI im interaktiven Modus:

    copilot
    
  3. Führen Sie in der interaktiven Sitzung den folgenden Befehl aus, um das MCP-Serverkonfigurationsformular zu öffnen:

    /mcp add
    
  4. Füllen Sie die Konfigurationsfelder mit den folgenden Werten aus:

    Feld Wert
    Servername azure-mcp
    Servertyp 1 (Lokal)
    Befehl npx -y @azure/mcp@latest server start
    Umgebungsvariablen (Leer lassen – Verwendet die Azure CLI-Authentifizierung)
    Werkzeuge *

    Hinweis

    Wenn Sie .NET bevorzugen, legen Sie den Befehl auf dotnet dnx -p Azure.Mcp server start.

  5. Drücken Sie STRG+S (oder CMD+S unter macOS), um die Serverkonfiguration zu speichern.

  6. Wenn Sie fertig sind, drücken Sie esc, um die Serverkonfiguration zu schließen.

Überprüfen der Verbindung

Vergewissern Sie sich, dass Sie den Azure MCP-Server ordnungsgemäß konfiguriert haben und dass die GitHub Copilot CLI sie erkennt:

  1. Führen Sie in Ihrer Copilot CLI-Sitzung Folgendes aus:

    /mcp show
    
  2. Überprüfen Sie die Ausgabe. In der Konfiguration sollte azure-mcp aufgelistet sein.

    ● MCP Server Configuration:
      • azure-mcp (local): Command: npx
    
    Total servers: 1
    Config file: ~/.copilot/mcp-config.json
    

Verwenden des Azure MCP-Servers

Sobald die Verbindung hergestellt wurde, können Sie natürliche Sprache verwenden, um mit Ihren Azure-Ressourcen zu interagieren.

  1. Geben Sie in der GitHub Copilot CLI-Sitzung eine Eingabeaufforderung ein, die Azure-Kontext erfordert. Beispiel:

    > List my Azure resource groups.
    
  2. GitHub Copilot identifiziert die Absicht und verwendet die azure-mcp Tools zum Abrufen der Informationen. Sie druckt eine Antwort, die Ihre Azure-Ressourcengruppen auflistet, ähnlich wie:

    I found the following resource groups in your subscription:
    
    - **my-resource-group-1** (East US)
    - **dev-environment** (West Europe)
    - **production-app** (Central US)
    

Verwalten von MCP-Servern

Verwalten Sie Ihre konfigurierten MCP-Server mithilfe der folgenden Befehle:

  • Server auflisten:/mcp show
  • Entfernen eines Servers:/mcp remove azure-mcp
  • Hilfe erhalten:/mcp help

Nächste Schritte