Открытие и управление сервером MCP

ОБЛАСТЬ ПРИМЕНЕНИЯ: Разработчик | Базовый | Базовая версия 2 | Стандартный | Стандартная версия 2 | Премиум | Премиум версия 2

В этой статье показано, как использовать управление API для предоставления и управления существующим сервером удаленного протокола контекста модели (MCP) — сервером инструментов, размещенным за пределами управления API. Предоставление и управление средствами сервера с помощью управления API, чтобы клиенты MCP могли вызывать их с помощью протокола MCP.

Примеры сценариев включают:

• Проксировать серверы средств LangChain или LangServe через управление API с аутентификацией для каждого сервера и ограничениями скорости.
• Безопасно предоставляют средства на основе Azure Logic Apps для копилот с помощью фильтрации IP-адресов и OAuth.
• Централизуйте средства сервера MCP из Функции Azure и среды выполнения с открытым исходным кодом в Azure API Center.
• Включите GitHub Copilot, Claude от Anthropic или ChatGPT для безопасного взаимодействия с инструментами по всей вашей организации.

Управление API также поддерживает собственные серверы MCP, предоставляемые в системе управления API из управляемых REST API. Дополнительные сведения см. в разделе "Предоставление REST API в качестве сервера MCP".

Дополнительные сведения:

• Поддержка сервера MCP в службе управления API
• Возможности шлюза искусственного интеллекта

Ограничения

• Внешний сервер MCP должен соответствовать версии 2025-06-18 MCP или более поздней версии. Сервер может поддерживать следующее:

  • Либо отсутствие авторизации, либо протоколы авторизации, соответствующие следующим стандартам: https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization#standards-compliance.
  • Потоковые типы передачи по протоколам HTTP или SSE.

• Для внешних серверов MCP управление API в настоящее время поддерживает средства и ресурсы сервера MCP, но не поддерживает запросы MCP.

• В настоящее время управление API не поддерживает возможности сервера MCP в рабочих областях.

Предпосылки

• Если у вас еще нет экземпляра управления API, выполните следующее краткое руководство: Создание экземпляра Azure API Management. Экземпляр должен находиться на одном из уровней сервисов, поддерживающих серверы MCP.

• Доступ к внешнему серверу, совместимом с MCP (например, размещен в Azure Logic Apps, Функции Azure, LangServe или других платформах).

• Соответствующие учетные данные сервера MCP (например, учетные данные клиента OAuth 2.0 или ключи API в зависимости от сервера) для безопасного доступа.

• Если вы включите ведение журнала диагностики с помощью Application Insights или Azure Monitor в глобальной области (все API) для экземпляра службы управления API, задайте параметру Количество байт полезной нагрузки для ведения журнала для ответа фронтенда значение 0. Этот параметр предотвращает непреднамеренное логирование содержимого тела ответа для всех API, что помогает обеспечить надлежащее функционирование серверов MCP. Чтобы регистрировать данные селективно для определенных API, настройте настройки отдельно в области API, позволяя эффективно управлять ведением журнала ответов.

• Чтобы протестировать сервер MCP, используйте Visual Studio Code с доступом к GitHub Copilot или инструменту, например MCP Inspector.

Открытие доступа к существующему серверу MCP

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

1. На портале Azure перейдите к экземпляру службы управления API.
2. В меню слева в разделе API выберите MCP-серверы>+ Создать сервер MCP.
3. Выберите "Предоставить существующий сервер MCP".
4. На бэкенд-сервере MCP:
   1. Введите существующий БАЗОВЫй URL-адрес сервера MCP. Например, https://learn.microsoft.com/api/mcp для сервера Microsoft Learn MCP.
   2. В типе транспортапотоковый HTTP выбран по умолчанию.
5. На новом сервере MCP:
   1. Введите имя сервера MCP в службе управления API.
   2. В поле Основной путь введите префикс маршрута для инструментов. Например: mytools.
   3. При необходимости введите описание сервера MCP.
6. В разделе "Продукты" при необходимости выберите один или несколько продуктов для связи с сервером MCP. Связывание сервера MCP с продуктом позволяет управлять доступом и подписками для сервера MCP через этот продукт.
7. Нажмите кнопку "Создать".

• Портал создает сервер MCP и предоставляет операции удаленного сервера в качестве инструментов.
• Портал отображает список серверов MCP на панели серверов MCP. В столбце URL-адрес сервера отображается URL-адрес сервера MCP для использования при тестировании или в клиентском приложении.

Настройка политик для сервера MCP

