Qase Test Management

Qase MCP Server

Qase Test Management Platform向けの公式Model Context Protocol（MCP）サーバーです。AI アシスタントをテストケース、テストラン、欠陥などに接続します。

目次

• 概要
• ユースケース
• クイックスタート
  • ホスト型 Qase MCP を使う（推奨）
  • 自分で実行する
• このサーバーを基盤に構築する
• v1 からのアップグレード
• ツール
• ドキュメント
• コントリビューション
• ライセンス
• サポート
• リンク

概要

Qase MCP Server を使うと、AI アシスタント（Claude、Cursor、Codex、その他あらゆる MCP クライアント）が、カスタムの統合コードを用意することなく、標準化されたプロトコルを通じて Qase のテストケース、テストラン、結果、欠陥、スイート、マイルストーンなどを読み書きできます。

機能：

• タスク指向のツールが 40 種類（qase_discover_tools と qase_tool_help を含めて合計 42 種類）— v1 の 83 種類のツールを統合し、トークン使用量を削減して LLM の精度を向上
• 複合ツール — CI のレポート、欠陥のトリアージ、回帰テストランの設定など、複数ステップのワークフローを 1 回の呼び出しで実行
• QQL サポート — ケース、テストラン、結果、欠陥、プランを横断する高度な検索に対応する Qase Query Language
• プロジェクトコンテキストの初期取得 — 1 回の呼び出しで、プロジェクトの全構造（スイート、マイルストーン、環境、ユーザー、カスタムフィールド）を取得
• テストケースのレビュー — 新しいケースや変更をレビュー用に提案し、レビュアーを割り当ててステータスを追跡（承認とマージは引き続き UI でのみ可能）
• 簡潔な説明と、必要に応じたドキュメント — 最初のリクエストからすべてのツールを一覧表示します。エージェントがツールを初めて使用するときに qase_tool_help がそのツールの完全なドキュメントを返し、qase_discover_tools はタスクを指定してカタログを検索します
• ホスト型またはセルフ実行型 — Qase のログイン情報だけで https://mcp.qase.io/mcp（EU クラスターでは https://mcp-eu.qase.io/mcp）に接続するか、独自の API トークンを使ってサーバーをローカルで実行
• テナントを分離したキャッシュと HTTP の耐障害性 — 2 層キャッシュ（メモリ内＋オプションの Redis）、コネクションプーリング、バックオフ付きリトライ
• 代替手段 — qase_api を使って任意のエンドポイントに REST API から直接アクセス

ユースケース

シナリオ	プロンプトの例	ツール
プロジェクトコンテキストの初期取得	「プロジェクト DEMO の構造（スイート、マイルストーン、環境）を表示して」	qase_project_context
テストケースの作成または更新	「プロジェクト DEMO に、タイトルが『Login with valid credentials』の優先度が高いスモークテストケースを作成して」	qase_case_upsert
CI 結果の報告	「プロジェクト DEMO の次の CI 結果を報告して：ケース 1 は成功、ケース 2 は『timeout error』で失敗」	qase_ci_report
失敗したテストのトリアージ	「ラン #42 のログインタイムアウト失敗について、重大な欠陥を作成して」	qase_triage_defect
QQL による検索	「プロジェクト DEMO で過去 7 日間に失敗したテスト結果をすべて検索して」	qql_search

全リファレンスについては、ツールとdocs/tools.mdを参照してください。

クイックスタート

ホステッド版 Qase MCP を使う（推奨）

インストールも API トークンも不要です。Qase がホストするサーバーに接続し、Qase アカウントでサインインしてください。

注記： ホステッド版 Qase MCP はすべての有料プランで利用できます。Free プランまたは専用インスタンスをご利用の場合は、ご自身の API トークンを使ってサーバーを自分で実行してください。こちらはどの環境でも利用できます。

お使いのリージョンに合わせて URL を選んでください： メインクラウド（app.qase.io）では https://mcp.qase.io/mcp、EU クラスター（app-eu.qase.io）では https://mcp-eu.qase.io/mcp を使用します。以下の例はメインクラウドを使用しています。EU クラスターでは、EU の URL に置き換えるだけで、ほかは変更する必要はありません。

• Claude — Settings → Connectors を開き、Qase Test Management を探して、Connect をクリックします。（ディレクトリのコネクターはメインクラウド向けです。EU クラスターでは、https://mcp-eu.qase.io/mcp をカスタムコネクターとして追加してください。）
• Cursor — {"mcpServers": {"qase": {"url": "https://mcp.qase.io/mcp"}}} を .cursor/mcp.json に追加します。
• Codex — Settings → MCPs → Add server で URL https://mcp.qase.io/mcp を追加するか、CLI 用に ~/.codex/config.toml を設定します。
• VS Code — {"servers": {"qase": {"type": "http", "url": "https://mcp.qase.io/mcp"}}} を .vscode/mcp.json に追加するか、MCP: Add Server を実行します。

