MCP ツールリファレンス

aqua MCP サーバーは以下のツールを提供します。これらのツールにより、AI エージェントが QA プランをプログラム的に作成、管理、実行できます。

プラン管理

QA プランとそのバージョンを作成・管理するためのツールです。

ツール	説明
`create_qa_plan`	新しい QA プランを作成します。現在の git ブランチとプルリクエスト URL を自動検出します。
`get_qa_plan`	ID を指定してプランを取得します。最新バージョンの情報も含まれます。
`list_qa_plans`	ステータスフィルターとカーソルベースのページネーションを使用してプランを一覧表示します。
`update_qa_plan`	完全なシナリオとステップ構造を含む新しい不変バージョンを作成します。ステップには変数の値に基づく条件付き実行のための `condition` フィールドを指定できます。
`update_qa_plan_step`	単一ステップの部分更新を行います。新しいプランバージョンが作成されます。条件付き実行のための `condition` の設定をサポートしています。
`add_qa_plan_step`	シナリオにステップを追加します。新しいプランバージョンが作成されます。条件付き実行のための `condition` の設定をサポートしています。
`remove_qa_plan_step`	キーを指定してステップを削除します。新しいプランバージョンが作成されます。他のステップが依存している場合は失敗します。
`set_qa_plan_status`	プランのステータスを変更します：`draft`、`active`、または `archived`。

QA プランを実行し、結果を確認するためのツールです。

ツール	説明
`execute_qa_plan`	プラン全体を実行し、結果をサーバーに記録します。Markdown サマリーと実行 URL を返します。バックグラウンド実行用の `async` パラメータをサポートしています。
`run_scenario`	単一のインラインシナリオをサーバーに記録せずに実行します。詳細なデバッグ出力を返します。
`get_execution`	ステップごとの詳細を含む実行結果を取得します。
`list_executions`	プラン ID、バージョン、またはステータスでフィルターして実行一覧を取得します。
`get_execution_progress`	実行中のテストの進捗状況を取得します。`execute_qa_plan(async=true)` で開始した非同期実行のモニタリングに使用します。

実行時に使用される環境設定を管理するためのツールです。

ツール	説明
`create_environment`	`.aqua/environments/<name>.json` に環境ファイルを作成または上書きします。
`list_environments`	すべての環境設定をノートとともに一覧表示します。
`validate_environment`	環境ファイルのスキーマを検証し、シークレットが解決可能かどうかを確認します。

QA プランにコピーして使用できる再利用可能なシナリオテンプレートを管理するためのツールです。

ツール	説明
`create_common_scenario`	再利用可能なシナリオテンプレートを作成します。
`get_common_scenario`	ID を指定して共通シナリオを取得します。
`list_common_scenarios`	プロジェクト内のすべての共通シナリオを一覧表示します。
`update_common_scenario`	既存の共通シナリオを更新します。
`delete_common_scenario`	共通シナリオを削除します。既にコピー済みのプランには影響しません。

ブラウザ操作をキャプチャするためのツールです。

ツール	説明
`record_browser_actions`	インタラクティブなブラウザウィンドウを開き、ユーザー操作を記録します。記録された操作を `BrowserStep[]` 配列として返します。

アプリケーションを1アクションずつインタラクティブに調査するためのツールです。run_scenario とは異なり、探索セッションではアクション間でブラウザが維持されるため、セレクターの試行、レスポンスの確認、状態の段階的な構築が可能です。詳細はインタラクティブ探索ガイドを参照してください。

ツール	説明
`start_exploration`	インタラクティブな探索セッションを開始します。アクション間でブラウザが維持され、状態を段階的に構築できます。
`explore_action`	セッション内でアクション（ブラウザステップ、HTTP リクエスト、ブラウザアサーション）を実行し、即座にフィードバックを返します。
`end_exploration`	探索セッションを終了し、リソース（ブラウザプロセス、メモリ）をクリーンアップします。
`list_exploration_logs`	現在のプロジェクトの最近の探索セッションログを一覧表示します。
`get_exploration_log`	特定の探索セッションの完全なアクションログを取得します。成功したアクションのリプレイに利用できます。

プロジェクトレベルの永続的なナレッジを管理するためのツールです。

ツール	説明
`get_project_memory`	プロジェクトメモリを取得します。まだ保存されていない場合はスターターテンプレートを返します。
`save_project_memory`	プロジェクトメモリを保存します。既存の内容を完全に上書きします。

プロジェクトの準備状況を確認するためのツールです。

ツール	説明
`check_project_setup`	ローカル設定、プロジェクトメモリ、環境、共通シナリオの状態を一括でチェックします。