Сценарии работы с MCP
Для типовых задач, с которыми сталкиваются команды тестирования, есть готовые сценарии. Применять их можно как с помощью простого текстового запроса или специального промпта.
Простые запросы без промптов (с использованием разговорного языка) могут применяться при использовании корректных, четких формулировок, например:
- Покажи проекты в Test IT
- Найди прогоны проекта … за последнюю неделю
- Найди тест-кейсы в секции …
- Создай секцию … в проекте …
- Создай пустой прогон в проекте …
Test IT MCP предлагает готовые типовые сценарии для:
- Ручного тестирования
- Автоматизированного тестирования
Каталог сценариев будет расширяться.
Возможности Test IT MCP не ограничиваются этими сценариями, вы можете предлагать и создавать свои. Для экспериментальных сценариев и тестовых запросов рекомендуем создать отдельный проект.
Работа по сценариям возможна после подключения Test IT MCP.
Внимание
Для операций, изменяющих данные в 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 — только эта ветка библиотеки.
Реализация сценария
- Инициация анализа библиотеки на сервере MCP.
- Отображение таблицы, содержащей тест-кейсы, общие шаги, автотесты, их статус (OK или Проблема), количество, примеры, рекомендации по улучшению библиотеки.
- Предоставление отдельной сводки по типам проблем и групп дубликатов.
- Предложение действия: массовой архивации или изменения статуса тестов с пометкой Проблема (требуется подтверждение).
Типичные действия по результатам анализа
| Результат анализа | Типичные действия |
|---|---|
| Дубликаты ручных тестов | Архивация дубликатов по id |
| Устаревшие кейсы | Перевод в статус Требует доработки или архивация |
| Нет связи тестов с требованием | Связь тестов с требованиями в интерфейсе Test IT или архивация |
| Проблемные автотесты | Прогон, доработка автотестов, архивация неактуальных автотестов |
Часть проверок по автотестам и тест-планам выполняется на уровне всего проекта, даже если задан sectionId — эта информация указывается в шапке отчета.
Ограничения
- Сценарий не позволяет определить, была ли связь с требованиями удалена или не была создана.
- Перезапуски автотестов оцениваются по статистике, доступной в API, а не по всей истории.
Генерация ручных тест-кейсов
Сценарий позволяет быстро получить набор ручных функциональных тест-кейсов по описанию функциональности, требованиям или техническому заданию с учетом уже существующих кейсов в библиотеке. После генерации тест-кейсы можно доработать.
Промпт: testit_manual_test_scenarios
Параметры
| Параметр | Обязательный | Пояснение |
|---|---|---|
projectId | да | Идентификатор проекта, в который будут сохранены тесты |
taskDescription | да | Описание функциональности / задачи |
specificationText | нет | Текст технического задания или требований |
librarySectionId | нет | Идентификатор секции библиотеки, в которой содержатся тесты, используемые в качестве контекста |
libraryWorkItemIds | нет | Идентификаторы тестов для контекста |
Пример запроса в чате:
/test-it/testit_manual_test_scenarios
// Вводить промпт необязательно, для запроса можно использовать разговорный язык.
Проект …, задача: авторизация по SSO.
ТЗ: <вставить текст или приложить файл>.
Учти кейсы из секции …
Реализация сценария
- Сбор контекста (проект, при необходимости — существующие кейсы из Test IT).
- Подготовка промпта для генерации и правил форматирования (название, предусловия, шаги, ожидаемые результаты).
- Генерация кейсов, из которых вы можете выбрать тесты для сохранения.
- Сохранение в Test IT (требуется подтверждение и идентификатор секции).
Подготовка общих шагов из дубликатов шагов тестов
Сценарий позволяет найти повторяющиеся шаги тестов (дубликаты), подготовить из них общие шаги и заменить дубликаты в тест-кейсах ссылками на созданные общие шаги.
Промпт: testit_create_shared_steps
Параметры
projectId— идентификатор проекта- Область поиска: вся библиотека, секция или список кейсов (требуется указать в чате с ИИ-ассистентом)
Пример запроса в чате:
/test-it/testit_create_shared_steps
// Вводить промпт необязательно, для запроса можно использовать разговорный язык.
В проекте … найди повторяющиеся шаги в секции «Регресс» и предложи вынести в общие шаги.
Реализация сценария
ИИ-ассистент проводит следующие шаги:
- Поиск кейсов с шагами в указанной области
- Анализ — группировка семантически одинаковых шагов
- План (без записи в Test IT): какие ОШ создать, какие кейсы обновить, таблица соответствий «старый шаг → общий шаг»
- После вашего «да» — создание ОШ и обновление шагов в кейсах.
Уникальные шаги не удаляются. В спорных случаях ИИ-ассистент делает пометку на проверку.
Перенос общих шагов в предусловия секции
Часть повторяющихся шагов логичнее хранить не в каждом тест-кейсе или общем шаге, а в предусловиях секции. В этом случае шаг будет указан в секции 1 раз, а использоваться во всех тестах секции. В отличие от общих шагов, предусловия секции применяются ко всем кейсам в папке автоматически.
Промпт: testit_section_preconditions
Параметры
projectId— идентификатор проекта- При необходимости указываются конкретные секции или весь проект по секциям.
Пример запроса в чате:
/test-it/testit_section_preconditions
// Вводить промпт необязательно, для запроса можно использовать разговорный язык.
Проект …: по каждой секции найди шаги, которые повторяются у большинства кейсов, и предложи перенести в предусловия секции.
Реализация сценария
- Загрузка дерева секций проекта.
- Анализ тестов по каждой секции (удобнее и точнее, чем один запрос на весь проект).
- Поиск шагов, которые повторяются у нескольких кейсов и соответствуют уровню секции (подготовка окружения, общий вход), а не уникальной проверки.
- План: предлагаются дополнения в предусловия секции, а также список кейсов, из которых можно убрать общие шаги.
- Обновление предусловий секции и правка шагов тестов (требуется подтверждение).
Сценарии для автоматизированного тестирования
Сравнение двух прогонов
Сценарий позволяет сопоставить прогоны автотестов: количество тестов, количество тестов с ошибками и изменения в их диагностике, выявленные улучшения и проблемы.
Промпт: testit_compare_test_runs
Параметры
| Параметр | Обязательный | Пояснение |
|---|---|---|
projectId | да | GUID проекта |
testRunId1; testRunId2 | нет | Идентификаторы прогонов для сопоставления |
Для сравнения нужно указать 2 идентификатора прогонов либо не указывать ни одного. Если идентификаторы не указаны, сравниваются два последних прогона проекта.
Примеры запроса в чате:
- Запрос с использованием сценария:
/test-it/testit_compare_test_runs Проект 01955ac0-…. Сравни прогоны aaaaaaaa-… и bbbbbbbb-…. - Свободный текстовый запрос:
Сравни два последних прогона в проекте …
Реализация сценария
- Сравнение возраста прогонов по дате создания.
- Расчет длительности прогонов, количества тестов и тестов с ошибками, дельт.
- Отображение исправленных результатов (Failed → Passed), новых падений автотестов, новых или измененных текстов ошибок.
- Если общее число результатов или упавших тестов не совпадает — показ списка расхождений по отдельным тестам (
onlyInOlder,onlyInNewer, смена результата). - Отображение результата анализа в виде таблицы. По запросу можно просмотреть подробности отдельного результата в Test IT.
Промпты Test IT MCP
Промпт можно использовать как альтернативу текстовому запросу — как готовый сценарий или его часть.
| # | Задача | Рекомендуемый промпт | Результат |
|---|---|---|---|
| 1 | Обзор функциональности MCP | testit_mcp_capabilities_manual | Обзор возможностей ассистента |
| 2 | Проверить состояние библиотеки тестов | testit_library_actuality | Отчет с устаревшими и дублированными ручными тестами, автотестами, а также рекомендации по улучшению |
| 3 | Сгенерировать ручные тесты по ТЗ | testit_manual_test_scenarios | Подготовка промпта и сохранение тестов в проекте |
| 4 | Вынести повторяющиеся шаги в общие шаги (ОШ) | testit_create_shared_steps | План → создание ОШ → обновление кейсов |
| 5 | Перенести общие шаги в предусловия секции | testit_section_preconditions | План → предусловия секции → очистка дублей в тест-кейсах |
| 6 | Сравнить два прогона автотестов | testit_compare_test_runs | Метрики, дельты, улучшения / ошибки и падения автотестов |
Устранение ошибок
- Ассистент не распознает сценарий: Вызовите промпт непосредственно (
/test-it/testit_…) или напишите: «следуй сценариюtestit_library_actuality». - Отсутствуют нужные инструменты (tools): Проверьте подключение MCP; откройте список в MCP Inspector.
- Ошибка доступа к Test IT: В настройках проверьте заголовок
X-baseurlи API-токен. - Ассистент изменяет данные без подтверждения: Напомните:
Сначала только план, без записи в Test IT.
По вопросам подключения, ошибок сервера, а также с предложениями по развитию MCP обратитесь в техническую поддержку: support@testit.software.