qa-touch-mcp

MCP-сервер (Model Context Protocol) для API управления тестированием QA Touch. Позволяет ИИ-ассистентам, таким как Claude, просматривать проекты, управлять тест-кейсами, проводить тестовые прогоны, записывать результаты и регистрировать дефекты в вашем домене QA Touch.

Требования

• Node.js 18+

• Учётная запись QA Touch на тарифном плане Professional или Enterprise (API доступен только на этих планах)

• API-токен: в QA Touch перейдите в Профиль → Изменить профиль → Сгенерировать API-ключ

Related MCP server: Testmo MCP Server

Конфигурация

Сервер настраивается полностью через переменные окружения:

Токен предоставляет доступ ко всем данным в вашем домене QA Touch. Не храните его в системе контроля версий.

Установка

Claude Code

claude mcp add qa-touch --env QATOUCH_DOMAIN=yourdomain --env QATOUCH_API_TOKEN=yourtoken -- npx qa-touch-mcp

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "qa-touch": {
      "command": "npx",
      "args": ["qa-touch-mcp"],
      "env": {
        "QATOUCH_DOMAIN": "yourdomain",
        "QATOUCH_API_TOKEN": "yourtoken"
      }
    }
  }
}

Из исходного кода

npm install
npm run build
QATOUCH_DOMAIN=yourdomain QATOUCH_API_TOKEN=yourtoken node dist/index.js

Инструменты (32)

Проекты — list_projects, get_project, create_project

Тест-кейсы и модули — list_test_cases (фильтрация по статусу утверждения, модулю, режиму или требованию), get_test_case, get_test_case_steps, list_modules, create_module, create_test_case (шаблоны: исследовательский / текстовый / BDD / пошаговый), update_test_case, import_test_cases_csv

Релизы и планы — list_releases, create_release, list_test_plans, list_workspaces

Тестовые прогоны и результаты — list_test_runs, get_test_run, create_test_run (все тест-кейсы / конкретные тест-кейсы / по модулю), clone_test_run, list_test_run_results (по прогону, релизу, истории или кейсу), get_test_run_metadata, update_test_result, update_test_result_steps, bulk_update_test_results, update_test_results_multi, add_test_result (с вложениями)

Дефекты — list_defects, create_defect (с вложениями), get_defect_metadata

Требования — list_requirements, create_requirement_document, create_requirement

Примечания о поведении

• Ограничение частоты запросов: QA Touch допускает 50 запросов в минуту. Сервер ограничивает частоту запросов на стороне клиента и при получении 429 повторяет запрос один раз, учитывая заголовок Retry-After.

• Пагинация: инструменты списков принимают параметр page. API QA Touch возвращает meta.current_page/last_page как null на первой странице; сервер нормализует это значение и добавляет флаг has_next.

• Вложения: png, pdf, jpg, jpeg, gif, xls, xlsx, doc, docx, csv, log, zip, txt — максимум 2 МБ на файл, проверяются перед загрузкой.

• Лимиты пакетных операций: массовые обновления статуса тест-кейсов ограничены 20 элементами за вызов, так как API принимает параметры в URL и отклоняет слишком длинные URI.

Разработка

npm run build   # compile TypeScript
npm test        # run unit tests (vitest)

Заметки из справочника API, использованные при реализации: docs/qatouch-api-reference.md.