Подключите вашего агента к существующему серверу Model Context Protocol (MCP)

Если вы уже настроили сервер Model Context Protocol (MCP), вы можете подключить MCP-сервер к вашему агенту.

Вы можете подключить своего агента к MCP-серверу в Copilot Studio двумя способами:

• Добавьте сервер MCP в Copilot Studio с помощью мастера онбординга MCP (рекомендую)
• Создайте пользовательский коннектор для вашего сервера через Power Apps

Если у вас ещё нет настроенного MCP-сервера, см. раздел «Создать новый MCP-сервер » для получения информации, как начать.

Поддерживаемые транспорты

В MCP транспорты являются основой клиент-серверной коммуникации. Транспорты отвечают за механику отправки и получения сообщений. В настоящее время Copilot Studio поддерживает тип потокового транспорта.

Вариант 1: Используйте мастер онбординга MCP (рекомендую)

Самый простой способ подключиться к существующему серверу MCP — напрямую в Copilot Studio с помощью мастера онбординга MCP.

Этот метод состоит из двух частей:

• Настройте базовые детали сервера MCP
• Настройте аутентификацию с помощью вашего MCP-сервера

Настройка базовых деталей сервера

1. Перейдите на страницу «Инструменты » для вашего агента.

2. Выберите "Добавить инструмент".

3. Выберите новый инструмент.

4. Выберите протокол контекста модели. Появляется мастер адаптации MCP.

   

5. Заполните необходимые поля : имя сервера, описание сервера и URL сервера. Напишите краткое, но чёткое описание того, чем занимается ваш MCP-сервер. Orchestrator агентов использует эту информацию, чтобы определить, стоит ли вызывать ваш сервер во время выполнения.

6. Выберите тип аутентификации для вашего MCP-сервера, если применимо. Доступно три варианта на выбор:

   • Нет
   • Ключ API: Настройка аутентификации ключа API
   • OAuth 2.0: Настройка аутентификации OAuth 2.0

7. Если вы выбрали «Нет», выберите «Создать». Появляется диалог « Добавить инструмент ». Перейдите к созданию нового соединения и добавьте MCP-сервер к вашему агенту.

Настройте аутентификацию с помощью вашего MCP-сервера

Если серверу требуется аутентификация, у вас есть два варианта:

• Ключ API: Выберите эту опцию, если вашему серверу MCP требуется ключ API для аутентификации. API-ключ — это простой вариант аутентификации на сервере. Пользователь агента предоставляет API-ключ, и агент включает его в запросы к серверу MCP.
• OAuth 2.0: Выберите этот вариант, если ваш MCP-сервер использует OAuth 2.0 для аутентификации. OAuth 2.0 позволяет отдельным пользователям аутентифицироваться на сервере и предоставлять разрешения вашему приложению (агенту) без предоставления их учетных данных.

Если вы решите использовать аутентификацию, нужно настроить детали аутентификации. Шаги зависят от выбранного типа аутентификации.

Настройка проверки подлинности ключа API

1. Выберите API-ключ в качестве типа аутентификации. Появляется больше полей для настройки ключа API.

2. Выберите тип ключа API для использования. У вас есть два варианта:

   • Заголовок: Выберите эту опцию, если ваш MCP-сервер требует, чтобы ключ API был отправлен в заголовке запроса.
   • Запрос: Выберите эту опцию, если ваш MCP-сервер требует, чтобы ключ API был отправлен в качестве параметра запроса в URL.

3. Введите название заголовка или параметра запроса, куда должен быть включён ключ API.

4. Нажмите кнопку "Создать". Появляется диалог « Добавить инструмент ». Перейдите к созданию нового соединения и добавьте MCP-сервер к вашему агенту.

Настройка аутентификации OAuth 2.0

1. Выберите OAuth 2.0 в качестве типа проверки подлинности.

2. Выберите тип аутентификации OAuth 2.0 для использования. Доступно три варианта на выбор:

   • Динамическое обнаружение: выберите эту опцию, если ваш MCP-сервер поддерживает динамическую регистрацию клиента OAuth 2.0 (DCR) с механизмом обнаружения. Клиент может использовать конечную точку обнаружения для автоматического обнаружения необходимых конечных точек и регистрации у поставщика идентификации.
   • Динамический: выберите этот вариант, если ваш MCP-сервер поддерживает динамический OAuth 2.0 DCR, но не поддерживает механизм динамического обнаружения. Клиент всё ещё может зарегистрироваться у поставщика идентификации, но необходимо предоставлять необходимые конечные точки вручную.
   • Руководство: выберите эту опцию, если ваш MCP-сервер требует ручной настройки настроек OAuth 2.0.

Динамическое обнаружение

Если ваш MCP-сервер поддерживает механизм динамической регистрации клиента OAuth 2.0 (DCR), вы можете воспользоваться опцией динамического обнаружения. Если поддерживается, DCR с обнаружением — самый простой способ настроить аутентификацию OAuth 2.0 с вашим MCP-сервером в Copilot Studio.

1. Выберите динамическое обнаружение в качестве типа аутентификации OAuth 2.0.

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

3. Выберите Далее, чтобы продолжить. Появляется диалог « Добавить инструмент ».

