Skip to main content
Glama

QTM4J MCP Server

npm npm downloads Node License

MCP-сервер с 42 инструментами для QMetry Test Management for Jira (QTM4J). Ищите и управляйте тест-кейсами, циклами, выполнениями, планами, папками, правилами автоматизации и метаданными проекта из Claude Desktop, Claude Code, VS Code Copilot, Cursor или любого другого MCP-совместимого клиента.

Распространение:

Быстрый старт (клонирование не требуется)

Вам понадобится API-ключ QMetry (QMetry → API Keys) и Node.js 18+.

Claude Desktop

Отредактируйте файл конфигурации и перезапустите Claude:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "qtm4j": {
      "command": "npx",
      "args": ["-y", "qtm4j-mcp-server@^0.1"],
      "env": {
        "QTM4J_API_KEY": "your-api-key-here",
        "QTM4J_REGION": "US"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add qtm4j -e QTM4J_API_KEY=your-api-key-here -e QTM4J_REGION=US -- npx -y qtm4j-mcp-server@^0.1

VS Code (режим агента GitHub Copilot)

Создайте .vscode/mcp.json в вашей рабочей области:

{
  "servers": {
    "qtm4j": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "qtm4j-mcp-server@^0.1"],
      "env": {
        "QTM4J_API_KEY": "${env:QTM4J_API_KEY}",
        "QTM4J_REGION": "US"
      }
    }
  }
}

Переключите Copilot Chat в режим Agent, и инструменты qtm4j_* появятся автоматически.

Cursor

Добавьте в ~/.cursor/mcp.json (или <project>/.cursor/mcp.json для уровня проекта):

{
  "mcpServers": {
    "qtm4j": {
      "command": "npx",
      "args": ["-y", "qtm4j-mcp-server@^0.1"],
      "env": { "QTM4J_API_KEY": "your-api-key-here" }
    }
  }
}

В примерах конфигурации выше пакет зафиксирован на версии ^0.1, чтобы будущие критические обновления не привели к автоматическому обновлению. Удалите суффикс @^0.1, если предпочитаете всегда использовать последнюю версию.

Глобальная установка (быстрый запуск)

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

npm install -g qtm4j-mcp-server

Затем в конфигурации клиента замените команду npx:

{
  "mcpServers": {
    "qtm4j": {
      "command": "qtm4j-mcp-server",
      "env": {
        "QTM4J_API_KEY": "your-api-key-here",
        "QTM4J_REGION": "US"
      }
    }
  }
}

Компромисс: мгновенный запуск и работа в офлайне, но вам нужно будет выполнять npm update -g qtm4j-mcp-server для получения новых версий.

Related MCP server: qtm4j-mcp-server

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

Переменная

Обязательно

По умолчанию

Описание

QTM4J_API_KEY

да

—

API-ключ QMetry, отправляется с каждым запросом в заголовке apiKey

QTM4J_REGION

нет

US

US → https://qtmcloud.qmetry.com, AU → https://syd-qtmcloud.qmetry.com

💡 Установите QTM4J_REGION=AU, если ваш экземпляр QMetry находится в кластере Сиднея.

Инструменты

Все инструменты имеют префикс qtm4j_ во избежание конфликтов с другими MCP-серверами.

Область

Инструменты

Тест-кейсы

qtm4j_create_test_case, qtm4j_get_test_case, qtm4j_search_test_cases, qtm4j_update_test_case, qtm4j_delete_test_case, qtm4j_clone_test_cases, qtm4j_create_test_steps, qtm4j_update_test_steps

Циклы тестирования

qtm4j_create_test_cycle, qtm4j_get_test_cycle, qtm4j_search_test_cycles, qtm4j_update_test_cycle, qtm4j_delete_test_cycle

Выполнения тестов

qtm4j_get_test_cycle_executions, qtm4j_update_test_execution, qtm4j_update_test_step_execution, qtm4j_bulk_update_test_executions

Планы тестирования

