Test IT MCP: возможности и способы работы

Опция тарифов Стандарт и Про

Эта опция доступна в тарифах:

• Test IT Стандарт
• Test IT Про, версия 5.8 и более поздние
  Подробнее: о тарифах Test IT.

Безопасность работы с MCP: рекомендации

Чтобы ваша работа с MCP была продуктивной и безопасной, вот несколько рекомендаций:

• Запросы к ИИ не должны содержать чувствительных данных, подлежащих NDA.
• Запросы на поиск и анализ данных можно совершать свободно.
• Запросы на изменение данных (например, создание или архивацию тестов) рекомендуется выполнять с подтверждением.
• Не передавайте API-токен в общие чаты; в IDE он указывается только в настройках MCP.
• Для тестовых запросов и экспериментов используйте отдельный проект в Test IT.

Test IT MCP дает ИИ-ассистенту в IDE доступ к платформе Test IT. Получив доступ, ИИ-ассистент может читать проекты и кейсы, искать прогоны, формировать отчеты и вносить изменения.

Этот документ описывает основные возможности и проверенные сценарии работы с MCP после его подключения.

Просмотр возможностей MCP-сервера

Просмотр команд и промптов в MCP Inspector

MCP Inspector — отдельное веб-приложение для просмотра инструментов, запросов и ресурсов вне чата в IDE. Это может быть удобно, чтобы 1 раз проверить корректность ответов сервера и полноту списка команд.

1. На компьютере с установленным Node.js выполните в терминале команду:

   npx @modelcontextprotocol/inspector
   

