qatouch

QA Touch MCP サーバー

QA Touch 公式の Model Context Protocol（MCP）サーバーです。

QA Touch は、プロジェクト、テストケース、テスト実行、実行結果、不具合、要件、リリース、QA レポートを管理するための最新のテスト管理プラットフォームです。この MCP サーバーを使用すると、MCP に対応した AI アシスタントが、安全なツールベースのインターフェースを通じて QA Touch を操作できます。

QA Touch - Claude スキルリポジトリ - https://github.com/qatouch/qatouch-claude-skills

機能

• QA Touch のプロジェクトを一覧表示、件数取得
• プロジェクトを作成
• テストケースを一覧表示、検索
• 構造化テストケース、一括テストケース、探索的テストケース、テキストテンプレートのテストケースを作成
• モジュールを一覧表示、件数取得、検索、作成
• リリース／マイルストーンを一覧表示、件数取得、検索、作成
• 要件と要件ドキュメントを一覧表示、件数取得、検索、作成
• 不具合を一覧表示、件数取得、検索、作成
• 不具合のステータス、重大度、課題タイプ、環境を一覧表示
• テスト実行、テスト実行結果、結果の履歴、利用可能なステータスを一覧表示
• 単一または一括のテスト実行結果のステータスを更新
• テスト実行で利用可能なユーザーを一覧表示
• プロジェクトのテストケース、モジュール、要件、不具合、リリースを横断検索
• QA Touch のワークスペースを一覧表示

要件

• Node.js 18+
• npm
• QA Touch API トークン
• QA Touch ドメイン

インストール

npx で直接実行します。

npx -y qatouch-mcp-server

または、グローバルにインストールします。

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

サーバーには以下の環境変数が必要です。

QATOUCH_DOMAIN=yourdomain
QATOUCH_API_TOKEN=yourtoken

Claude Desktop のセットアップ

このサーバーを Claude Desktop の MCP 設定に追加します。

Windows の設定ファイルの場所：

%APPDATA%\Claude\claude_desktop_config.json

macOS の設定ファイルの場所：

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

Linux の設定ファイルの場所：

~/.config/Claude/claude_desktop_config.json

設定：

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

ファイルを保存した後、Claude Desktop を再起動してください。

利用可能なツール

ツール	説明
count_all_projects	ドメインで利用可能な QA Touch プロジェクトの合計数を取得します
count_defects	QA Touch プロジェクトで利用可能な不具合の合計数を取得します
count_modules	QA Touch プロジェクトで利用可能なモジュールの合計数を取得します
count_releases	QA Touch プロジェクトで利用可能なリリースの合計数を取得します
count_requirements	QA Touch プロジェクトで利用可能な要件の合計数を取得します
count_test_cases	QA Touch プロジェクトで利用可能なテストケースの合計数を取得します
count_test_runs	QA Touch プロジェクトで利用可能なテスト実行の合計数を取得します
create_bulk_test_cases	シナリオから複数の QA Touch テストケースを作成します
create_defect	優先度と課題の概要を指定して QA Touch の不具合を作成します
create_exploratory_test_case	構造化されたステップを含まない QA Touch の探索的セッション用テストケースを作成します
create_module	QA Touch プロジェクトにモジュールを作成します
create_project	新しい QA Touch プロジェクトを作成します
create_release	QA Touch プロジェクトに新しいリリースまたはマイルストーンを作成します
create_requirement	QA Touch プロジェクトの要件ドキュメントに要件を作成します
create_requirement_document	QA Touch プロジェクトに要件ドキュメントを作成します
create_test_run_with_modules	1 つ以上のモジュールキーを選択して新しいテスト実行を作成します
create_test_case	構造化されたステップを含む QA Touch テストケースを作成します
create_text_test_case	テキストテンプレートのエンドポイントを使用して QA Touch テストケースを作成します
import_test_cases	CSV ファイルを使用して QA Touch プロジェクトにテストケースをインポートします
list_defect_environments	QA Touch の不具合で利用可能なすべての環境を一覧表示します
list_defect_issue_types	QA Touch の不具合で利用可能なすべての課題タイプを一覧表示します
list_defect_severities	QA Touch の不具合で利用可能なすべての重大度を一覧表示します
list_defect_statuses	QA Touch の不具合で利用可能なすべてのステータスを一覧表示します
list_defects	プロジェクトのすべての不具合を取得します
list_modules	プロジェクトのすべてのモジュールを取得します
list_projects	すべての QA Touch プロジェクトを取得します
list_releases	プロジェクトのすべてのリリースを取得します
list_requirement_documents	QA Touch プロジェクトの要件ドキュメントを一覧表示します
list_requirements	プロジェクトのすべての要件を取得します
list_test_cases	プロジェクトのすべてのテストケースを取得します
list_test_run_available_users	QA Touch プロジェクトでテストに利用できるユーザーを一覧表示します
list_test_run_result_history	QA Touch のテスト実行結果の履歴を一覧表示します
list_test_run_results	QA Touch のテスト実行のすべての結果を一覧表示します
list_test_run_statuses	QA Touch のテスト実行で利用可能なすべてのステータスを一覧表示します
list_test_runs	プロジェクトのすべてのテスト実行を取得します
list_workspace	ドメインで利用可能なすべての QA Touch ワークスペースを一覧表示します
search_defects	プロジェクトの不具合を取得し、課題の概要を検索します
search_modules	プロジェクトのモジュールを取得し、モジュール名を検索します
search_project	プロジェクト内のテストケース、モジュール、要件、不具合、リリースを検索します
search_releases	プロジェクトのリリースを取得し、マイルストーン名を検索します
search_requirements	要件を取得し、タイトルと説明を検索します
search_test_cases	プロジェクトのすべてのテストケースを取得し、テストケースのタイトルと説明を検索します
update_test_run_result_status	QA Touch の単一のテスト実行結果のステータスを更新します
update_test_run_results_by_code	テストケースコードを指定して、QA Touch のテスト実行結果のステータスを一括更新します