qtm4j_create_test_plan, qtm4j_get_test_plan, qtm4j_search_test_plans, qtm4j_update_test_plan, qtm4j_delete_test_plan, qtm4j_link_test_cycles_to_plan, qtm4j_get_linked_test_cycles, qtm4j_unlink_test_cycles_from_plan

Папки

qtm4j_list_folders, qtm4j_create_folder

Автоматизация

qtm4j_link_automation_rule, qtm4j_unlink_automation_rule, qtm4j_run_automation_rules

Метаданные (только чтение)

qtm4j_get_projects, qtm4j_get_priorities, qtm4j_get_priority_icons, qtm4j_get_statuses, qtm4j_get_environments, qtm4j_get_builds, qtm4j_get_labels, qtm4j_get_components, qtm4j_get_execution_results, qtm4j_get_custom_fields, qtm4j_get_parameters, qtm4j_get_user_permissions

См. docs/TOOLS.md для полного справочника и docs/COOKBOOK.md для примеров промптов, которые коллеги могут вставить в любой MCP-клиент.

Каждый инструмент поставляется с аннотациями (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), чтобы клиенты могли решить, нужно ли запрашивать подтверждение. Инструменты чтения принимают параметр response_format (по умолчанию json или markdown для человекочитаемого вывода). Большие ответы автоматически обрезаются на 25 000 символов с подсказкой сузить запрос.

Все инструменты проверяют входные данные с помощью Zod, поддерживают пагинацию через startAt/maxResults и автоматически повторяют запросы при ограничении частоты (HTTP 429) с экспоненциальной задержкой (до 3 попыток).

Проверка в работе

После подключения попросите своего помощника о чем-то вроде:

Найди в проекте QMetry <ваш ID проекта> тест-кейсы со статусом "To Do" и покажи мне первые 5.

Клиент вызовет qtm4j_search_test_cases и отобразит ответ.

Получи все выполнения в цикле тестирования FS-TR-747 и отметь все невыполненные как Pass.

Примеры вызовов инструментов

Замените 10011 ниже на ваш числовой ID проекта Jira. Его можно найти в URL проекта: …?projectId=10011&projectKey=FS.

// Search test cases
{
  "name": "qtm4j_search_test_cases",
  "arguments": {
    "projectId": 10011,
    "status": ["Approved"],
    "maxResults": 20,
    "response_format": "markdown"
  }
}

// Update an execution result
// (executionResultId: 239444=Pass, 239441=Fail, 239443=Not Executed)
{
  "name": "qtm4j_update_test_execution",
  "arguments": {
    "cycleId": "gxMbioKJsyEr3E",
    "testCaseExecutionId": 287595809,
    "executionResultId": 239444,
    "comment": "Verified on staging"
  }
}

Устранение неполадок

  • Инструменты не появляются в клиенте. Перезапустите клиент после редактирования конфигурации. Проверьте claude mcp list (Claude Code) или панель MCP в VS Code для проверки статуса подключения. При первом запуске npx -y qtm4j-mcp-server может потребоваться несколько секунд для загрузки пакета.

  • 401 Unauthorized. Ваш QTM4J_API_KEY недействителен или истек. Создайте новый в QMetry → API Keys.

  • 404 на эндпоинтах выполнения или поиска. Многие эндпоинты требуют внутренний числовой id, а не человекочитаемый ключ, такой как FS-TR-747. Сначала вызовите qtm4j_get_test_cycle, чтобы перевести ключ во внутренний ID.

  • Пустой или слишком большой ответ папки. Передайте folderId в qtm4j_list_folders для ограничения области поиска поддеревом — полные деревья проектов в крупных проектах могут превысить лимит размера ответа.

  • projectId отклонен. Используйте числовой ID проекта Jira (например, 10011), а не ключ проекта ("FS"). Его можно найти в URL проекта Jira: …?projectId=10011&projectKey=FS.

