この記事では、mabl クラウド MCP サーバーで利用可能なすべてのツールのリファレンスを提供します。すべてのツールには認証が必要ですが、OAuth ログインフローを通じて自動的に処理されます。
| ツール | 説明 | 入力 | プロンプト例 |
|---|---|---|---|
analyze_failure |
失敗したテスト実行またはプラン実行に対するmabl AIの失敗分析（概要、根本原因と次のステップのMarkdown、オプションのエビデンス詳細、タイミングメタデータ）を返します。 | 実行ID、テストまたはプラン、ワークスペースID オプション: include evidence |
— |
assign_xray_to_mabl_test |
Xray テストケースを mabl テストに割り当てます。 | mabl テスト ID、Xray テストケース、Xray プロジェクト ID、ワークスペース ID オプション：上書き |
Xrayテストケース123をmablテスト456に割り当てる |
create_application |
ワークスペースに新しいアプリケーションを作成し、URLを使用して環境にバインドします。 | ワークスペースID、名前、環境ID、URL、およびアプリケーションタイプ オプション: description |
— |
create_credentials |
ワークスペースに新しいログインクレデンシャルを作成します。 | ワークスペースID、名前、ユーザー名、およびパスワード オプション: descriptionおよびcloud only |
— |
create_data_table |
1行以上のデータを含むData Tableをワークスペースに作成します。 | ワークスペースID、名前、行 省略可能：説明 |
— |
create_environment |
ワークスペースに新しい環境を作成します。 | ワークスペースIDと名前 オプション: descriptionおよびpage load wait |
— |
edit_mabl_plan |
mablプランを編集します。実行ステージへのテストの追加や削除、またはプラン名と説明の更新ができます。 | プランIDと操作 | — |
get_applications |
ワークスペース内のアプリケーションを、関連する環境とURLとともに取得します。 | ワークスペースID オプション: 上限とカーソル |
— |
get_credentials |
ワークスペースで利用可能なクレデンシャルを取得します。 | ワークスペースID オプション: 上限とカーソル |
— |
get_current_user_info |
デフォルトのワークスペースを含む、現在認証されている呼び出し元に関する情報を取得します。 | none | — |
get_data_table |
IDを指定して単一のData Tableを取得します（すべての行を含む）。 | Data Table ID | — |
get_data_tables |
ワークスペース内のData Tableを取得します。 | ワークスペースID オプション: 上限とカーソル |
— |
get_deployment_status |
mablデプロイメントの現在の状態（実行中または終了状態）、テストメトリクス、およびこれまでに失敗したテスト実行のスナップショットを返します。 | ワークスペースID オプション: デプロイメントID、環境ID、アプリケーションID、revision、およびlookback ms |
— |
get_doc |
mablヘルプセンターの記事の全内容をMarkdown形式で取得します。 | article_id | — |
get_environments |
ステージングや本番環境など、ワークスペース内の環境を取得します。 | ワークスペースID オプション: 上限とカーソル |
— |
get_latest_authored_tests |
ワークスペース内の最新のテストを取得します。オプションで作成者によるフィルタリングが可能です。 | ワークスペース ID 省略可能：制限 |
— |
get_latest_plan_runs |
プランIDでプランの最近の実行結果を取得します。 | プランIDとワークスペースID オプション: 上限とカーソル |
— |
get_latest_test_runs |
テストIDで単一のmablテストの最近の実行結果を返します。 | テスト ID とワークスペース ID | — |
get_mabl_deployment |
コミットハッシュまたはデプロイメントIDでmablデプロイメントの結果を取得します。 | ワークスペース ID オプション: コミットハッシュ、デプロイメントID、および失敗のみ |
— |
get_mabl_plan |
IDで特定のmablプランの詳細を取得します。 | ワークスペースIDおよびプランID | — |
get_mabl_test_details |
テストIDで単一のmablテストの詳細をすべて取得します。 | ワークスペースIDとテストID オプション: include plans |
— |
get_mabl_tests |
自然言語クエリーを使用してmablテストを検索します。 | クエリーとワークスペースID オプション: アプリケーションIDと上限 |
— |
get_plan_run_result |
プラン実行IDで特定のプラン実行の詳細な結果を取得します。 | プラン実行IDとワークスペースID | — |
get_plans |
ワークスペース内のテストプランを取得します。 | ワークスペース ID オプション: 上限とカーソル |
— |
get_recent_deployments |
ワークスペース内の最近のmablデプロイメントエベントを検索します。オプションで単一の環境またはアプリケーション、あるいは時間ウィンドウに絞り込むことができます。 | ワークスペース ID オプション: 環境ID、アプリケーションID、開始時刻、limit、およびcursor |
— |
get_runtime_recovery_session |
失敗したテストステップを実行中に修復した、または修復しようとした実行時リカバリエージェントのセッションを返します。 | ワークスペース ID オプション: リカバリーセッションIDとテスト実行ID |
— |
get_test_quality_report |
一定期間にわたるmablのプロダクト内テスト品質メトリクスを取得します。 | ワークスペースID、開始時刻、および終了時刻 オプション: アプリケーションID、プランID、環境ID、テストID、最小プラン実行数、limit、およびcursor |
— |
get_test_run_artifact |
gs:// URIで参照されるmablテスト実行アーティファクトのコンテンツを取得します。 | ワークスペースIDおよびアーティファクトURI | — |
get_workspace_test_run_summaries |
ワークスペース全体で最近のmablテスト実行を検索します。ステータス、テストタイプ、およびページネーションによるオプションのフィルタリングが可能です。 | ワークスペース ID オプション: ステータス、テストタイプ、デフォルトテストの除外、上限、カーソル |
— |
get_workspaces |
現在の呼び出し元がアクセスできるすべてのワークスペースを取得します。 | none | — |
get_xray_test_cases |
特定のXrayプロジェクトのXrayテストケースを取得します。 | ワークスペース ID 省略可能: xray プロジェクト ID、上限、カーソル、検索 |
— |
identify_coverage_gaps |
mablカバレッジギャップエージェントを実行して、mablテストを要件と比較し、構造化されたカバレッジレポートを返します。 | ワークスペースIDおよびテストID オプション: 要件の説明およびJira課題ID |
— |
mabl_authoring_initiate |
新しいmablテストを作成するクラウドテストオーサリングセッションを開始します。 | ワークスペース ID 省略可能：テストタイプ、プランニングセッションID、テスト情報、プラン、APIスペック |
— |
mabl_authoring_initiate_local |
新しいブラウザまたはAPIテストをローカルのmablデスクトップトレーナーでオーサリングできるよう準備し、ユーザーがクリックして開くためのランチャーURLを返します。 | ワークスペース ID 省略可能：テストタイプ、プランニングセッションID、テスト情報、プラン、APIスペック |
— |
mabl_authoring_plan |
mabl AIプランニングエージェントとの会話形式のテストプランニングセッションを開始または継続します。 | ワークスペース ID 省略可能：intent、プランニングセッションID、リクエストされた変更内容 |
— |
mabl_authoring_status |
create_mabl_test_cloudによって開始されたクラウドテスト生成のステータスを確認します。 | ワークスペースIDとセッションID 省略可能：インスタンスIDおよびverbose |
— |
mabl_create_flow |
他のテストから利用できる、新しいスタンドアロンの再利用可能なmablフローを作成します。 | ワークスペースID、タイプ、説明 オプション：ステップ、クレデンシャルID、クレデンシャルなし、APIスペック |
— |
mabl_create_test |
新しいmablテストのエンベロープを作成します。任意で、ステップを含む最初の構造的フローも作成できます。 | ワークスペースID、アプリケーションID、環境ID、URL、名前、インテント、およびAPIテストかどうか 省略可能：URL、説明、クレデンシャルID、initial_flow、ブランチ、agent_session_id |
— |
mabl_find_tests_using_flow |
指定したフローを参照しているテストをページネーション形式で返します。 | flow_id 省略可能：ブランチ、limit、cursor |
— |
mabl_get_authoring_guide |
mabl_create_test / mabl_create_flow / mabl_save_flow_steps / mabl_save_test_stepsを通じて、mablテストを直接手動でオーサリングするためのリファレンス資料を取得します。 | uri | — |
mabl_get_flow_steps |
単一のmablフローを読み込み、現在のjson_steps配列と`reusable`フラグ（trueの場合、そのフローは複数のテストから参照されている）を返します。 | flow_id オプション：インスタンスID |
— |
mabl_get_schema_resource |
mabl-schema:// URIで指定されたmablテストモデルのレイヤーに対応するJSONスキーマを返します。 | uri 省略可能：ステップとAPIスペック |
— |
mabl_get_test_steps |
mablテストを読み込み、その中に含まれるすべてのフローを「structural」（再利用不可、このテストが所有）または「reusable」（複数のテストで共有）としてタグ付けして返します。 | test_id 省略可能：ブランチ |
— |
mabl_list_branches |
ワークスペース内のmablソース管理ブランチを一覧表示します。 | 省略可能：workspace_id、test_id、ステータス、limit、cursor | — |
mabl_result_analysis_chat |
テスト実行、プラン実行、またはデプロイメントイベントに対する対話型結果分析を開始または継続します。 | ワークスペース ID オプション：結果分析セッションID、エンティティ、ターゲットID、最初のユーザーメッセージ、メッセージ |
— |
mabl_save_flow_steps |
事前検証と三者間の永続性検証を行いながら、単一のmablフローへの編集内容を保存します。 | flow_id 省略可能：mode、ステップ、編集内容、ブランチ、acknowledge_shared、パラメータ、説明、agent_session_id |
— |
mabl_save_test_steps |
テストレベルで編集内容を保存します。これは、構造的（再利用不可）なフロー内に存在するステップの自然なオーサリング境界です。 | test_idおよびmode 省略可能：フロー、編集内容、ブランチ、agent_session_id |
— |
mabl_search_flows |
自然言語によるタスクの説明に対して、意味的な類似度でランク付けされたワークスペースのフローを返します。 | task_description ワークスペースID、アプリケーションID、環境ID、URL、名前、インテント、およびAPIテストかどうか |
— |
mabl_validate |
mablのjson_steps配列を検証し、構造上・意味上・ステップ間のエラーを教育的な提案とともに返します。 | ステップ 省略可能：テストタイプおよびstrict |
— |
run_mabl_plan |
既存のmablプランのクラウド実行をトリガーします。この1回の実行に対して、アドホックなオーバーライド（URL、ブランチ、ブラウザ、クレデンシャル）を任意で適用できます。 | プランIDとワークスペースID 省略可能：URLオーバーライド、API URLオーバーライド、ブランチ、ブラウザ、クレデンシャルID、HTTPAuthクレデンシャルID |
— |
run_mabl_test_cloud |
mablテスト（ブラウザ、API、またはパフォーマンス）のクラウド実行をトリガーします。 | テスト ID、ワークスペース ID、環境 ID、アプリケーション ID、およびブラウザー オプション: クレデンシャルIDとURLオーバーライド |
— |
run_mabl_test_local |
既存のmablテストをmablデスクトップアプリでローカル実行するためのリンクを返します。ユーザーはそのリンクをクリックして実行できます。 | テスト ID とワークスペース ID オプション：環境ID、クレデンシャルID、ブラウザ、URLオーバーライド、シナリオID、ヘッドレス、ブラウザを開いたままにする |
— |
search_docs |
mablヘルプセンターの記事を検索します。 | クエリー オプション: per_page |
— |
trigger_mabl_deployment |
mablのデプロイメントイベントをトリガーして一致するプランを実行するか、IDを指定して以前のデプロイメントを再トリガーします。 | 省略可能：デプロイメントID、ワークスペースID、アプリケーションID、環境ID、プランのラベル、リビジョン、ブランチ、プロパティ、デバッグ、URLオーバーライド、API URLオーバーライド、ブラウザ、クレデンシャルID、HTTPAuthクレデンシャルID | — |
IDの取得
多くの場合、プロンプトに含めることでAIエージェントからIDを直接取得できます。例：「'App - a11y tests'プランの最近のプラン実行を取得し、プラン実行IDも含めてください。」
特定のIDをmabl MCPから直接取得できない場合は、mablアプリ、CLI、APIから mabl リソースIDを取得する方法に関する記事をご覧ください。