TCSoftInc/testcollab-mcp-server

Создать новый тестовый набор в TestCollab. Совет: сначала вызовите get_project_context, чтобы увидеть существующие наборы и преобразовать названия родительских наборов в их ID. Обязательно: title Опционально: project_id, parent (ID или название набора), description Примеры: Корневой набор: { "title": "Authentication" } Дочерний набор: { "title": "Login", "parent": "Authentication" } С описанием: { "title": "API Tests", "description": "Tests for REST API endpoints" }

Создайте новый тестовый кейс в TestCollab. Подсказка: сначала вызовите get_project_context, чтобы преобразовать названия suite/tag/custom field в ID. Обязательно: title Опционально: project_id, suite (ID или заголовок), description, priority (0=Low, 1=Normal, 2=High), steps, tags, requirements, custom_fields, attachments Формат steps: [{ "step": "action", "expected_result": "result" }] Формат custom_fields: [{ "id": 5, "name": "field_name", "value": "value", "valueLabel": "display" }] Пример: { "title": "Verify login", "priority": 2, "steps": [ { "step": "Navigate to login", "expected_result": "Page loads" }, { "step": "Enter credentials", "expected_result": "Login succeeds" } ] }

Создайте тест-план в TestCollab одним вызовом MCP-инструмента. Перед вызовом инструмента: - Задавайте уточняющие вопросы, если не хватает обязательной информации. - Не додумывайте и не генерируйте автоматически обязательные значения вроде project_id. Порядок выполнения: 1) POST /testplans 2) POST /testplantestcases/bulkAdd (опционально) 3) POST /testplanconfigurations (опционально) 4) POST /testplans/assign (опционально) Опциональные поля: - project_id - title (по умолчанию "Test Plan DD Month YYYY HH:mm:ss", если не указан) - description - priority (0=Low, 1=Normal, 2=High) - test_plan_folder (ID или название) - release (ID или название) - start_date, end_date - custom_fields - test_cases (test_case_ids/selector/assignee; assignee поддерживает ID пользователя/"me"/имя) - configurations - assignment (поддерживает ID пользователей/"me"/имена; если пользователь говорит "назначь меня", используйте "me") Пример: { "project_id": 16, "title": "Release 2.9 Regression", "priority": 1, "test_cases": { "test_case_ids": [101, 102, 103] }, "configurations": [ [{ "field": "Browser", "value": "Chrome" }, { "field": "OS", "value": "Windows" }] ], "assignment": { "executor": "team", "assignment_criteria": "testCase", "assignment_method": "automatic", "user_ids": [27, 31] } }

Удаляет тестовый набор из TestCollab. ВНИМАНИЕ: Это удалит набор и может затронуть дочерние наборы и тестовые сценарии. Используйте с осторожностью. Обязательно: id (идентификатор набора) Опционально: project_id

Удалить тест-план из TestCollab. ВНИМАНИЕ: это навсегда удаляет тест-план и связанные с ним данные выполнения. Обязательно: id (идентификатор тест-плана) Опционально: project_id

Получает контекст проекта: название, описание, тип приложения, дерево наборов, теги, test_case_custom_fields, test_plan_custom_fields, требования, папки тест-планов, релизы и участников проекта. Возвращает метаданные, необходимые для преобразования читаемых названий (например, заголовков наборов, имён тегов, названий папок, названий релизов, имён пользователей) в числовые идентификаторы, которые используют другие инструменты. Также возвращает описание проекта и app_type (web_app, mobile_app, api, desktop_app, other) — эти данные должны влиять на стиль создаваемых тестовых шагов. ВАЖНО: Вызывайте этот инструмент в начале каждого разговора, прежде чем использовать любой другой инструмент TestCollab. Это предотвращает ошибки из-за неразрешённых названий наборов, имён тегов или ссылок на настраиваемые поля.

Получить сведения о конкретном наборе тестов по ID. Возвращает название, описание, parent_id и другие метаданные набора. Обязательно: id (идентификатор набора) Опционально: project_id

Получить один тестовый кейс с полными деталями, включая шаги и ожидаемые результаты. Обязательно: id (идентификатор тестового кейса) Опционально: project_id, parse_reusable_steps (по умолчанию: true) Пример: { "id": 1835, "parse_reusable_steps": true }

Получает один тест-план с общей информацией: - Количество включённых тест-кейсов - Конфигурации тест-плана - Прогоны тест-плана - Текущий статус выполнения Обязательно: id или title Опционально: project_id, include_configurations, include_runs, runs_limit, runs_offset, runs_sort Пример: { "id": 812, "project_id": 16 } или { "title": "Release 3.0 Regression", "project_id": 16 }

Вывести все тестовые наборы в проекте TestCollab в виде иерархического дерева. Возвращает полное дерево наборов с отношениями родитель-потомок. Каждый узел набора включает: id, title, parent_id, children (вложенные наборы). Необязательные фильтры: - title: Фильтровать наборы по подстроке заголовка. - title_contains: Фильтровать наборы по подстроке заголовка (применяется на уровне API). - parent: Фильтровать наборы по ID родительского набора. - description: Фильтровать наборы по подстроке описания.

Выводит тест-кейсы из проекта TestCollab с опциональной фильтрацией, сортировкой и пагинацией. Совет: сначала вызовите get_project_context, чтобы преобразовать названия наборов/тегов/пользовательских полей в ID. Примечание: list_test_cases может опускать подробные шаги — используйте get_test_case для полного тест-кейса с шагами. Поля для фильтрации: - id, title, description, steps, priority (0=Low, 1=Normal, 2=High) - suite (ID или название), created_by, reviewer, poster (ID пользователей) - created_at, updated_at, last_run_on (даты) - tags, requirements (массивы ID или названий) - under_review, is_automated (0 или 1) - run_count, avg_execution_time, failure_rate Типы фильтров: - текст: равно, не равно, содержит, не содержит, начинается с, заканчивается на, пусто - число: равно, не равно, больше, больше или равно, меньше, меньше или равно, в диапазоне - дата: равно, не равно, больше, меньше, в диапазоне Пример фильтра: { "priority": { "filterType": "number", "type": "greaterThanOrEqual", "filter": 1 }, "title": { "filterType": "text", "type": "contains", "filter": "login" } }

Выводит список тест-планов из TestCollab с возможностью фильтрации, сортировки и пагинации. Опциональные фильтры: - title_contains - status: 0/1/2/3 или draft/ready/finished/finished_with_failures - priority: 0/1/2 или low/normal/high - archived: true/false - created_by: ID создателя - test_plan_folder: ID папки или название папки - release: ID релиза или название релиза - created_at_from/to, updated_at_from/to, start_date_from/to, end_date_from/to, last_run_from/to - filter: сырой объект фильтра для продвинутых ключей (объединяется с явными фильтрами) Пример: { "project_id": 16, "title_contains": "Release", "status": "ready", "priority": "high", "created_by": 27, "sort_by": "updated_at", "sort_order": "desc", "limit": 25, "offset": 0 }

Переносит тестовый набор в другую родительскую группу или на корневой уровень. Подсказка: сначала вызовите get_project_context, чтобы увидеть текущее дерево наборов. Обязательно: id (ID набора), parent (новый родительский ID, название или null для корневого уровня) Необязательно: project_id Примеры: Переместить под родительскую: { "id": 10, "parent": "Authentication" } Переместить на корневой уровень: { "id": 10, "parent": null }

Устанавливает порядок сортировки дочерних наборов внутри заданного родителя. Подсказка: сначала вызови get_project_context или list_suites, чтобы увидеть текущие ID наборов и их порядок. Обязательно: parent (ID родительского набора, его название или null для корня), suite_ids (упорядоченный массив ID наборов) Опционально: project_id Пример — переупорядочить наборы корневого уровня: { "parent": null, "suite_ids": [5, 3, 8, 1] } Пример — переупорядочить дочерние наборы «Authentication»: { "parent": "Authentication", "suite_ids": [12, 10, 15] }

Обновляет существующий тестовый набор в TestCollab. Будут обновлены только переданные поля. Обязательно: id (идентификатор набора) Опционально: project_id, title, description Примечание: чтобы переместить набор в другой родительский узел, используйте инструмент move_suite. Пример: { "id": 42, "title": "Переименованный набор", "description": "Обновлённое описание" }

Обновляет существующий тест-кейс в TestCollab. Будут обновлены только указанные поля. Совет: сначала вызовите get_project_context, чтобы преобразовать имена сьютов, тегов и пользовательских полей в идентификаторы. Совет: если нужны существующие шаги (например, чтобы заполнить отсутствующие ожидаемые результаты), сначала вызовите get_test_case, а затем используйте steps_patch. Обязательно: id (идентификатор тест-кейса) Необязательные поля: - title: новый заголовок - suite: переместить в другой сьют - description: новое описание (HTML) - priority: 0 (Low), 1 (Normal), 2 (High) - steps: заменяет все существующие шаги - steps_patch: исправляет шаги по номеру шага (начиная с 1) без замены всех шагов - tags: заменяет все существующие теги - requirements: заменяет все существующие требования - custom_fields: обновляет отдельные пользовательские поля Пример: { "id": 1712, "title": "Updated login test", "priority": 2 } Пример — исправление одного шага: { "id": 1714, "steps_patch": [ { "step_number": 1, "expected_result": "Appropriate expected result" } ] }

Обновляет существующий тестовый план в TestCollab. Обязательно: - id (идентификатор тестового плана) Все остальные поля опциональны — обновляются только переданные поля. Поля: - title - description (null для очистки) - priority: 0/1/2 или low/normal/high - status: 0/1/2/3 или draft/ready/finished/finished_with_failures - test_plan_folder: ID/title/null - release: ID/title/null - start_date, end_date (null для очистки) - archived - custom_fields (null/[] для очистки) - assignee (удобный способ для одного пользователя) - assignment (расширенный payload назначения) Пример: { "id": 812, "title": "Release 3.0 Regression", "status": "ready", "test_plan_folder": "Mobile", "assignee": "me" }