Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте решение сервера MCP из вашего плана компонентов для предоставления удаленно размещенных инструментов или ресурсов. Работающий сервер MCP остается отдельным от пакета подключаемого модуля, поэтому необходимо реализовать или подтвердить как удаленную среду выполнения, так и поддерживаемое подключение к целевому интерфейсу Майкрософт.
Повторное использование сервера MCP
Перед созданием сервера выполните следующие действия.
- Определите утвержденный сервер MCP, предоставляющий необходимые инструменты или ресурсы.
- Просмотрите определения инструментов, входы, выходы, ошибки, аннотации и поведение подтверждения.
- Убедитесь, что функции транспорта, проверки подлинности и протокола поддерживаются целевым интерфейсом Майкрософт.
- Подтвердите владельца сервера, конечную точку, версию, доступность, обработку данных, поддержку и процесс изменения.
- Получите доступ и настройте подключение для разработки или тестирования.
- Тестирование репрезентативных сценариев обнаружения, проверки подлинности, вызова и сбоя.
Ссылка на сервер MCP не переносит ответственность за его эксплуатацию. Запишите соглашение владельца службы и о поддержке перед ее повторным использованием.
Создание и эксплуатация сервера MCP
Если ни один утвержденный сервер не соответствует требованиям, создайте новый сервер MCP.
- Внедряйте только те инструменты и ресурсы, которые требуются планом компонентов.
- Определите четкие имена, описания, входные и выходные данные, ошибки и аннотации безопасности.
- Реализуйте проверку подлинности, авторизацию, доступ к данным и поведение с минимальными правами.
- Настройте размещение, сеть, секреты, ведение журналов, мониторинг, масштабирование и реагирование на инциденты.
- Настройте версию, поведение протокола и документируйте ожидания в отношении совместимости.
- Перед подключением к платформе Майкрософт протестируйте сервер независимо.
GitHub Copilot может помочь с серверным кодом, схемами, тестами и изменениями репозитория. Он не предоставляет сами по себе среду выполнения MCP, размещение, проверку подлинности или подключение к Microsoft 365.
Подключение сервера
Используйте интеграцию, поддерживаемую выбранным средством разработки и целевым интерфейсом.
Примечание
Используйте WIQD для создания подключаемого модуля, который ссылается на удаленный сервер MCP. Ручную настройку с помощью массива agentConnectors в манифесте приложения Microsoft 365 см. в статье "Настройка удаленных серверов MCP для подключаемых модулей Microsoft 365 Copilot". Эта конфигурация отличается от манифеста подключаемого модуля MCP, используемого для действий декларативного агента. Поддержка зависит от целевого интерфейса.
| Подход к разработке | Начать с |
|---|---|
| Средства разработчика Work IQ (рекомендуется для поддерживаемых сценариев с прокодом) | Создайте плагин с помощью Work IQ Dev Tools; для действия агента используйте рабочий процесс действия агента WIQD |
| Существующий проект декларативного агента с использованием набора средств агентов | Пошаговое руководство по интеграции MCP на основе набора средств |
| Copilot Studio | Документация по Microsoft Copilot Studio |
| Интерактивный ответ MCP | Добавление приложений MCP к декларативным агентам |
| Удаленная регистрация сервера MCP BYO с помощью интерфейса командной строки Agent 365 | Регистрация удаленного сервера MCP в средствах агента |
Важно
Маршрут MCP Agent 365 CLI BYO находится в предварительной версии и использует отдельную модель регистрации и администрирования от подключаемого модуля MCP, упакованного для декларативного агента Microsoft 365. Задокументированные поддерживаемые клиенты: Copilot Studio, Visual Studio Code, Claude Code и GitHub Copilot CLI. Этот путь не поддерживает декларативные агенты Microsoft 365. Администраторы используют средства агента для проверки, утверждения, согласия, блокировки и мониторинга зарегистрированного сервера.
Средства разработчика Work IQ
Эта wiqd plugin add connector команда добавляет удаленный разъем MCP в пакет подключаемого модуля WIQD. Документированные требования к серверу включают:
- HTTPS с TLS 1.2 или более поздней версии.
- Потоковый транспорт HTTP с использованием JSON-RPC 2.0.
- Поддержка
tools/listиtools/call. - Вызовы средств, которые выполняются менее чем за 30 секунд.
Скаффолды WIQD против манифеста версии 1.29, где mcpToolDescription является необязательным. Если вы добавили файл описания инструмента, передайте путь к нему относительно appPackage with wiqd plugin add connector --tool-description <relative-file-path> вместе с необходимыми параметрами соединителя. Файл, на который указывает ссылка, должен быть включен в ZIP-архив. Текущее поведение при обнаружении Cowork и требования к пакетам см. в статье Создание подключаемых модулей для Copilot Cowork.
Для проверки подлинности OAuth или с помощью ключа API сначала зарегистрируйте учетные данные и добавьте в пакет только идентификатор ссылки. Не помещайте секреты клиента, ключи API или маркеры в манифест. См. справочник по разработке плагинов WIQD.
Для маршрута "подключаемый модуль и пакет WIQD" настройте проверку подлинности и обнаружение средств в манифесте приложения Microsoft 365. Если вместо этого вы добавляете сервер в качестве действия MCP в декларативный агент, используйте проверку подлинности действия агента и динамическое обнаружение или закрепленные инструменты для агента. Следуйте требованиям выбранной интеграции, а не копируйте конфигурацию между моделями манифеста.
Убедитесь, что функция MCP работает
MCP-сервер и его подключение готовы к интеграции, когда:
- Конечная точка доступна в среде разработки или тестирования.
- Необходимые инструменты или ресурсы могут быть обнаружены целевым интерфейсом.
- Репрезентативные операции возвращают ожидаемые структурированные результаты.
- Проверка подлинности, авторизация, согласие и разрешения работают должным образом.
- Поведение подтверждения, истечения времени ожидания, недоступности службы, неверного ввода и частичного сбоя вполне понятно.
- Журналов и мониторинга достаточно информации для диагностики сбоев.
- Записываются владелец сервера, версия, конечная точка, размещение, зависимости, ограничения и доказательства тестирования.
Используйте отладку локальных MCP и API , если сервер недоступен для общественности во время разработки.
Продолжите работу с любыми другими компонентами плана. Когда они будут готовы, интегрируйте и протестируйте свои компоненты.