Udostępnij za pośrednictwem


Szybki start: integracja serwera Azure MCP z GitHub Copilot CLI

Z tego przewodnika Szybki start dowiesz się, jak połączyć serwer protokołu MCP (Azure Model Context Protocol) z interfejsem wiersza polecenia narzędzia GitHub Copilot. Ta integracja umożliwia usłudze GitHub Copilot interakcję z zasobami platformy Azure bezpośrednio z poziomu terminalu.

Wymagania wstępne

Zaloguj się do serwera Azure MCP na potrzeby programowania lokalnego

Serwer MCP platformy Azure uwierzytelnia się w usłudze Microsoft Entra ID przy użyciu biblioteki tożsamości platformy Azure dla platformy .NET. Serwer obsługuje dwa tryby uwierzytelniania:

  • Tryb brokera: Używa natywnego uwierzytelniania systemu operacyjnego (na przykład Menedżera kont sieci Web systemu Windows) razem z InteractiveBrowserCredential.
  • Tryb łańcucha poświadczeń: Próbuje sekwencji wielu metod uwierzytelniania: zmienne środowiskowe, Visual Studio Code, Visual Studio, Azure CLI, Azure PowerShell, Azure Developer CLI i uwierzytelnianie interakcyjne przeglądarki.

Zaloguj się przy użyciu dowolnej z następujących metod:

  1. Otwórz paletę poleceń (Ctrl+Shift+P lub Cmd+Shift+P na komputerze Mac).
  2. Uruchom platformę Azure: zaloguj się i postępuj zgodnie z monitami.

Po zalogowaniu serwer MCP platformy Azure może uwierzytelniać i uruchamiać operacje na usługach platformy Azure na podstawie Twoich uprawnień.

Dodawanie serwera MCP platformy Azure

Interfejs wiersza polecenia narzędzia GitHub Copilot obsługuje serwery MCP dzięki rodzinie poleceń /mcp.

  1. Otwórz terminal.

  2. Uruchom GitHub Copilot CLI w trybie interaktywnym:

    copilot
    
  3. W sesji interaktywnej uruchom następujące polecenie, aby otworzyć formularz konfiguracji serwera MCP:

    /mcp add
    
  4. Wypełnij pola konfiguracji następującymi wartościami:

    Pole Wartość
    Nazwa serwera azure-mcp
    Typ serwera 1 (Lokalny)
    Polecenie npx -y @azure/mcp@latest server start
    Zmienne środowiskowe (pozostaw puste — wykorzystuje uwierzytelnianie Azure CLI)
    Narzędzia *

    Uwaga / Notatka

    Jeśli wolisz używać platformy .NET, ustaw polecenie na dotnet dnx -p Azure.Mcp server start.

  5. Naciśnij klawisze Ctrl+S (lub Cmd+S w systemie macOS), aby zapisać konfigurację serwera.

  6. Po zakończeniu naciśnij klawisz esc , aby zamknąć konfigurację serwera.

Weryfikowanie połączenia

Upewnij się, że serwer mcp platformy Azure został poprawnie skonfigurowany i że interfejs wiersza polecenia narzędzia GitHub Copilot rozpoznaje go:

  1. W sesji CLI Copilot, uruchom:

    /mcp show
    
  2. Przejrzyj dane wyjściowe. W konfiguracji powinna być widoczna pozycja azure-mcp.

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

Korzystanie z serwera mcp platformy Azure

Po nawiązaniu połączenia możesz użyć języka naturalnego do interakcji z zasobami platformy Azure.

  1. W sesji GitHub Copilot CLI wpisz monit, który wymaga kontekstu Azure. Przykład:

    > List my Azure resource groups.
    
  2. GitHub Copilot identyfikuje intencję i używa azure-mcp narzędzi do pobierania informacji. Wyświetla on odpowiedź z listą grup zasobów platformy Azure, podobnie jak:

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

Zarządzanie serwerami MCP

Zarządzaj skonfigurowanymi serwerami MCP przy użyciu następujących poleceń:

  • Lista serwerów:/mcp show
  • Usuń serwer:/mcp remove azure-mcp
  • Uzyskaj pomoc:/mcp help

Dalsze kroki