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

Совет

Рекомендуется: Начните с Work IQ Dev Tools для поддерживаемых сценариев декларативного агента и плагинов для кода. См. краткое руководство по WIQD. Инструкции на основе набора средств остаются доступными для существующих проектов и рабочих процессов, для которых они требуются. Перед выбором инструмента проверьте поддержку возможностей и целевого интерфейса : WIQD не нацелен на агентов пользовательской подсистемы.

Декларативные агенты в Microsoft 365 Copilot подключаются к внутренним службам через плагины API или MCP. Эти интеграции действий подключают агент к серверу протокола контекста модели (MCP) или к API, описанному в документе OpenAPI. Настройте проверку подлинности, чтобы Microsoft 365 Copilot мог получать и отправлять правильные учетные данные от имени вошедшего в систему пользователя.

Примечание

В этой статье настраивается проверка подлинности в манифесте подключаемого модуля API или MCP для декларативного агента. При этом не настраивается внешний устанавливаемый пакет. См. раздел Подключаемые модули и декларативные действия агентов для связи манифеста.

В пошаговых инструкциях проверки подлинности в качестве примера по умолчанию используется подключаемый модуль MCP. Подключаемый модуль MCP — это интеграция агента с удаленным сервером, а не сам сервер. Те же шаги настройки применяются к плагинам API, созданным из документа OpenAPI, если не указано в каждой статье.

Поддерживаемые схемы аутентификации

Выберите схему аутентификации, которая соответствует тому, как ваш MCP-сервер или API защищает свои конечные точки:

Схема проверки подлинности Подключаемые модули MCP Подключаемые модули API Статья
Единый вход (SSO) в Microsoft Entra Поддерживается Поддерживается Настройка проверки подлинности единого входа Microsoft Entra
Динамическая регистрация клиентов (DCR) Поддерживается Не поддерживается Настройка динамической регистрации клиентов
Поток кода авторизации OAuth 2.0 Поддерживается Поддерживается Настройка проверки подлинности OAuth 2.0
Ключ API Не поддерживается Поддерживается Настройка аутентификации с помощью ключа API
Нет проверки подлинности (анонимность) Поддерживается Поддерживается Настройка без проверки подлинности (анонимная)

Примечание

В этой таблице рассматриваются подключаемые модули MCP и API, используемые в качестве действий декларативного агента. Подключаемый модуль, который ссылается на удаленный сервер agentConnectors MCP в манифесте приложения Microsoft 365, использует другую конфигурацию авторизации. Эта схема включает ApiKeyPluginVault, в то время как подключаемые модули MCP, используемые в качестве действий декларативного агента, не поддерживают ключи API. Требования к конфигурации и узлу см. в статье Настройка удаленных серверов MCP для подключаемых модулей Microsoft 365 Copilot.

Как работает проверка подлинности подключаемого модуля

Для схем, требующих учетных данных, конфигурация проверки подлинности (конфигурация проверки подлинности) — это запись, хранящаяся в хранилище маркеров Microsoft Enterprise, которая содержит учетные данные или сведения о клиенте, необходимые для проверки подлинности на сервере MCP или API. Анонимный доступ не требует настройки проверки подлинности. Выберите поддерживаемый путь конфигурации для проекта:

  • Work IQ Dev Tools (рекомендуется) настраивает проверку подлинности при добавлении OpenAPI или удаленного действия MCP с wiqd agent add actionпомощью . Чтобы настроить поддерживаемый тип проверки подлинности в существующем манифесте подключаемого модуля, используйте wiqd agent add auth. Следуйте приведенным ниже инструкциям WIQD для конкретной схемы, чтобы выбрать правильные варианты, а затем завершите рабочий процесс подготовки агента для вашей среды.
  • Набор средств агентов Microsoft 365 создает конфигурацию проверки подлинности и автоматически обновляет манифест подключаемого модуля по мере создания агента.
  • Навык разработчика декларативного агента (только подключаемые модули MCP) создает конфигурацию проверки подлинности и обновляет манифест на естественном языке.
  • Портал разработчиков Microsoft Teams позволяет создать конфигурацию проверки подлинности вручную или управлять конфигурацией, созданной набором средств агентов или навыком.

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

Начните с раздела WIQD для выбранной схемы аутентификации. В тех же статьях сохранены альтернативы Toolkit, Developer-Skill, Portal и вручную, если таковые поддерживаются.

Примечание

Для пакета подключаемого модуля, который подключает Cowork к удаленному серверу MCP, выполните проверку подлинности в манифесте приложения. Общие этапы регистрации учетных данных не делают эту конфигурацию взаимозаменяемой с конфигурацией манифеста подключаемого модуля MCP агента. Если ваш поставщик OAuth использует платформу удостоверений Майкрософт и подключение требует автоматического обновления маркера, включите offline_access в поле "Область" конфигурации OAuth все делегированные области для API.