Интеграция с внешним MCP-сервером

После настройки интеграции с ИИ-провайдером Ассистента можно подключить к MCP-серверамСервис, реализованный по MCP-протоколу, который выступает посредником между моделями и внешними системами внешних систем (например, Яндекс, GitLab). Это позволит получать данные из внешних систем напрямую без необходимости самостоятельно переносить контекст ваших задач в чат Ассистента.

Примечание

Чтобы настроить или удалить любую интеграцию ТестОпс с внешней системой, необходима глобальная роль «Администратор» в инстансе ТестОпс и, как правило, права администратора инстанса внешней системы.

Настройка интеграции и подключений с MCP-сервером

Чтобы настроить интеграцию с MCP-сервером внешней системы:

1. Создайте токен доступа во внешней системе.
2. Подключите интеграцию с MCP-сервером на уровне инстанса ТестОпс.
3. Добавьте настроенное подключение к MCP-серверу в проект ТестОпс.
4. Добавьте настроенное подключение к MCP-серверу в настройках Ассистента или его агента.
5. При необходимости укажите персональные учетные данные для подключения к MCP-серверу, если разрешено их использование.

1. Создайте токен доступа во внешней системе

Примечание

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

1. Создайте токен доступа, следуя официальной документации внешней системы.
2. Сохраните токен в безопасном месте, он понадобится для подключения интеграции с MCP-сервером в ТестОпс.

2. Подключите интеграцию с MCP-сервером на уровне инстанса ТестОпс

1. Перейдите в ваш инстанс ТестОпс.

2. Перейдите в раздел Администрирование → Интеграции.

3. Нажмите Добавить интеграцию.

4. В списке доступных интеграций выберите MCP-сервер.

5. Заполните поля:

   • Название подключения — введите название, которое поможет вам распознать интеграцию (например, Yandex MCP).

   • Endpoint — введите URL-адрес, по которому ТестОпс будет обращаться к MCP-серверу.

   • Типы учетных данных — нажмите на выпадающий список и выберите один или несколько типов учетных данных MCP-сервера, которые будет поддерживать интеграция.

     Примечание

     Подробнее о поддерживаемых типах учетных данных см. Интеграции с внешними системами → Учетные данные внешних систем.

6. Если MCP-сервер использует самоподписанный SSL-сертификат, уберите галочку напротив Проверка SSL-сертификата.

7. Если интеграция может работать с глобальными учетными данными MCP-сервера, в секции Глобальные учетные данные заполните поля:

   • Название HTTP-заголовка — введите заголовок HTTP-запроса;
   • Значение — введите тип авторизации и токен доступа, который вы сохранили на шаге 1.

8. При необходимости проверьте соединение с MCP-сервером, чтобы убедиться в корректности указанных данных.

9. Нажмите Добавить подключение.

Пример заполнения полей в интеграции с MCP-сервером

Основные настройки:

Название подключения: Yandex MCP

Endpoint: https://your-mcp-server.example.com

Типы учетных данных: глобальные, проектные и персональные

Глобальные учетные данные:

Название HTTP-заголовка: Authorization

Значение: Bearer y0-1234567890abcdef

В разделе Администрирование → Интеграции появится интеграция с MCP-сервером с одним автоматически созданным подключением.

3. Добавьте настроенное подключение к MCP-серверу в проект ТестОпс

Чтобы добавить настроенное подключение к MCP-серверу в нужный проект ТестОпс, воспользуйтесь одним из способов:

1. В ТестОпс перейдите в раздел Администрирование → Интеграции.

2. В списке настроенных интеграций найдите и откройте интеграцию с MCP-сервером.

3. В списке настроенных подключений найдите и откройте ваше подключение к MCP-серверу.

4. Нажмите Добавить в проект.

5. В списке доступных проектов выберите нужный проект ТестОпс.

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

   Важно

   Для глобальных и проектных учетных данных доступна настройка Разрешить персональные учетные данные. По умолчанию она включена — если пользователь добавит персональные учетные данные, ТестОпс будет использовать их для взаимодействия с MCP-сервером вместо выбранного типа.

   Чтобы запретить использование персональных учетных данных, уберите галочку напротив этой настройки.

7. Если интеграция будет работать с проектными учетными данными MCP-сервера, в секции Проектные учетные данные заполните поля:

   • Название HTTP-заголовка — введите заголовок HTTP-запроса;
   • Значение — введите тип авторизации и токен доступа, который вы сохранили на шаге 1.

