Быстрый старт: Интегрировать сервер Azure MCP с GitHub Copilot CLI

Из этого краткого руководства вы узнаете, как подключить сервер Протокола контекста модели Azure (MCP) к интерфейсу командной строки GitHub Copilot. С помощью этой интеграции GitHub Copilot может напрямую взаимодействовать с вашими ресурсами Azure через терминал.

Предпосылки

Вход в Azure MCP Server для локальной разработки

Сервер Azure MCP аутентифицируется в Microsoft Entra ID с помощью библиотеки удостоверений Azure для .NET. Сервер поддерживает два режима проверки подлинности:

  • Режим брокера: использует собственную проверку подлинности операционной системы (например, диспетчер веб-учетных записей Windows) с InteractiveBrowserCredential.
  • Режим цепочки учетных данных: пытается выполнить несколько методов проверки подлинности в последовательности: переменные среды, Visual Studio Code, Visual Studio, Azure CLI, Azure PowerShell, Azure Developer CLI и интерактивную проверку подлинности браузера.

Войдите с помощью любого из следующих методов:

  1. Откройте палитру команд (Ctrl+Shift+P или Cmd+Shift+P на Компьютере Mac).
  2. Запустите Azure: войдите и следуйте инструкциям.

После входа Azure MCP Server может выполнять операции проверки подлинности и выполнения операций в службах Azure на основе ваших разрешений.

Добавление сервера Azure MCP

Интерфейс командной /mcp строки GitHub Copilot поддерживает серверы MCP через семейство команд.

  1. Откройте терминал.

  2. Запустите интерфейс командной строки GitHub Copilot в интерактивном режиме:

    copilot
    
  3. В интерактивном сеансе выполните следующую команду, чтобы открыть форму конфигурации сервера MCP:

    /mcp add
    
  4. Заполните поля конфигурации следующими значениями:

    Поле Ценность
    Имя сервера azure-mcp
    Тип сервера 1 (Локальный)
    Command npx -y @azure/mcp@latest server start
    Переменные среды (оставьте пустым — использует проверку подлинности Azure CLI)
    Инструменты *

    Замечание

    Если вы предпочитаете использовать .NET, задайте для команды значение dotnet dnx Azure.Mcp server start.

  5. Нажмите клавиши CTRL+S (или Cmd+S в macOS), чтобы сохранить конфигурацию сервера.

  6. По завершении нажмите клавишу ESC , чтобы закрыть конфигурацию сервера.

Проверка подключения

Убедитесь, что вы правильно настроили сервер Azure MCP и распознает ли GitHub Copilot CLI:

  1. В вашей CLI-сессии Copilot запустите:

    /mcp show
    
  2. Просмотрите выходные данные. В конфигурации должно отображаться azure-mcp.

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

Использование сервера Azure MCP

После подключения сервера можно использовать естественный язык для взаимодействия с Azure ресурсами.

  1. В сеансе интерфейса командной строки GitHub Copilot введите запрос, требующий контекста Azure. Рассмотрим пример.

    > List my Azure resource groups.
    
  2. GitHub Copilot определяет намерение и использует azure-mcp средства для получения информации. В нем выводится ответ, в котором перечислены группы ресурсов Azure, аналогичные следующим:

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

Управление серверами MCP

Управление настроенными серверами MCP с помощью следующих команд:

  • Список серверов:/mcp show
  • Удаление сервера:/mcp remove azure-mcp
  • Получите справку:/mcp help

Дальнейшие шаги