プロンプトの例

• QA Touch のすべてのプロジェクトを一覧表示する
• QA Touch のすべてのプロジェクト数を数える
• Mobile App Regression という名前のプロジェクトを作成する
• プロジェクト ABC のテストケースを表示する
• プロジェクト ABC で「login」を含むテストケースを検索する
• プロジェクト ABC のセクション AUTH にログインのテストケースを作成する
• プロジェクト ABC のセクション CHECKOUT にチェックアウトの回帰テストケースを 8 件作成する
• /path/to/testcases.csv のテストケースをプロジェクト ABC にインポートする
• プロジェクト ABC のモジュールを一覧表示する
• プロジェクト ABC に Payment Gateway という名前のモジュールを作成する
• プロジェクト ABC のリリースを一覧表示する
• プロジェクト ABC に「June Regression」リリースを作成する
• プロジェクト ABC の要件を一覧表示する
• プロジェクト ABC で「password reset」を含む要件を検索する
• プロジェクト ABC の要件ドキュメントを一覧表示する
• プロジェクト ABC で、リリース REL1 用に Login Requirements という名前の要件ドキュメントを作成する
• ドキュメント DOC1 に有効なログインの要件を作成する
• プロジェクト ABC の不具合を一覧表示する
• プロジェクト ABC の優先度の高い不具合を表示する
• プロジェクト ABC で「timeout」を含む不具合を検索する
• プロジェクト ABC で、チェックアウトの決済タイムアウトに関する優先度の高い不具合を作成する
• プロジェクト ABC のテストランを一覧表示する
• プロジェクト「v7Nz」で「Regression Run」という名前のテストランを作成し、モジュール「2BQXR」と「VeRDL」を使用して、マイルストーン「0DLB」の下でユーザー「M7」に割り当てる
• プロジェクト ABC のテストラン RUN1 のテストラン結果を表示する
• テストラン RUN1 の結果 RES1 の結果履歴を表示する
• 利用可能なテストランのステータスを一覧表示する
• プロジェクト ABC のテストラン RUN1 で結果 RES1 を失敗としてマークする
• テストラン RUN1 で TC-101 を合格、TC-102 をブロックとして一括更新する
• プロジェクト ABC で利用可能なテスターを一覧表示する
• プロジェクト ABC で「login」を検索する
• プロジェクト ABC の QA ステータスレポートを生成する
• テストラン RUN1 で未実行のテストケースを特定する
• その他📖 プロンプトの例：how_to_use.txt

開発

依存関係をインストールします。

npm install

MCP サーバーをローカルで実行します。

npm start

ローカルで実行するには環境変数が必要です。

QATOUCH_DOMAIN=yourdomain QATOUCH_API_TOKEN=yourtoken npm start

このリポジトリでは現在、package.json に start スクリプトのみが定義されています。

プロジェクト構成

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.md をご覧ください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。