8. При необходимости проверьте соединение с MCP-сервером, чтобы убедиться в корректности указанных данных.

9. Нажмите Добавить в проект.

4. Добавьте настроенное подключение к MCP-серверу в настройках Ассистента или агента

Чтобы добавить настроенное подключение к MCP-серверу, воспользуйтесь одним из способов в зависимости от того, где вы хотите пользоваться его инструментамиФункциональная возможность внешней системы, которую вызывает модель, чтобы выполнять действия или получать внешние данные — в любом чате Ассистента или в чате с конкретным агентом:

1. Перейдите в ваш проект ТестОпс → раздел Настройки → Ассистент.
2. Нажмите Настроить.
3. В секции MCP-серверы нажмите + и в выпадающем списке выберите подключение, которое вы хотите добавить.
4. Нажмите Сохранить.

Аналогично вы можете удалить MCP-сервер из настроек Ассистента, для этого в секции MCP-серверы нажмите ⋯ → Удалить из Ассистента.

При необходимости вы можете добавить настроенное подключение одновременно и в настройки Ассистента, и в настройки агента.

5. Укажите персональные учетные данные для взаимодействия с MCP-сервером

Если при настройке интеграции на шаге 2 и шаге 3 было разрешено использовать персональные учетные данные, каждый участник проекта может добавить их самостоятельно.

Примечание

Подробнее о типах учетных данных см. Интеграции с внешними системами → Учетные данные внешних систем.

Чтобы добавить персональные учетные данные для взаимодействия с MCP-сервером:

1. В ТестОпс нажмите на ваш аватар и перейдите в раздел Интеграции.

2. Нажмите Добавить интеграцию.

3. В списке настроенных интеграций найдите и откройте интеграцию с MCP-сервером.

4. Если в инстансе ТестОпс настроено несколько подключений к MCP-серверам, в поле Подключение нажмите на выпадающий список и выберите нужное подключение.

5. В секции Персональные учетные данные заполните поля:

   • Название HTTP-заголовка — введите заголовок HTTP-запроса;
   • Значение — введите тип авторизации и личный токен доступа к внешней системе (токен можно получить как описано в шаге 1).
   Пример заполнения персональных учетных данных

   Название HTTP-заголовка: Authorization

   Значение: Bearer sk-proj-1234567890abcdef

6. Нажмите Добавить подключение.

Удаление подключений и интеграции с MCP-сервером

Вы можете удалить подключение к интеграции с MCP-сервером двумя способами — на уровне отдельного проекта (через настройки проекта) или на уровне всего инстанса ТестОпс (через раздел Администрирование).

Удаление подключения на уровне проекта

Важно

Последствия удаления всех подключений из интеграции с MCP-сервером на уровне проекта:

• Подключения к интеграции с MCP-сервером перестанут отображаться в списке подключений проекта, но продолжат работать в других проектах инстанса, в которых они были добавлены, и сохранятся в разделе Администрирование → Интеграции.
• Интеграция с MCP-сервером перестанет отображаться в списке интеграций проекта, но сохранится в разделе Администрирование → Интеграции.
• Инструменты MCP-сервера будут недоступны в чатах Ассистента и агентах вашего проекта, но продолжат работать в других проектах, в которых подключения остались активными.

Чтобы удалить подключение на уровне проекта:

1. Перейдите в ваш проект ТестОпс → раздел Настройки → Интеграции.
2. В списке настроенных интеграций найдите и откройте интеграцию с MCP-сервером.
3. Напротив нужного подключения к MCP-серверу нажмите ⋯ → Удалить → Да, удалить.

Подключение перестанет работать в вашем проекте.

Удаление подключения на уровне инстанса

Важно

Последствия удаления всех подключений из интеграции с MCP-сервером на уровне инстанса:

• Подключения и интеграция с MCP-сервером будут полностью удалены.
• Инструменты MCP-сервера будут недоступны в чатах Ассистента и агентах во всех проектах инстанса.

Чтобы удалить подключение на уровне инстанса:

1. В ТестОпс перейдите в раздел Администрирование → Интеграции.
2. В списке настроенных интеграций найдите и откройте интеграцию с MCP-сервером.
3. В списке настроенных подключений откройте карточку нужного подключения и напротив названия каждого проекта нажмите ⋯ → Удалить из проекта → Да, удалить.
4. Нажмите Назад в интеграцию, чтобы вернуться к списку подключений.
5. Напротив нужного подключения к MCP-серверу нажмите ⋯ → Удалить → Да, удалить.

Подключение перестанет работать во всех проектах инстанса.