Начало работы с сервером MCP Azure в Windsurf

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

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

• Установка и проверка подлинности на сервере MCP Azure
• Подключитесь к серверу Azure MCP, используя среду разработки Windsurf с поддержкой ИИ.
• Запуск команд для тестирования серверных операций Azure MCP и взаимодействия с ресурсами Azure

Предпосылки

• Учетная запись Azure с активной подпиской
• Установлен виндсерф
• Node.js установлен в версии с долгосрочной поддержкой

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

Чтобы установить и настроить сервер MCP Azure в Windsurf, выполните приведенные ниже действия.

1. Перейдите к Файл > Параметры > Настройки Windsurf.

2. На странице Параметры Windsurf выберите Управление MCP.

   

3. На странице "Управление параметрами серверов MCP" выберите "Просмотреть необработанную конфигурацию " в верхней части, чтобы открыть mcp_config.json файл для редактирования.

4. Файл mcp_config.json позволяет вручную установить СЕРВЕРы MCP, добавив объект конфигурации JSON. Обновите файл mcp_config.json, чтобы он соответствовал следующему:

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

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

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

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

   az login
   

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

   az account show
   

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

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

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

Используйте команды для тестирования сервера MCP Azure

1. Откройте интерфейс чата ИИ Windsurf, Ctrl+L нажав или щелкнув значок чата на боковой панели.

2. Введите запрос, который использует возможности сервера Azure MCP, например:

   List my Azure storage accounts
   

3. Если вам будет предложено выполнить проверку подлинности в Azure, запустите предлагаемое средство проверки подлинности для входа в браузер.

   Замечание

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

4. Windsurf предлагает запустить инструмент для извлечения учетных записей хранения, таких как storage account list. Нажмите кнопку "Запустить" , чтобы продолжить.

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

   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
   Show me the configuration of my App Service instances
   

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