Настройте одну или несколько политик управления API для управления сервером MCP. Политики применяются ко всем операциям API, предоставляемым в качестве инструментов на сервере MCP. Используйте эти политики для управления доступом, проверкой подлинности и другими аспектами средств.

Дополнительные сведения о настройке политик:

• Политики в управлении API
• Преобразование и защита API
• Установка и изменение политик
• Безопасный доступ к серверу MCP

Чтобы настроить политики для сервера MCP, выполните следующие действия.

1. На портале Azure перейдите к экземпляру службы управления API.

2. В меню слева в разделе API выберите MCP-серверы.

3. Выберите сервер MCP из списка.

4. В меню слева в разделе MCP выберите "Политики".

5. В редакторе политик добавьте или измените политики, которые необходимо применить к средствам сервера MCP. Определите политики в формате XML.

   Например, можно добавить политики в раздел "Входящий трафик", чтобы ограничить вызовы к средствам сервера MCP (в этом примере 5 вызовов каждые 30 секунд на IP-адрес) и добавить настраиваемую трассировку идентификатора агента, совершающего вызов.

   <inbound>
       <base />
       <rate-limit-by-key calls="5" renewal-period="30" counter-key="@(context.Request.IpAddress)" remaining-calls-variable-name="remainingCallsPerIP" />
    	<trace source="My MCP" severity="information">
    		<message>My MCP trace info</message>
    		<metadata name="agent-id" value="@(context.Request.Headers.GetValueOrDefault("agent-id", "n/a"))" />
   </inbound>
   

   

Проверка и использование сервера MCP

Используйте соответствующий агент LLM (например, GitHub Copilot, Semantic Kernel или Copilot Studio) или тестовый клиент (например, curl) для вызова конечной точки MCP, размещенной в службе управления API. Убедитесь, что запрос содержит соответствующие заголовки или маркеры, а также подтвердите успешную маршрутизацию и ответ с сервера MCP.

Добавление сервера MCP в Visual Studio Code

В Visual Studio Code используйте GitHub Copilot чат в режиме агента для добавления сервера MCP и использования средств. Общие сведения о серверах MCP в Visual Studio Code см. в разделе Use MCP Servers in VS Code.

Чтобы добавить сервер MCP в Visual Studio Code, выполните следующие действия.

1. Используйте команду MCP: Add Server из палитры команд.

2. При появлении запроса выберите тип сервера : HTTP (HTTP или отправленные события сервера).

3. Введите URL-адрес сервера MCP в службе управления API. Например, https://<apim-service-name>.azure-api.net/<api-name>-mcp/mcp для конечной точки MCP.

4. Введите идентификатор сервера по своему усмотрению.

5. Выберите, следует ли сохранить конфигурацию в параметрах рабочей области или параметрах пользователя.

   • Параметры рабочей области . Конфигурация сервера сохраняется только в файле, доступном .vscode/mcp.json только в текущей рабочей области.

   • Параметры пользователя — конфигурация сервера добавляется в глобальный settings.json файл и доступна во всех рабочих областях. Конфигурация выглядит примерно так:

   

Добавьте поля в конфигурацию JSON для параметров, таких как заголовок проверки подлинности. В следующем примере показана конфигурация ключа подписки управления API, переданного в заголовке в качестве входного значения. Дополнительные сведения о формате конфигурации

Использование средств в режиме агента

После добавления сервера MCP в Visual Studio Code можно использовать средства в режиме агента.

1. В чате GitHub Copilot выберите режим Agent и нажмите кнопку Tools, чтобы просмотреть доступные инструменты.

   

2. Выберите один или несколько инструментов на сервере MCP, чтобы сделать доступным в чате.

   Скриншот выбора инструментов в Visual Studio Code.

3. Введите запрос в чате, чтобы вызвать средство. Например, если вы выбрали средство для получения сведений о заказе, вы можете попросить агента о заказе.

   Get information for order 2
   

   Нажмите кнопку "Продолжить", чтобы просмотреть результаты. Агент использует средство для вызова сервера MCP и возвращает результаты в чате.

   

Устранение неполадок и известных проблем

Связанный контент

• Пример: авторизация серверов MCP с защищенными метаданными ресурсов (PRM)

• Sample: защита удаленных серверов MCP с помощью Azure API Management (экспериментальная)

• лаборатория авторизации клиента MCP

• Используйте расширение Azure API Management для VS Code для импорта и управления API

• Зарегистрируйте и обнаружьте удаленные серверы MCP в Центре API Azure

• Экспонирование REST API в Управлении API в качестве сервера MCP

• Отображение и управление существующим сервером MCP