QA Touch MCP Server

Official Model Context Protocol (MCP) server for QA Touch.

QA Touch is a modern test management platform for organizing projects, test cases, test runs, execution results, defects, requirements, releases, and QA reporting. This MCP server lets MCP-compatible AI assistants interact with QA Touch through a secure, tool-based interface.

Features

• List and count QA Touch projects

• Create projects

• List and search test cases

• Create structured, bulk, exploratory, and text-template test cases

• List, count, search, and create modules

• List, count, search, and create releases/milestones

• List, count, search, and create requirements and requirement documents

• List, count, search, and create defects

• List defect statuses, severities, issue types, and environments

• List test runs, test run results, result history, and available statuses

• Update single or batch test run result statuses

• List users available for test execution

• Search across project test cases, modules, requirements, defects, and releases

• List QA Touch workspaces

Related MCP server: kintone MCP Server

Requirements

• Node.js 18+

• npm

• QA Touch API token

• QA Touch domain

Installation

Run directly with npx:

npx -y qatouch-mcp-server

Or install globally:

npm install -g qatouch-mcp-server
qatouch-mcp-server

The server requires these environment variables:

QATOUCH_DOMAIN=yourdomain
QATOUCH_API_TOKEN=yourtoken

Claude Desktop Setup

Add this server to your Claude Desktop MCP configuration.

Windows config location:

%APPDATA%\Claude\claude_desktop_config.json

macOS config location:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux config location:

~/.config/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "qatouch": {
      "command": "npx",
      "args": [
        "-y",
        "qatouch-mcp-server"
      ],
      "env": {
        "QATOUCH_DOMAIN": "yourdomain",
        "QATOUCH_API_TOKEN": "yourtoken"
      }
    }
  }
}

Restart Claude Desktop after saving the file.

Available Tools

Example Prompts

• List all QA Touch projects

• Count all QA Touch projects

• Create a project named Mobile App Regression

• Show test cases from project ABC

• Search test cases containing "login" in project ABC

• Create a login test case in project ABC under section AUTH

• Create 8 regression test cases for checkout in project ABC under section CHECKOUT

• List modules from project ABC

• Create a module named Payment Gateway in project ABC

• List releases from project ABC

• Create release "June Regression" in project ABC

• List requirements from project ABC

• Search requirements containing "password reset" in project ABC

• List requirement documents in project ABC

• Create a requirement document named Login Requirements for release REL1 in project ABC

• Create a requirement for valid login in document DOC1

• List defects from project ABC

• Show high priority defects in project ABC

• Search defects containing "timeout" in project ABC

• Create a high priority defect in project ABC for checkout payment timeout

• List test runs from project ABC

• Show test run results for test run RUN1 in project ABC

• Show result history for result RES1 in test run RUN1

• List available test run statuses

• Mark result RES1 as failed in test run RUN1 for project ABC

• Batch update TC-101 as passed and TC-102 as blocked in test run RUN1

• List testers available for project ABC

• Search project ABC for "login"

• Generate a QA status report for project ABC

• Identify unexecuted test cases in test run RUN1

• For more📖 Prompt Examples: how_to_use.txt

Development

Install dependencies:

npm install

Run the MCP server locally:

npm start

Environment variables are required when running locally:

QATOUCH_DOMAIN=yourdomain QATOUCH_API_TOKEN=yourtoken npm start

This repository currently defines only the start script in package.json.

Project Structure

src/
  api/          QA Touch API client
  config/       Environment variable validation
  tools/        MCP tool definitions and handlers
  index.js      MCP server entry point and tool registration
examples/       Prompt and client setup examples

Contributing

Contributions are welcome. See CONTRIBUTING.md for development workflow, coding standards, and pull request guidance.

License

This project is licensed under the MIT License.