2. В открывшемся интерфейсе укажите:
   • URL MCP-сервера: адрес вашего пространства + /mcp (например https://xxxx.testit.software/mcp);
   • Transport: Streamable HTTP (или HTTP — как предлагает Inspector);
   • Headers: X-baseurl и X-token. Подробнее: Test IT MCP: общие принципы и данные для подключения
3. Подключитесь и просмотрите вкладки Tools и Prompts. Отдельные команды можно вызвать вручную с тестовыми параметрами.

Inspector не заменяет IDE: в повседневной работе удобнее чат с ассистентом и готовые prompts ниже.

Обзорный промпт в чате с ИИ-ассистентом

Обзорный промпт может быть удобен, когда Inspector недоступен и нужно быстро получить простое описание возможностей сервера.

• Вызовите обзорный промпт одним из способов:
  • В чате IDE введите команду: testit_mcp_capabilities_manual. — Ассистент получит с сервера MCP полную инструкцию, включая:
    • Доступные инструменты и их назначение
    • Доступные промпты и их типовые цепочки. Пример команды в Cursor (если сервер в конфиге назван test-it):

      /test-it/testit_mcp_capabilities_manual
      

  • В чате с ИИ-ассистентом отправьте запрос: «Вызови prompt testit_mcp_capabilities_manual и кратко перечисли, что умеет Test IT MCP». Затем задайте уточняющий вопрос — ассистент подберет нужный инструмент или сценарий из обзора.

Список подключенных инструментов в IDE

В Cursor, Kilo Code и других клиентах с поддержкой MCP обычно есть список подключенных инструментов (tools). Новые инструменты отображаются после успешного соединения.
Если список пуст:

• Проверьте статус сервера и заголовки авторизации.

Способы работы с MCP

• Инструменты (tools). Предназначены для выполнения конкретных действий, например найти прогоны автотестов, сравнить прогоны, создать тест-кейс и т.д.
• Готовые сценарии (prompts). Подробная инструкция для ИИ-ассистента (рекомендуется для решения типовых задач): анализ библиотеки, сравнение прогонов, генерация кейсов по техническому заданию и т.д.
• Ресурсы (resources). Тексты сценариев в виде справочных материалов, аналогичные готовым сценариям (prompts) — для клиентов, где готовые сценарии недоступны.

Использование готовых сценариев

Использование сценариев в Cursor

В Cursor сценарии инициируются с помощью команд. В префиксе команды указывается имя сервера.

Например, если имя сервера test-it, в чате доступны команды вида:

• /test-it/testit_library_actuality
• /test-it/testit_compare_test_runs
• /test-it/testit_manual_test_scenarios

Использование сценариев в других клиентах

• Используйте раздел MCP Prompts
• В чат с ИИ-ассистентом отправьте запрос: «Следуй сценарию testit_library_actuality». Ассистент отобразит инструкцию с сервера.

Типовые сценарии

Ниже предлагается несколько типичных сценариев применения MCP. Возможности MCP не ограничиваются этими сценариями, но для экспериментальных сценариев и тестовых запросов рекомендуем создать отдельный проект.

Внимание

Для операций, изменяющих данные в Test IT (создание / изменение / удаление объекта, обновление статуса), четко обозначьте в запросе:

1. Необходимость сначала показать план
2. Выполнять действие только после вашего подтверждения

Задача	Рекомендуемый промпт	Результат
Проверить состояние библиотеки тестов	testit_library_actuality	Отчет с устаревшими и дублированными ручными тестами, автотестами, а также рекомендации по улучшению
Сравнить два прогона	testit_compare_test_runs	Метрики, дельты, улучшения / ошибки и падения автотестов
Сгенерировать ручные тесты по ТЗ	testit_manual_test_scenarios	Подготовка промпта и сохранение тестов в проект
Вынести повторяющиеся шаги в общие шаги (ОШ)	testit_create_shared_steps	План → создание ОШ → обновление кейсов
Общие шаги в предусловия секции	testit_section_preconditions	План → предусловия секции → очистка дублей в тест-кейсах
Обзор функциональности MCP	testit_mcp_capabilities_manual	Обзор возможностей для ассистента

Простые запросы без промптов также могут применяться при использовании корректных, четких формулировок, например:

• Покажи проекты в Test IT
• Найди прогоны проекта … за последнюю неделю
• Найди тест-кейсы в секции …
• Создай секцию … в проекте …
• Создай пустой прогон в проекте …

Сценарии

Анализ актуальности библиотеки

Сценарий включает аудит библиотеки ручных тестов и автотестов, в том числе поиск:

• Устаревших ручных тестов, дубликатов ручных тестов, неиспользуемых общих шагов, тестов, которые давно не включались в тест-планы
• Нестабильных автотестов и автотестов, которые давно не запускались

Промпт: testit_library_actuality

Параметры

Параметр	Обязательный	Пояснение
projectId	да	GUID проекта в Test IT
sectionId	нет	Анализ отдельной секции библиотеки (включая все ее дочерние секции)
duplicateSampleSize	нет	Количество тестов для проверки на дубликаты (по умолчанию 120)

Пример запроса в чате:

/test-it/testit_library_actuality

Проект 01955ac0-bce1-7e95-9508-d6c9295ef89f.
Секция ce9305c3-1946-4f07-bd9e-0dea63cc750b — только эта ветка библиотеки.

Реализация сценария

1. Инициация анализа библиотеки на сервере MCP.
2. Отображение таблицы, содержащей тест-кейсы, общие шаги, автотесты, их статус (OK или Проблема), количество, примеры, рекомендации по улучшению библиотеки.
3. Предоставление отдельной сводки по типам проблем и групп дубликатов.
4. Предложение действия: массовой архивации или изменения статуса тестов с пометкой Проблема (требуется подтверждение).

Типичные действия по результатам анализа

Результат анализа	Типичные действия
Дубликаты ручных тестов	Архивация дубликатов по id
Устаревшие кейсы	Перевод в статус Требует доработки или архивация
Нет связи тестов с требованием	Связь тестов с требованиями в интерфейсе Test IT или архивация
Проблемные автотесты	Прогон, доработка автотестов, архивация неактуальных автотестов

Часть проверок по автотестам и тест-планам выполняется на уровне всего проекта, даже если задан sectionId — эта информация указывается в шапке отчета.

Ограничения

• Сценарий не позволяет определить, была ли связь с требованиями удалена или не была создана.
• Перезапуски автотестов оцениваются по статистике, доступной в API, а не по всей истории.

Сравнение двух прогонов

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

Промпт: testit_compare_test_runs

Параметры

Параметр	Обязательный	Пояснение
projectId	да	GUID проекта
testRunId1; testRunId2	нет	Идентификаторы прогонов для сопоставления

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

Примеры запроса в чате:

• Запрос с использованием сценария:

  /test-it/testit_compare_test_runs
  
  Проект 01955ac0-….
  Сравни прогоны aaaaaaaa-… и bbbbbbbb-….
  

• Свободный текстовый запрос:

  Сравни два последних прогона в проекте …
  

Реализация сценария

1. Сравнение возраста прогонов по дате создания.
2. Расчет длительности прогонов, количества тестов и тестов с ошибками, дельт.
3. Отображение исправленных результатов (Failed → Passed), новых падений автотестов, новых или измененных текстов ошибок.
4. Если общее число результатов или упавших тестов не совпадает — показ списка расхождений по отдельным тестам (onlyInOlder, onlyInNewer, смена результата).
5. Отображение результата анализа в виде таблицы. По запросу можно просмотреть подробности отдельного результата в Test IT.

Генерация ручных тест-кейсов

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

Промпт: testit_manual_test_scenarios

Параметры

Параметр	Обязательный	Пояснение
projectId	да	Идентификатор проекта, в который будут сохранены тесты
taskDescription	да	Описание функциональности / задачи
specificationText	нет	Текст технического задания или требований
librarySectionId	нет	Идентификатор секции библиотеки, в которой содержатся тесты, используемые в качестве контекста
libraryWorkItemIds	нет	Идентификаторы тестов для контекста

Пример запроса в чате:

/test-it/testit_manual_test_scenarios

Проект …, задача: авторизация по SSO.
ТЗ: <вставить текст или приложить файл>.
Учти кейсы из секции …

Реализация сценария

1. Сбор контекста (проект, при необходимости — существующие кейсы из Test IT).
2. Подготовка промпта для генерации и правил форматирования (название, предусловия, шаги, ожидаемые результаты).
3. Генерация кейсов, из которых вы можете выбрать тесты для сохранения.
4. Сохранение в Test IT (требуется подтверждение и идентификатор секции).

Подготовка общих шагов из дубликатов шагов тестов

Сценарий позволяет найти повторяющиеся шаги тестов (дубликаты), подготовить из них общие шаги и заменить дубликаты в тест-кейсах ссылками на созданные общие шаги.

Промпт: testit_create_shared_steps

Параметры

• projectId — идентификатор проекта
• Область поиска: вся библиотека, секция или список кейсов (требуется указать в чате с ИИ-ассистентом)

Пример запроса в чате:

/test-it/testit_create_shared_steps

В проекте … найди повторяющиеся шаги в секции «Регресс» и предложи вынести в общие шаги.

Реализация сценария

ИИ-ассистент проводит следующие шаги:

1. Поиск кейсов с шагами в указанной области
2. Анализ — группировка семантически одинаковых шагов
3. План (без записи в Test IT): какие ОШ создать, какие кейсы обновить, таблица соответствий «старый шаг → общий шаг»
4. После вашего «да» — создание ОШ и обновление шагов в кейсах.

Уникальные шаги не удаляются. В спорных случаях ИИ-ассистент делает пометку на проверку.

Перенос общих шагов в предусловия секции

Часть повторяющихся шагов логичнее хранить не в каждом тест-кейсе или общем шаге, а в предусловиях секции. В этом случае шаг будет указан в секции 1 раз, а использоваться во всех тестах секции. В отличие от общих шагов, предусловия секции применяются ко всем кейсам в папке автоматически.

Промпт: testit_section_preconditions

Параметры

• projectId — идентификатор проекта
• При необходимости указываются конкретные секции или весь проект по секциям.

Пример запроса в чате:

/test-it/testit_section_preconditions

Проект …: по каждой секции найди шаги, которые повторяются у большинства кейсов, и предложи перенести в предусловия секции.

Реализация сценария

1. Загрузка дерева секций проекта.
2. Анализ тестов по каждой секции (удобнее и точнее, чем один запрос на весь проект).
3. Поиск шагов, которые повторяются у нескольких кейсов и соответствуют уровню секции (подготовка окружения, общий вход), а не уникальной проверки.
4. План: предлагаются дополнения в предусловия секции, а также список кейсов, из которых можно убрать общие шаги.
5. Обновление предусловий секции и правка шагов тестов (требуется подтверждение).

Устранение ошибок

• Ассистент не распознает сценарий: Вызовите prompt явно (/test-it/testit_…) или напишите: «следуй сценарию testit_library_actuality».
• Отсутствуют нужные инструменты (tools): Проверьте подключение MCP; откройте список в MCP Inspector.
• Ошибка доступа к Test IT: В настройках проверьте заголовок X-baseurl и API-токен.
• Ассистент изменяет данные без подтверждения: Напомните: Сначала только план, без записи в Test IT.

По вопросам подключения, ошибок сервера, а также с предложениями по развитию MCP обратитесь в техническую поддержку: support@testit.software.