クライアントごとの詳しい手順、その他のクライアント、アクティブワークスペースの仕組みについては、docs/connect.md を参照してください。

サーバーを自分で実行する

パッケージをインストールし、ご自身の API トークンを指定してください。

npm install -g @qase/mcp-server
export QASE_API_TOKEN=your_api_token_here

次に、MCP クライアントの stdio 設定で @qase/mcp-server バイナリを指定します。インストール方法、クライアント設定（Claude Desktop、Cursor、Claude Code、Codex、OpenCode）、環境変数、トランスポート（stdio/SSE/streamable-HTTP）の詳細については、docs/self-run.md を参照してください。

このサーバーを基盤として構築する

インテグレーションの開発者向けです。サーバーを直接使う場合は、このセクションは関係ありません。

製品（プラグイン、エージェント、ラッパー CLI）からこのサーバーを利用する場合、どの AI ホストに接続しているかにかかわらず、利用状況を Qase の分析で識別できるよう、製品名を通知できます。

QASE_MCP_INTEGRATION=quality-supervisor/1.4.0   # <name>/<version>, version optional

名前は src/utils/integration-marker.ts の許可リストに登録されている必要があります。プルリクエストで追加してください。リストにない値や形式が不正な値は無視されますが、API 呼び出しは引き続き成功します。HTTP トランスポートでは、リクエストごとにマーカーを指定することもできます（X-Qase-Integration ヘッダーまたは ?integration=）。詳細については、docs/self-run.md を参照してください。

アップグレード

2.x から 3.0.0 へ： ツール名の変更も引数の変更もないため、プロンプトや自動化はそのまま動作します。変更されたのは基盤となるプロトコルです。サーバーは MCP 2026-07-28 を使用し、セッションはなくなり、最初のリクエストですべてのツールが一覧表示され、削除には 2 回のラウンドトリップが必要です。複数のレプリカをセルフホストする場合は、QASE_MCP_REQUEST_STATE_KEY が必要になりました。

v1 から v2 へ： v2 では、v1 の 83 個のツールがタスク指向のツール 29 個（探索ツールを含めて合計 30 個）に統合され、その後、現在の 40 個（合計 42 個）まで増えました。ツール名とレスポンスの形式が変更されています。

両方のアップグレードの詳細と、v1 から v2 へのツール対応表および変更前後の例については、docs/migration.md を参照してください。

ツール

6 つのグループに 42 個のツールがあります（タスク指向のツール 40 個と、メタツール 2 個：カタログを検索する qase_discover_tools と、ツールの完全なドキュメントを読む qase_tool_help）。すべてのツールは最初のリクエストから一覧表示されます。

グループ	数	説明
読み取り	2	タイプ／ID を指定して任意のエンティティを取得するか、1 回の呼び出しでプロジェクトのコンテキスト全体を初期化します
QQL	2	Qase Query Language を使用して、ケース、実行、結果、不具合、プランを横断検索します
書き込み	32	ケース（単独または一度に最大 100 件）、実行、結果、不具合、スイート、マイルストーン、プラン、共有ステップ、環境、添付ファイルを作成、更新、削除します。ケースと実行を Jira の課題にリンクし、テストケースレビューを提案して管理します
複合	3	1 回の呼び出しで複数ステップのワークフローを実行します：CI レポート、不具合のトリアージ、回帰テスト実行のセットアップ
代替手段	1	上記のツールでカバーされていない任意のエンドポイントに直接 REST API でアクセスします
メタ	2	qase_discover_tools — 実行したいことを指定してカタログを検索します。qase_tool_help — 必要に応じて、任意のツールの完全なドキュメントを参照します

パラメーターを含むツールごとの完全なリファレンス：docs/tools.md。

ドキュメント

• docs/connect.md — ホスト型 Qase MCP に接続します（Claude、Cursor、Codex、その他のクライアント）
• docs/self-run.md — サーバーを自分でインストールして実行します（設定、クライアント、トランスポート）
• docs/tools.md — ツール、グループ、ディスカバリーモデルの完全なリファレンス
• docs/troubleshooting.md — 認証、OAuth／コネクター、SSL に関する問題
• docs/migration.md — アップグレードガイド：2.x → 3.0.0、および v1 → v2 のツール対応表

コントリビューション

コントリビューションを歓迎します！開発環境のセットアップ、テスト、リンティングのガイドラインについては、CONTRIBUTING.md を参照してください。

ライセンス

MIT License — 詳細は LICENSE を参照してください。

サポート

• ドキュメント：https://docs.qase.io/en/articles/14984302-qase-mcp-server
• メール：[email protected]
• GitHub の課題：https://github.com/qase-tms/qase-mcp-server/issues

リンク

• Qase プラットフォーム：https://qase.io
• Qase ドキュメント：https://help.qase.io
• API ドキュメント：https://developers.qase.io
• MCP プロトコル：https://modelcontextprotocol.io
• 課題トラッカー：https://github.com/qase-tms/qase-mcp-server/issues