Примечания

  • Эндпоинты поиска используют POST /…/search — фильтры помещаются в тело запроса под ключом filter, пагинация/сортировка — в строке запроса. Обработчики инструментов делают это за вас.

  • Ответы 204 No Content разрешаются как { message: "…" }.

  • Спецификация Swagger в настоящее время не документирует эндпоинт импорта результатов автоматизации в стиле фреймворков (например, JUnit/TestNG/Cucumber); инструменты автоматизации покрывают потоки запуска правил и связывания правил, описанные в спецификации.

Разработка

Локальная настройка, если вы хотите изменить сервер:

git clone https://github.com/salehrifai42/qmetrymcp.git
cd qmetrymcp
npm install
npm run build
QTM4J_API_KEY=your-key npm start

Протестируйте изменения с помощью MCP Inspector:

QTM4J_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js

Ошибки и вклад

Нашли ошибку или хотите предложить функцию? Откройте issue на https://github.com/salehrifai42/qmetrymcp/issues. PR приветствуются.

Лицензия

MIT

Available Tools

30 tools
bulk_update_test_executionsA

Apply the same execution result, environment, or build to multiple test case executions at once. Use testCycleTestCaseMapIds from get_test_cycle_executions (the 'testCycleTestCaseMapId' field). Returns 204 on success.

Inputs: cycleId (required), testCycleTestCaseMapIds (required), executionResultId, environmentId, +1 more.

clone_test_casesA

Bulk clone one or more test cases into a target project and optional folder. Returns a background task object with a taskId and progressUrl to poll for completion.

Inputs: testcaseIds (required), projectId (required), folderId.

create_folderA

Create a new folder under an existing parent folder. Use parentId=0 for root-level. folderName is required. Returns the created folder with its id. Use list_folders first to find valid parentId values.

Inputs: projectId (required), folderName (required), folderType (required), parentId (required), +1 more.

create_test_caseB

Create a new test case in QMetry. Returns the created test case object including its internal id and key (e.g. FS-TC-123). Priority, status, labels, and components use integer IDs — see field_reference.json for valid values.

Inputs: projectId (required), summary (required), precondition, priority, +7 more.

create_test_cycleA

Create a new test cycle in QMetry. Returns the created cycle with its internal id and key (e.g. FS-TR-123). Use list_folders with folderType=TESTCYCLE to find valid folderId values.

Inputs: projectId (required), summary (required), description, priority, +6 more.

create_test_planA

Create a new test plan in QMetry. Returns the created plan with its internal id and key (e.g. FS-TP-44). Use list_folders with folderType=TESTPLAN to find valid folderId values.

Inputs: projectId (required), summary (required), description, priority, +4 more.

create_test_stepsB

Add one or more test steps to a specific version of a test case. Each step has stepDetails (required), expectedResult, and testData. Returns the created step objects with their IDs.

Inputs: id (required), versionNo (required), steps (required).

delete_test_caseA

Permanently delete a specific version of a test case. If it is the only version, the test case is removed entirely. Returns 204 on success.

Inputs: id (required), versionNo (required).

delete_test_cycleA

Permanently delete a test cycle and all its execution records. This is irreversible. Returns 204 on success.

Inputs: id (required).

delete_test_planA

Permanently delete a test plan. This does not delete the linked test cycles. Returns 204 on success.

Inputs: id (required).

get_linked_test_cyclesA

List all test cycles currently linked to a test plan. Returns paginated list with id, key, status, priority per cycle. Use the plan's internal id (not key).

Inputs: id (required), startAt, maxResults, sort, +1 more.

get_test_caseA

Get a test case by its internal ID or key (e.g. FS-TC-31950). Returns an array of versions, each with versionNo, isLatestVersion, aiGenerated flag, and any test steps.

Inputs: id (required).

get_test_cycleA

Get a test cycle by its key (e.g. FS-TR-747) or internal id. Returns id, key, status, priority, projectId, archived flag. The internal 'id' returned here is required by get_test_cycle_executions and update_test_execution.

Inputs: id (required).

get_test_cycle_executionsA