4. Продолжайте создавать новое соединение и добавляйте MCP-сервер к вашему агенту.

Динамический

1. Выберите Dynamic как тип аутентификации OAuth 2.0.

2. Заполните обязательные поля:

   • URL авторизации: URL сервера идентификатора, к которому можно получить доступ к конечным точкам регистрации и авторизации клиента.
   • Шаблон URL токена: конечная точка, где ваш агент обменивает код авторизации (или токен обновления) на токен доступа и токен обновления. Токен доступа позволяет вашему агенту использовать MCP-сервер от имени пользователя. Токены обновления позволяют вашему агенту получать новый доступ и токены обновления с точки обновления после истечения срока действия предыдущего токена.

3. Выберите Создать, чтобы добавить сервер. В зависимости от конфигурации может появиться URL обратного вызова . URL обратного вызова — это когда провайдер идентификации отвечает кодом авторизации после входа пользователя и предоставления разрешения вашему агенту.

4. Если вы видите URL обратного звонка, скопируйте его для регистрации приложения у вашего провайдера идентификации.

5. Выберите Далее, чтобы продолжить. Появляется диалог « Добавить инструмент ».

6. Продолжайте создавать новое соединение и добавляйте MCP-сервер к вашему агенту.

Ручной

1. Выберите Manual как тип OAuth 2.0. Появляется больше полей для настройки настроек OAuth 2.0.

2. Заполните обязательные поля:

   • Идентификатор клиента: идентификатор клиента, который выдаёт поставщик идентичности при регистрации приложения. Идентификатор клиента сообщает провайдеру идентификации, какое приложение делает запрос.
   • Клиентский секрет: Клиентский секрет — это провайдер идентификации при регистрации приложения. Ваш агент отправляет секрет клиента вместе с идентификатором клиента, чтобы доказать, что он уполномочен запрашивать токены доступа для сервера MCP.
   • URL авторизации: конечная точка поставщика идентификации, где ваш агент перенаправляет пользователя на вход и предоставление разрешения агенту (карта согласия отображается в чате агента). Пользователь здесь аутентификация, а затем поставщик идентификации отвечает агенту кодом авторизации.
   • Шаблон URL токена: конечная точка, где ваш агент обменивает код авторизации (или токен обновления) на токен доступа и токен обновления. Токен доступа позволяет вашему агенту использовать MCP-сервер от имени пользователя. Токены обновления позволяют вашему агенту получать новый доступ и токены обновления с точки обновления после истечения срока действия предыдущего токена.
   • Обновление URL: конечная точка для запроса нового токена доступа с помощью токена обновления (чтобы пользователю не приходилось снова входить в систему после истечения срока действия токена).
   • Scopes (Optional): Разрешения, которые ваше приложение запрашивает, в виде списка с разделёнными пробелами.

3. Выберите Создать, чтобы добавить сервер. Появляется ссылка обратного вызова . URL обратного вызова — это когда провайдер идентификации отвечает кодом авторизации после входа пользователя и предоставления разрешения вашему агенту.

4. Скопируйте URL обратного вызова, чтобы добавить его в регистрацию вашего приложения у вашего провайдера идентификации.

5. Выберите Далее, чтобы продолжить. Появляется диалог « Добавить инструмент ».

6. Продолжайте создавать новое соединение и добавляйте MCP-сервер к вашему агенту.

Создайте новое соединение и добавьте MCP-сервер к вашему агенту

1. В инструменте Add выберите «Создать новое соединение для вашего MCP-сервера» или используйте существующее.

2. Выберите Add to agent , чтобы завершить добавление MCP-сервера в ваш агент.

Вариант 2: Создать собственный MCP-разъём в Power Apps

Вы можете вручную создать собственный коннектор в Power Apps для настройки соединения с сервером.

Для выполнения этой процедуры вам нужен файл схемы для вашего MCP-сервера. Файл схемы — это YAML-файл спецификации OpenAPI, который описывает API вашего MCP-сервера.

Для получения информации о том, как должен выглядеть файл спецификации, посмотрите приведённые примеры схемы сервера MCP.

1. Перейдите на страницу «Инструменты » для вашего агента.

2. Выберите "Добавить инструмент".

3. Выберите новый инструмент.

4. Выберите Пользовательский разъём. Вас отправляют в Power Apps, чтобы создать новый кастомный коннектор.

5. Выберите Создать настраиваемый соединитель.

6. Выберите Импортировать файл OpenAPI.

7. Перейдите к файлу схемы и выберите Импорт , чтобы импортировать файл.

8. Выберите Continue чтобы завершить настройку в Power Apps. Подробнее о процессе настройки можно прочитать в документации Power Apps по адресу Import the OpenAPI definition.

Пример схемы сервера MCP

Вот пример OpenAPI схемы для MCP-сервера, использующего вымышленные данные, в формате YAML. Вам нужно заполнить данные для вашего собственного MCP-сервера. Этот выборка использует тип транспорта Streamable.

swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for streamable MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

Отредактировать MCP-соединение

Чтобы отредактировать разъём MCP или добавить пользовательские параметры:

1. Перейдите в портал Power Apps или Power Automate и выберите Custom connectors.
2. Найдите файл с разъёмом в списке разъёмов и внесите необходимые обновления с помощью одного из доступных методов.