Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Подключаемый модуль Microsoft 365 Copilot подключает поддерживаемые возможности Майкрософт к инструментам, предоставляемым удаленным сервером протокола контекста модели (MCP). Пакет плагинов содержит конфигурацию подключения, а сервер работает отдельно.
Используйте средства разработчика Work IQ (WIQD) для создания, проверки и упаковки подключаемого модуля. Начните с создания подключаемого модуля с помощью средств разработчика Work IQ.
В следующих разделах объясняется базовая конфигурация для разработчиков, которым необходимо редактировать манифест вручную. Зарегистрируйте удаленный сервер MCP подключаемого модуля в agentConnectors массиве манифеста приложения Microsoft 365. Этот идентификатор схемы остается agentConnectors , даже если устанавливаемый пакет называется подключаемым модулем.
Важно
В этой конфигурации используется манифест приложения Microsoft 365, а не манифест подключаемого модуля MCP, используемый для действий декларативного агента. Он также отделен от маршрута регистрации Agent 365 CLI. Эти альтернативные варианты см. в статье Создание и повторное использование серверов MCP. Поддержка MCP сама по себе не обеспечивает поддержку этой модели регистрации.
Необходимые условия
Прежде чем начать, убедитесь, что у вас есть:
- Тестовый клиент и целевой интерфейс Майкрософт, поддерживающий подключаемые модули, настроенные с помощью
agentConnectors. - Работающий сервер MCP с общедоступной конечной точкой HTTPS, TLS 1.2 или более поздней версии и транспортом, поддерживаемым целевым интерфейсом.
- Пакет приложения Microsoft 365 с версией манифеста, поддерживаемой целевым интерфейсом, и выбранным типом авторизации.
- Конфигурация авторизации, зарегистрированная для вашего сервера, например конфигурация OAuth или конфигурация ключа API, если сервер не разрешает анонимный доступ.
Требования к серверу WIQD и требование к описанию инструмента Copilot Cowork см. в статье Средства разработчика Work IQ.
Добавление сервера MCP в манифест приложения
Объявите сервер MCP в массиве agentConnectors на корневом уровне манифеста приложения.
- Откройте манифест приложения в пакете приложения Microsoft 365.
- Найдите или создайте массив корневого уровня
agentConnectors. - Добавьте запись с помощью уникальности
id, adisplayName, adescriptionи atoolSource, которая идентифицирует ваш удаленный сервер MCP.
Следующий JSON — это фрагмент для слияния с существующим манифестом приложения, а не полный манифест приложения:
{
"$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.30/MicrosoftTeams.schema.json",
"manifestVersion": "1.30",
"agentConnectors": [
{
"id": "my-mcp-server",
"displayName": "My Automation Server",
"description": "Provides workflow automation and task management tools.",
"toolSource": {
"remoteMcpServer": {
"mcpServerUrl": "https://mcp.example.com/mcp",
"authorization": {
"type": "OAuthPluginVault",
"referenceId": "my-oauth-config"
},
"mcpToolDescription": {
"file": "toolDescription.json"
}
}
}
}
]
}
Замените конечную точку и ссылку авторизации значениями сервера. Каждая запись id должна быть уникальной в пределах agentConnectors. Сохраните другие обязательные свойства манифеста приложения в существующем файле.
Настройка конечной точки сервера
Установите toolSource.remoteMcpServer.mcpServerUrl в конечную точку HTTPS. Убедитесь, что сервер доступен из целевого интерфейса и отвечает на инициализацию MCP и последующие запросы протокола.
Настройка проверки подлинности
Задается authorization в agentConnectors[].toolSource.remoteMcpServerпределах . В следующей таблице перечислены типы авторизации и их конфигурация. Подробные сведения о схеме см. в схеме авторизации.
| Тип авторизации | Настройка |
|---|---|
None |
Проверка подлинности не требуется. Используйте только в том случае, если сервер разрешает анонимный доступ. |
OAuthPluginVault |
Конфигурация OAuth, хранящаяся в хранилище Microsoft и указанная по идентификатору. |
ApiKeyPluginVault |
Конфигурация ключа API, хранящаяся в хранилище и ссылающаяся по идентификатору. |
DynamicClientRegistration |
Динамическая конфигурация регистрации клиента OAuth, на которую ссылается ИД. |
AzureKeyVault |
Конфигурация Azure Key Vault, указанная по идентификатору. Требуется поддержка узла. |
ConnectionVault (предварительная версия для разработчиков) |
Конфигурация подключения с привязкой к идентификатору. |
Значение схемы не гарантирует поддержку в целевом интерфейсе. Перед выбором метода проверьте требования проверки подлинности.
Определяет referenceId конфигурацию, полученную отдельно от манифеста. Не помещайте ключи API, маркеры доступа, секреты клиента или секретные значения в это поле или где-либо еще в манифесте приложения.
Использование проверки подлинности OAuth
Для маркеров OAuth 2.0, хранящихся в хранилище Майкрософт, используйте следующий authorization объект:
{
"type": "OAuthPluginVault",
"referenceId": "my-oauth-config"
}
Зарегистрируйте конфигурацию OAuth на портале разработчика и используйте возвращенный ИД конфигурации в качестве referenceId. Дополнительные сведения см. в разделе "Настройка OAuth" на портале разработчика.
Добавьте следующий URL-адрес обратного вызова к разрешенным URI перенаправления в регистрации поставщика OAuth:
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
Используйте проверку подлинности с помощью ключа API
Для ключа API, хранящегося в хранилище, используйте следующий authorization объект:
{
"type": "ApiKeyPluginVault",
"referenceId": "my-apikey"
}
Зарегистрируйте ключ на портале разработчика, а затем замените my-apikey его возвращенным регистрационным идентификатором. Дополнительные сведения см. в разделе Проверка подлинности с помощью ключа API.
Использование динамической регистрации клиентов
Динамическая регистрация клиента позволяет узлу зарегистрироваться в качестве клиента OAuth на сервере MCP с помощью RFC 7591. Оба должны поддерживать процесс регистрации. Microsoft Entra ID не предоставляет конечную точку регистрации RFC 7591; используйте статическую регистрацию OAuth для сервера, защищенного Entra.
Используйте следующий authorization объект:
{
"type": "DynamicClientRegistration",
"referenceId": "my-dcr-config"
}
Зарегистрируйте конфигурацию на портале разработчика и замените my-dcr-config ее ссылочным идентификатором. Конфигурация предоставляет значения авторизации, используемые узлом при согласовании учетных данных клиента.
Ваш сервер должен:
- Предоставление конечной точки регистрации клиента RFC 7591.
- Верните сведения о регистрации клиента, необходимые для потока OAuth узла.
- Поддержка обновления маркера, если это требуется для длительных сеансов.
Используйте проверку подлинности Azure Key Vault
AzureKeyVault включен в схемы манифестов приложения 1.29 и 1.30. Используйте его, только если в целевом интерфейсе задокументирована интеграция Azure Key Vault и процесс получения справочника по конфигурации.
Используйте следующий authorization объект:
{
"type": "AzureKeyVault",
"referenceId": "my-keyvault-config"
}
Следуйте требованиям к хранилищу учетных данных и доступу для этой интеграции и замените my-keyvault-config их возвращенной ссылкой. Одно только объявление манифеста не предоставляет доступа к секретам.
Использование проверки подлинности хранилища подключений
Примечание
Проверка подлинности хранилища подключений доступна в предварительной версии для разработчиков. Настройка схемы манифеста ConnectionVaultприложения для предварительного просмотра разработчика; она недоступна в схемах манифестов общедоступных приложений.
Для поддерживаемой интеграции хранилища подключений используйте следующий authorization объект:
{
"type": "ConnectionVault",
"referenceId": "shared_example"
}
Замените shared_example ссылкой на подключение, предоставленной целевой интеграцией.
Не использовать проверку подлинности
Если сервер разрешает анонимный доступ, установите authorization.type значение или None пропуск, authorization если узел разрешает его.
Предпочитайте доступ с проверкой подлинности для рабочих и корпоративных сценариев, а также OAuth ключам API, если они поддерживаются.
Определение обнаружения средств
Используйте упакованные определения инструментов, когда набор инструментов фиксирован, или динамическое обнаружение, если это поддерживается версией манифеста приложения и целевым узлом.
Использование статических определений инструментов
Включите файл описания средства в пакет приложения и ссылайтесь на него в remoteMcpServer. Путь относительно пакета приложения. Используйте определения инструментов из результатов вашего сервера tools/list , включая название каждого инструмента, описание и входную схему. Например, минимальный toolDescription.json файл может содержать:
{
"mcpToolDescription": {
"file": "toolDescription.json"
}
}
{
"tools": [
{
"name": "get_task",
"description": "Gets a task by its identifier.",
"inputSchema": {
"type": "object",
"properties": {
"taskId": {
"type": "string",
"description": "The identifier of the task."
}
},
"required": [
"taskId"
]
}
}
]
}
Поддерживайте согласованность упакованных определений с сервером.
Использование динамического обнаружения инструментов
Динамическое обнаружение позволяет узлу получить список инструментов во время tools/list выполнения, а не полагаться на упакованные определения.
Манифест приложения версии 1.29 или более поздней позволяет пропускать mcpToolDescription. Для более ранних версий требуется этот файл.
Copilot Cowork по-прежнему требует файл описания инструмента, даже в версии 1.29 или более поздней. В WIQD поставьте его через --tool-description; см. Инструменты разработчика Work IQ.
Для целевого взаимодействия, поддерживающего динамическое обнаружение, опустите его mcpToolDescription , чтобы оно могло извлекать определения с помощью tools/list. Верните имена инструментов, описания и входные схемы, а также проверьте, как обновляются изменения в наборе инструментов.
Проверка подключаемого модуля
Проверьте пакет перед развертыванием, а затем протестируйте его в целевом интерфейсе:
- Проверьте полный манифест приложения на соответствие объявленной схеме и используйте проверку пакета приложения на портале разработчика.
- Убедитесь, что конечная точка отвечает на инициализацию MCP, а упакованный файл или
tools/listпредоставляет допустимые определения инструментов. - Разверните пакет в тестовом клиенте с помощью процесса, поддерживаемого целевым интерфейсом. Выполните необходимую настройку утверждения или доступа администратора. Развертывание не заменяет вход пользователя, согласие или разрешения исходной службы.
- Тестовые запросы для операций, предоставляемых вашим сервером, например "Поиск открытых вопросов, назначенных мне" или, для сервера со средствами записи, "Обновить статус билета номер 123".
- Убедитесь, что нужные средства доступны, при необходимости отображаются запросы на продолжение, а вызовы средств возвращают ожидаемые результаты. Протестируйте обновление маркера OAuth, где это применимо.
- Проверяйте сбои на наличие недопустимых введенных данных, недоступных служб, ошибок авторизации и тайм-аутов, включая поведение повторных попыток.
- Протестируйте на всех клиентах, если ваш сценарий требует поддержки мультитенантности.
Устранение распространенных проблем
| Проблема | Чек |
|---|---|
| Не удается подключиться к серверу | Доступность конечных точек, HTTPS, поддержка транспорта, параметры брандмауэра и инициализация MCP. |
| Инструменты не отображаются | Упакованный путь к файлу и допустимые определения или поддержка динамического обнаружения с mcpToolDescription опущенными и рабочими tools/list. |
| Сбой проверки подлинности | Заголовки referenceIdрегистрации, проверки учетных данных, разрешений, согласия и исходящей авторизации. |
| Вызов инструмента завершается сбоем или превышено время ожидания | Журналы сервера, проверка ввода, формат ответа MCP, параллелизмы, тайм-ауты и повторные попытки. |
Дальнейшие действия
Когда интеграция будет готова, упакуйте подключаемый модуль и используйте поддерживаемый метод публикации или общего доступа.