QTM4J MCP Server
QTM4J MCP Server
MCP-сервер с 42 инструментами для QMetry Test Management for Jira (QTM4J). Ищите и управляйте тест-кейсами, циклами, выполнениями, планами, папками, правилами автоматизации и метаданными проекта из Claude Desktop, Claude Code, VS Code Copilot, Cursor или любого другого MCP-совместимого клиента.
Распространение:
npm:
qtm4j-mcp-serverРеестр MCP:
io.github.salehrifai42/qtm4j-mcp-serverGitHub:
salehrifai42/qmetrymcp
Быстрый старт (клонирование не требуется)
Вам понадобится API-ключ QMetry (QMetry → API Keys) и Node.js 18+.
Claude Desktop
Отредактируйте файл конфигурации и перезапустите Claude:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.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.1VS 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
Конфигурация
Переменная | Обязательно | По умолчанию | Описание |
| да | — | API-ключ QMetry, отправляется с каждым запросом в заголовке |
| нет |
|
|
💡 Установите
QTM4J_REGION=AU, если ваш экземпляр QMetry находится в кластере Сиднея.
Инструменты
Все инструменты имеют префикс qtm4j_ во избежание конфликтов с другими MCP-серверами.
Область | Инструменты |
Тест-кейсы |
|
Циклы тестирования |
|
Выполнения тестов |
|
Планы тестирования |
|
Папки |
|
Автоматизация |
|
Метаданные (только чтение) |
|
См. 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 приветствуются.
Лицензия
Available Tools
30 toolsbulk_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).
link_automation_ruleA
Associate an automation rule with a test cycle so it can be triggered for that cycle. automationRuleKey is the rule's string key from your QMetry automation config. Returns 200 on success.
Inputs: cycleId (required), automationRuleKey (required).
link_test_cycles_to_planA
Link one or more existing test cycles to a test plan. Use the plan's internal id (from get_test_plan or search_test_plans). testcycleIds are numeric integer IDs. Returns 204 on success.
Inputs: id (required), testcycleIds (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.
unlink_automation_ruleA
Remove the association between an automation rule and a test cycle. Returns 200 on success.
Inputs: cycleId (required), automationRuleKey (required).
unlink_test_cycles_from_planA
Remove the link between one or more test cycles and a test plan. Does not delete the cycles themselves. Returns 204 on success.
Inputs: id (required), testcycleIds (required).
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
Scored across 30 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.
Official MCP server for Qase — manage test cases, runs, suites, defects via AI tools.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server to interact with the QMetry for Jira API, enabling management of test cases, test cycles, test plans, and more through well-defined tools.9388 npmApache 2.0
- AlicenseAqualityDmaintenanceMCP server for QTM4J (QMetry Test Management for Jira) Open API, enabling test case and cycle management via natural language.2139 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for Zephyr Scale test management enabling test case, test run, folder, and assignment operations via natural language.2MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that connects AI assistants to Xray Cloud for Jira test management, enabling natural language interaction with tests, test plans, executions, and CI result imports.MIT