Настройка удаленных серверов MCP для подключаемых модулей Microsoft 365 Copilot

Подключаемый модуль 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 на корневом уровне манифеста приложения.

  1. Откройте манифест приложения в пакете приложения Microsoft 365.
  2. Найдите или создайте массив корневого уровня agentConnectors .
  3. Добавьте запись с помощью уникальности id, a displayName, a descriptionи a toolSource , которая идентифицирует ваш удаленный сервер 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. Верните имена инструментов, описания и входные схемы, а также проверьте, как обновляются изменения в наборе инструментов.

Проверка подключаемого модуля

Проверьте пакет перед развертыванием, а затем протестируйте его в целевом интерфейсе:

  1. Проверьте полный манифест приложения на соответствие объявленной схеме и используйте проверку пакета приложения на портале разработчика.
  2. Убедитесь, что конечная точка отвечает на инициализацию MCP, а упакованный файл или tools/list предоставляет допустимые определения инструментов.
  3. Разверните пакет в тестовом клиенте с помощью процесса, поддерживаемого целевым интерфейсом. Выполните необходимую настройку утверждения или доступа администратора. Развертывание не заменяет вход пользователя, согласие или разрешения исходной службы.
  4. Тестовые запросы для операций, предоставляемых вашим сервером, например "Поиск открытых вопросов, назначенных мне" или, для сервера со средствами записи, "Обновить статус билета номер 123".
  5. Убедитесь, что нужные средства доступны, при необходимости отображаются запросы на продолжение, а вызовы средств возвращают ожидаемые результаты. Протестируйте обновление маркера OAuth, где это применимо.
  6. Проверяйте сбои на наличие недопустимых введенных данных, недоступных служб, ошибок авторизации и тайм-аутов, включая поведение повторных попыток.
  7. Протестируйте на всех клиентах, если ваш сценарий требует поддержки мультитенантности.

Устранение распространенных проблем

Проблема Чек
Не удается подключиться к серверу Доступность конечных точек, HTTPS, поддержка транспорта, параметры брандмауэра и инициализация MCP.
Инструменты не отображаются Упакованный путь к файлу и допустимые определения или поддержка динамического обнаружения с mcpToolDescription опущенными и рабочими tools/list.
Сбой проверки подлинности Заголовки referenceIdрегистрации, проверки учетных данных, разрешений, согласия и исходящей авторизации.
Вызов инструмента завершается сбоем или превышено время ожидания Журналы сервера, проверка ввода, формат ответа MCP, параллелизмы, тайм-ауты и повторные попытки.

Дальнейшие действия

Когда интеграция будет готова, упакуйте подключаемый модуль и используйте поддерживаемый метод публикации или общего доступа.