List all test case executions linked to a test cycle. Requires the internal cycle id (from get_test_cycle, not the key). Returns testCycleTestCaseMapId (needed for bulk_update), testCaseExecutionId (needed for update_test_execution), key, status, and priority per test case.

Inputs: id (required), startAt, maxResults, sort, +1 more.

get_test_planA

Get a test plan by its key (e.g. FS-TP-43) or internal id. Returns id, key, projectId, archived flag. Use the internal 'id' when calling link/unlink/get_linked_test_cycles.

Inputs: id (required).

list_foldersA

List folders of a given type in a project as a nested tree with id, name, parentId, and children. Provide folderId to return only that subtree instead of the full project tree (recommended for large projects).

Inputs: projectId (required), folderType (required), folderId.

run_automation_rulesA

Trigger an automation rule to run against a specific test cycle. testCycleId is the internal id string (from get_test_cycle). Returns a background task object with taskId and progressUrl to poll for completion.

Inputs: automationRuleKey (required), projectId (required), testCycleId (required).

search_test_casesA

Search test cases in a project with optional filters. Returns total count and paginated data with id, key, version info, archived flag. Use status/priority name strings (e.g. 'To Do', 'High') not IDs. projectId must be numeric (10011). Set recursive=true with a folderId to count across all subfolders (returns total only, no data).

Inputs: projectId (required), labels, components, recursive, +9 more.

search_test_cyclesA

Search test cycles in a project. Returns total count and paginated list with id, key, status, priority, archived. The 'id' field in results is the internal ID needed for execution tools.

Inputs: projectId (required), folderId, status, priority, +6 more.

search_test_plansB

Search test plans in a project. Returns total count and paginated list with id, key, projectId, archived. The 'id' field is the internal ID needed for linking cycles.

Inputs: projectId (required), folderId, status, priority, +6 more.

update_test_caseB

Update fields on a specific version of a test case. Requires both the test case id and versionNo (usually 1 for latest). Priority and status take integer IDs. Returns 204 on success.

Inputs: id (required), versionNo (required), summary, precondition, +7 more.

update_test_cycleA

Update a test cycle's metadata (summary, description, priority, status, dates, custom fields). Pass the internal id or key. Returns 204 on success.

Inputs: id (required), summary, description, priority, +5 more.

update_test_executionA

Update a single test case execution result inside a test cycle. Use testCaseExecutionId from get_test_cycle_executions. executionResultId: 239443=Not Executed, 239444=Pass, 239441=Fail, 239442=Work In Progress, 239440=Blocked. Returns 204 on success.

Inputs: cycleId (required), testCaseExecutionId (required), executionResultId, environmentId, +3 more.

update_test_planC

Update a test plan's priority or custom fields. Returns 204 on success.

Inputs: id (required), priority, customFields.

update_test_step_executionA

Update a single step-level execution result within a test case execution. testStepExecutionId comes from get_test_cycle_executions step data. Returns 200 with updated step data.

Inputs: cycleId (required), testStepExecutionId (required), executionResultId, actualResult, +1 more.

update_test_stepsA

Update existing test steps on a test case version. Each step must include its step id (from create_test_steps or get_test_case response). Returns the updated step objects.

Inputs: id (required), versionNo (required), steps (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 30 tools

    Disambiguation5/5

    Each tool targets a distinct entity or operation (folders, test cases, cycles, plans, executions, automation rules, linking). Despite high tool count, descriptions make purposes clear with no overlapping functionality.

    Naming Consistency5/5

    All tools use a consistent verb_noun pattern in snake_case (e.g., create_folder, update_test_execution, search_test_plans). Variations between get/list/search are semantically justified by the operation type.

    Tool Count3/5

    30 tools is on the high side, but the domain (test management) requires many entities and operations. While borderline heavy, most tools serve essential functions without redundancy.

    Completeness4/5

    Covers CRUD for core entities (test cases, cycles, plans, folders), steps, executions (single/bulk), linking, and automation. Missing delete for folders and some retrieval details, but core workflows are complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers