qa-touch-mcp

QA Touch テスト管理 API 用の MCP (Model Context Protocol) サーバーです。Claude などの AI アシスタントが、QA Touch ドメイン内でプロジェクトの閲覧、テストケースの管理、テスト実行の実施、結果の記録、不具合の登録を行えるようにします。

要件

• Node.js 18+

• Professional または Enterprise プランの QA Touch アカウント (API はこれらのプランに限定されています)

• API トークン: QA Touch で Profile → Edit Profile → Generate API Key に移動して取得します

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 は1分間当たり50リクエストまで許可します。サーバーはクライアント側でスロットリングを行い、429 応答時は Retry-After を尊して1回再試行します。

• ページネーション: リスト系ツールは page パラメータを受け付けます。QA Touch API は1ページ目で meta.current_page/last_page を null として返すため、サーバーはこれを正規化し、has_next フラグを追記します。

• 添付ファイル: png, pdf, jpg, jpeg, gif, xls, xlsx, doc, docx, csv, log, zip, txt — 1ファイル当たり最大2 MBで、アップロード前に検証されます。

• バッチ制限: 複数ケースのステータス更新は、API がパラメータを URL で受け取り、長すぎる URI を拒否するため、1回の呼び出し当たり最大20件に制限されています。

開発

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

この実装で使用した API リファレンスノート: docs/qatouch-api-reference.md。