Начало работы с сервером Azure MCP с помощью Visual Studio

Сервер Azure MCP использует протокол MCP для стандартизации интеграции между приложениями ИИ и внешними инструментами и источниками данных, что позволяет системам ИИ выполнять операции с учетом контекста ресурсов Azure.

Из этой статьи вы узнаете, как выполнить следующие задачи:

  • Установите и выполните проверку подлинности на сервере Azure MCP.
  • Подключитесь к серверу Azure MCP с помощью режима агента GitHub Copilot в Visual Studio.
  • Запустите запросы на тестирование операций Azure MCP Server и взаимодействие с ресурсами Azure.

Предпосылки

Установка сервера Azure MCP

Visual Studio использует файл с именем mcp.json для проверки конфигураций сервера MCP, включая конфигурации, настроенные другими средами разработки. Конфигурации сервера MCP считываются из следующих каталогов в следующем порядке:

  1. %USERPROFILE%\.mcp.json: служит глобальной конфигурацией сервера MCP для конкретного пользователя. Добавьте здесь сервер MCP, чтобы загрузить его для всех решений Visual Studio.
  2. <SOLUTIONDIR>\.vs\mcp.json: зависит от Visual Studio и загружает только указанные серверы MCP для конкретного пользователя для указанного решения.
  3. <SOLUTIONDIR>\.mcp.json: конфигурация MCP уровня решения, которую можно отслеживать в системе управления версиями для репозитория.
  4. <SOLUTIONDIR>\.vscode\mcp.json: определяется для репозитория или решения и обычно не включается в систему контроля версий.
  5. <SOLUTIONDIR>\.cursor\mcp.json: определяется для репозитория или решения и обычно не включается в систему контроля версий.

Замечание

Для некоторых из этих расположений требуется .mcp.json, а для других — mcp.json.

Сервер Azure MCP доступен как пакет NuGet или как пакет NPM. В следующих вариантах демонстрируется два наиболее распространенных подхода к подключению к серверу Azure MCP из Visual Studio.

Замечание

Кроме того, для установки Azure MCP можно использовать расширение GitHub Copilot для Azure .

Выполните следующие действия, чтобы установить Сервер Azure MCP для определенного каталога:

  1. Создайте новый файл в корне решения с именем .mcp.json. Используйте Visual Studio для редактирования этого файла, чтобы его схема JSON автоматически применялась.

  2. .mcp.json В файле добавьте следующий код JSON для предпочтительного пакета:

    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. Сохраните изменения.

  4. Откройте GitHub Copilot и выберите режим агента.

  5. Щелкните значок инструментов, чтобы просмотреть доступные инструменты. Найдите сервер Azure MCP, чтобы отфильтровать результаты.

Снимок экрана: настройка Azure MCP Server в Visual Studio.

Visual Studio 2026 включает средства Azure MCP Server с рабочей нагрузкой разработки Azure и ИИ. Чтобы сделать их доступными:

  1. Откройте средство установщика Visual Studio.

  2. Выберите "Изменить", чтобы просмотреть доступные рабочие нагрузки.

  3. На вкладке "Рабочие нагрузки" выберите Azure и разработка ИИ.

  4. На панели сведений о установке убедитесь, что выбран GitHub Copilot , который включает следующие компоненты:

    • GitHub Copilot
    • GitHub Copilot для Azure
    • Сервер Azure MCP

  5. Выберите "Установить" во время скачивания , чтобы завершить процесс установки.

Снимок экрана: установка Copilot с помощью рабочих нагрузок Visual Studio.

Проверка подлинности в Azure

Azure MCP Server предоставляет простой интерфейс проверки подлинности с помощью учетных записей Azure и идентификатора Microsoft Entra. Чтобы использовать Сервер Azure MCP, необходимо сначала пройти проверку подлинности в Azure с помощью локальных средств разработки, таких как Azure CLI, Azure Developer CLI, Visual Studio или Visual Studio Code. Сервер Azure MCP автоматически обнаруживает учетные данные из этих средств и использует их для проверки подлинности в службах Azure.

  1. Например, чтобы войти с помощью Azure CLI:

    az login

  2. Проверьте состояние проверки подлинности, выполнив следующую команду, чтобы узнать, с какой учетной записью и подпиской вы вошли в систему:

    az account show

  3. Убедитесь, что учетная запись пользователя имеет соответствующие назначения ролей для служб Azure, с которыми вы хотите взаимодействовать. Ресурсы Azure, к которым вы планируете получить доступ с помощью Azure MCP Server, должны уже существовать в подписке Azure. Например, распространенные назначения ролей включают:

    • Вкладчик данных хранилища BLOB — чтение и запись данных BLOB в учетных записях хранения.
    • Соавтор учетной записи хранения — управление конфигурациями учетной записи хранения.
    • Контрибьютор — общее управление ресурсами в вашей подписке.
    • Читатель — доступ только для чтения к ресурсам Azure.

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

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

  1. Откройте GitHub Copilot и выберите режим агента.

  2. Введите запрос, который приводит к использованию агентом средств Azure MCP Server, таких как перечисление групп ресурсов Azure.

  3. Чтобы пройти проверку подлинности Azure MCP Server, Copilot предложит войти в Azure с помощью браузера.

    Замечание

    Copilot не запрашивает вход в Azure, если вы уже прошли проверку подлинности с помощью других локальных инструментов, таких как Azure CLI.

  4. Copilot запрашивает разрешение запустить необходимую операцию сервера Azure MCP для вашего запроса. Выберите "Разрешить это время " или используйте стрелку, чтобы выбрать более конкретное поведение:

    • Всегда разрешать устанавливает выполнение операции по умолчанию для любого сеанса режима агента GitHub Copilot или любой рабочей области Visual Studio Code.
    • Разрешить в этом сеансе всегда выполнять операцию в текущем сеансе режима агента GitHub Copilot.

    Снимок экрана: запуск средств Azure MCP Server в Visual Studio.

    Выходные данные предыдущего запроса должны выглядеть следующим образом:

    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. Изучите и проверьте операции Azure MCP с помощью других соответствующих запросов, таких как:

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

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

Дополнительные сведения о средствах Azure MCP Server

  • Last updated on