Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Агенты в Microsoft 365 Copilot подключаются к внутренним службам через подключаемые модули. Подключаемый модуль может быть оболочкой сервера протокола контекста модели (MCP) или API, описанного в документе OpenAPI. Чтобы разрешить подключаемому модулю доступ к защищенному серверу MCP или API, необходимо настроить схему проверки подлинности, чтобы Microsoft 365 Copilot мог получать и отправлять правильные учетные данные от имени вошедшего пользователя.
Примечание.
В этой статье под плагином подразумевается техническое пользовательское действие MCP или API, настроенное с помощью манифеста плагина для декларативного агента. Подробнее о подключаемых модулях, пакетах, реестрах и жизненном цикле, ориентированных на клиентов, см. в статье "Подключаемые модули для Microsoft 365 Copilot".
В этом наборе документации по умолчанию используются подключаемые модули 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.
Как работает проверка подлинности подключаемого модуля
Каждая схема использует конфигурацию проверки подлинности (auth config) — запись, хранящуюся в хранилище токенов Microsoft Enterprise, которая содержит учетные данные или сведения о клиенте, необходимые для проверки подлинности на сервере MCP или API. Конфигурация проверки подлинности создается одним из трех способов:
- Набор средств агентов Microsoft 365 создает конфигурацию проверки подлинности и автоматически обновляет манифест подключаемого модуля по мере создания агента.
- Навык разработчика декларативного агента (только подключаемые модули MCP) создает конфигурацию проверки подлинности и обновляет манифест на естественном языке.
- Портал разработчиков Microsoft Teams позволяет создать конфигурацию проверки подлинности вручную или управлять конфигурацией, созданной набором средств агентов или навыком.
Манифест подключаемого модуля ссылается на конфигурацию проверки подлинности по ее идентификатору в объекте проверки подлинности во время выполнения. Во время выполнения Microsoft 365 Copilot использует конфигурацию проверки подлинности для получения маркера или ключа API из хранилища маркеров и включает его, когда подключаемый модуль вызывает сервер MCP или API.
Следуйте инструкциям в статье для выбранной схемы проверки подлинности, чтобы настроить этот конкретный тип.
- Настройка проверки подлинности единого входа Microsoft Entra
- Настройка динамической регистрации клиентов
- Настройка проверки подлинности OAuth 2.0
- Настройка аутентификации с помощью ключа API
- Настройка анонимной проверки подлинности
Примечание.
Для подключаемых модулей Cowork MCP используйте ту же модель настройки проверки подлинности, описанную в этих статьях. Если ваш поставщик OAuth использует платформу удостоверений Майкрософт и подключаемый модуль нуждается в автоматическом обновлении маркера, включите offline_access в поле "Область" все делегированные области для API.