この記事では、mabl クラウド MCP サーバーで利用可能なすべてのツールのリファレンスを提供します。すべてのツールには認証が必要ですが、OAuth ログインフローを通じて自動的に処理されます。
| ツール | 説明 | 入力 | プロンプト例 |
|---|---|---|---|
| analyze_mabl_failure | 失敗したテスト実行またはプラン実行に対するmabl AIの失敗分析（概要、根本原因と次のステップのMarkdown、オプションのエビデンス詳細、タイミングメタデータ）を返します。 | 実行ID、テストまたはプラン、ワークスペースID オプション: include evidence |
— |
| analyze_mabl_results | テスト実行、プラン実行、またはデプロイメントイベントに対する対話型の結果分析を開始または継続します。 | ワークスペースID オプション: 結果分析セッションID、エンティティ、ターゲットID、最初のユーザーメッセージ、メッセージ |
— |
| assign_xray_to_mabl_plan | Xrayテストプランをmablプランに割り当てます。 | mablプランID、Xrayテストプラン、XrayプロジェクトID、ワークスペースID オプション: 上書き |
— |
| assign_xray_to_mabl_test | Xrayテストケースをmablテストに割り当てます。 | mablテストID、Xrayテストケース、XrayプロジェクトID、ワークスペースID オプション: 上書き |
Xrayテストケース123をmablテスト456に割り当てる |
| check_release_readiness | 一連のmablテスト、プラン、デプロイメントに対するリリース準備状況レポートを生成します。 | ワークスペースIDとエンティティID オプション: リリースコンテキスト |
— |
| compare_mabl_flow_versions | 2つのmablフロー、または同じフローの2つのバージョンのステップを、ステップ単位で差分比較します。これはWebアプリに表示される差分と同じものです。 | source_flow_idとtarget_flow_id オプション: ブランチ |
— |
| compare_mabl_test_versions | 2つのmablテスト、または同じテストの2つのバージョンのステップを、ステップ単位で差分比較します。これはWebアプリの比較タブに表示される差分と同じものです。 | source_test_idとtarget_test_id オプション: ブランチ |
— |
| create_mabl_application | ワークスペースに新しいアプリケーションを作成し、URLを使用して環境にバインドします。 | ワークスペースID、名前、環境ID、URL、アプリケーションタイプ オプション: description |
— |
| create_mabl_credentials | ワークスペースに新しいログインクレデンシャルを作成します。 | ワークスペースID、名前、ユーザー名、パスワード オプション: descriptionおよびcloud only |
— |
| create_mabl_data_table | 1行以上のデータを含むData Tableをワークスペースに作成します。 | ワークスペースID、名前、行 オプション: description |
— |
| create_mabl_environment | ワークスペースに新しい環境を作成します。 | ワークスペースIDと名前 オプション: descriptionおよびpage load wait |
— |
| create_mabl_plan | 環境内のアプリケーションに対して一連のテストを実行する新しいmablプランを作成します。 | ワークスペースID、名前、アプリケーションID、環境ID、テストID オプション: concurrency、description、クレデンシャルID、HTTPAuthクレデンシャルID |
— |
| edit_mabl_plan | mablプランを編集します。実行ステージへのテストの追加や削除、プランラベルの追加や削除、プラン名と説明の更新、プランの有効化／無効化、またはログインおよびHTTP認証クレデンシャルの添付ができます。 | プランIDと操作 | — |
| edit_mabl_test | mablテストのメタデータを編集します。名前の変更、説明の変更、ラベルの追加や削除、またはテストの有効化／無効化ができます。 | テストIDと操作 | — |
| get_current_user | デフォルトのワークスペースを含む、現在認証されている呼び出し元に関する情報を取得します。 | none | — |
| get_failure_category_report | 一定の期間にわたって分類された失敗件数を、レポート用の集計として返します。 | ワークスペースID オプション: スコープ、履歴日数、開始時刻ms、終了時刻ms、環境ID、アプリケーションID、テスト名、テストラベル、タイムゾーン |
— |
| get_mabl_data_table | IDを指定して単一のData Tableを取得します（すべての行を含む）。 | Data Table ID | — |
| get_mabl_deployment | コミットハッシュまたはデプロイメントIDでmablデプロイメントの結果を取得します。 | ワークスペースID オプション: コミットハッシュ、デプロイメントID、失敗のみ |
— |
| get_mabl_deployment_status | mablデプロイメントの現在の状態（実行中または終了状態）、テストメトリクス、およびこれまでに失敗したテスト実行のスナップショットを返します。 | ワークスペースID オプション: デプロイメントID、環境ID、アプリケーションID、revision、lookback ms |
— |
| get_mabl_doc | mablヘルプセンターの記事の全内容をMarkdown形式で取得します。 | article_id | — |
| get_mabl_plan | IDで特定のmablプランの詳細を取得します。 | ワークスペースIDとプランID | — |
| get_mabl_plan_run | プラン実行ID（-pr）で特定のプラン実行の詳細な結果を返します。 | プラン実行IDとワークスペースID | — |
| get_mabl_test | テストIDで単一のmablテストの詳細をすべて取得します。 | ワークスペースIDとテストID オプション: include plans |
— |
| get_mabl_test_run | 単一のmablテスト実行の現在のステータスと結果を返します。 | テスト実行IDとワークスペースID | — |
| get_mabl_test_run_artifact | gs:// URIで参照されるmablテスト実行アーティファクトのコンテンツを取得します。 | ワークスペースIDとアーティファクトURI | — |
| get_mabl_test_run_failure_reason | 単一のテスト実行に割り当てられた構造化された失敗分類（カテゴリーID、概要テキスト、推奨カテゴリー、手動と自動のどちらで割り当てられたか）を返します。 | ワークスペースIDとテスト実行ID | — |
| get_mabl_test_steps | mablテストを読み込み、その中に含まれるすべてのフローを「structural」（再利用不可、このテストが所有）または「reusable」（複数のテストで共有）としてタグ付けして返します。 | test_id オプション: ブランチ |
— |
| get_runtime_recovery_session | 失敗したテストステップを実行中に修復した、または修復しようとした実行時リカバリエージェントのセッションを返します。 | ワークスペースID オプション: リカバリーセッションIDとテスト実行ID |
— |
| get_test_quality_report | 一定期間にわたるmablのプロダクト内テスト品質メトリクスを取得します。 | ワークスペースID、開始時刻、終了時刻 オプション: アプリケーションID、プランID、環境ID、テストID、最小プラン実行数、limit、cursor |
— |
| get_workspace_value_report | 日付範囲内のワークスペースにおけるmabl AI/自動化アクティビティの実測値。 | ワークスペースID オプション: 開始日、終了日、メトリクス名 |
— |
| identify_coverage_gaps | mablカバレッジギャップエージェントを実行して、mablテストを要件と比較し、構造化されたカバレッジレポートを返します。 | ワークスペースIDとテストID オプション: 要件の説明、Jira課題ID |
— |
| list_authoring_sessions | mablテストを作成または編集したテストオーサリングエージェント（TAA）のセッションを、テストIDおよび／またはセッションが作業したmablブランチでフィルタリングして返します。 | ワークスペースID オプション: テストID、ブランチID、上限、カーソル |
— |
| list_mabl_applications | ワークスペース内のアプリケーションを、関連する環境とURLとともに取得します。 | ワークスペースID オプション: 上限とカーソル |
— |
| list_mabl_authored_tests | ワークスペース内の最新のテストを新しい順に取得します。オプションでテストタイプと作成者によるフィルタリングが可能です。 | ワークスペースID オプション: テストタイプ、作成者ID、上限 |
— |
| list_mabl_credentials | ワークスペースで利用可能なクレデンシャルを取得します。 | ワークスペースID オプション: 上限とカーソル |
— |
| list_mabl_data_tables | ワークスペース内のData Tableを取得します。 | ワークスペースID オプション: 上限とカーソル |
— |
| list_mabl_deployment_events | ワークスペース内の最近のmablデプロイメントイベントを検索します。オプションで単一の環境またはアプリケーション、あるいは時間ウィンドウに絞り込むことができます。 | ワークスペースID オプション: 環境ID、アプリケーションID、ブランチ名、ラベル、リポジトリ、開始時刻、上限、サマリーのみ、カーソル |
— |
| list_mabl_environments | ステージングや本番環境など、ワークスペース内の環境を取得します。 | ワークスペースID オプション: 上限とカーソル |
— |
| list_mabl_failure_reasons | ワークスペースの失敗理由の定義（mablのデフォルトカテゴリーと任意のカスタム理由）を一覧表示します。 | ワークスペースID オプション: include disabled |
— |
| list_mabl_flow_versions | mablフローのすべてのバージョンを、新しい順に、ブランチ、作成時刻、変更内容とともに一覧表示します。 | フローID オプション: ブランチ |
— |
| list_mabl_plan_runs | プランIDでプランの最近の実行結果を取得します。 | プランIDとワークスペースID オプション: 上限とカーソル |
— |
| list_mabl_plans | ワークスペース内のテストプランを取得します。 | ワークスペースID オプション: 上限とカーソル |
— |
| list_mabl_test_run_summaries | ワークスペース全体で最近のmablテスト実行を検索します。ステータス、テストタイプ、失敗カテゴリー、およびページネーションによるオプションのフィルタリングが可能です。 | ワークスペースID オプション: ステータス、テストタイプ、ラベル、テストID、失敗カテゴリーID、開始時刻ms、終了時刻ms、デフォルトテストの除外、上限、カーソル |
— |
| list_mabl_test_runs | テストIDで単一のmablテストの最近の実行結果を返します。 | テストIDとワークスペースID オプション: 上限、ステータス、since ms、include analysis |
— |
| list_mabl_test_versions | mablテストのすべてのバージョンを、新しい順に、ブランチ、作成時刻、変更内容とともに一覧表示します。 | テストID オプション: ブランチ |
— |
| list_mabl_tests | ラベル、作成者、タイプ、ブランチなどの正確なメタデータフィルターでmablテストを取得します。 | ワークスペースID オプション: ラベル、除外ラベル、ブランチ、ブランチの変更のみ、作成者ID、アプリケーションID、テストタイプ、上限 |
— |
| list_mabl_users | mablユーザーIDのバッチを、名前とメールアドレスに解決します。 | ワークスペースIDとユーザーID | — |
| list_mabl_workspaces | 現在の呼び出し元がアクセスできるすべてのワークスペースを取得します。 | none | — |
| list_xray_test_cases | 特定のXrayプロジェクトのXrayテストケースを取得します。 | ワークスペースID オプション: XrayプロジェクトID、上限、カーソル、検索 |
— |
| list_xray_test_plans | 特定のXrayプロジェクトのXrayテストプランを取得します。 | ワークスペースID オプション: XrayプロジェクトID、上限、カーソル、検索 |
— |
| mabl_authoring_answer | 一時停止中のクラウドテストオーサリングセッションで保留中の質問に回答し、1回の同期呼び出しでセッションを再開します。 | セッションID、テキスト、期待されるループ番号 | — |
| mabl_authoring_initiate | 新しいmablテストを作成するクラウドテストオーサリングセッションを開始します。 | ワークスペースID オプション: テストタイプ、プランニングセッションID、テスト情報、プラン、APIスペック |
— |
| mabl_authoring_initiate_local | テストプランがあらかじめ読み込まれたmablデスクトップトレーナーを開く、ローカルテストオーサリングセッションを開始します。 | ワークスペースID オプション: テストタイプ、プランニングセッションID、テスト情報、プラン、APIスペック |
— |
| mabl_authoring_list | ワークスペース内のクラウドテストオーサリングセッションを一覧表示します。デフォルトでは、一時停止して回答待ちのセッションを表示します。 | オプション: ステータス、上限、カーソル | — |
| mabl_authoring_plan | mabl AIプランニングエージェントとの会話形式のテストプランニングセッションを開始または継続します。 | ワークスペースID オプション: intent、プランニングセッションID、リクエストされた変更内容 |
— |
| mabl_authoring_status | クラウドテストオーサリングセッションのステータスを確認します。回答待ちで一時停止している場合は、保留中の質問も含めて返します。 | セッションID オプション: ワークスペースID、インスタンスID、verbose |
— |
| rerun_mabl_plan | 以前に実行されたmablプラン実行を再実行し、元と同じ構成で新しいプラン実行を作成します。 | プラン実行IDとワークスペースID オプション: scope |
— |
| rerun_mabl_test | 以前に実行されたmablテスト実行を再実行し、元の実行と同じ構成を使用して新しいアドホックテスト実行を作成します。 | テスト実行IDとワークスペースID | — |
| restore_mabl_test | mablテストを以前のバージョンに復元し、選択したバージョンと内容が一致する新しい最新バージョンを作成します。 | テストIDとバージョン | — |
| 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_mabl_docs | mablヘルプセンターの記事を検索します。 | クエリー オプション: per_page |
— |
| search_mabl_tests | mablテストが何を行うかに基づいて、自然言語クエリーを使用して検索します。 | クエリーとワークスペースID オプション: アプリケーションIDと上限 |
— |
| 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を取得する方法に関する記事をご覧ください。