この記事では、mabl クラウド MCP サーバーで利用可能なすべてのツールのリファレンスを提供します。すべてのツールには認証が必要ですが、OAuth ログインフローを通じて自動的に処理されます。
| ツール | 説明 | 入力 | プロンプト例 |
|---|---|---|---|
analyze_failure |
テスト実行またはプラン実行が失敗した理由についてAIが生成した分析を取得します。テスト/プランIDではなく、実行ID（-jrまたは-prで終わるもの）が必要です。分析がまだ存在しない場合は、生成をトリガーします（10〜30秒かかる場合があります）。ワークスペースでgenerative_ai機能が有効になっている必要があります。 | 実行ID、テストまたはプラン、ワークスペースID | — |
assign_xray_to_mabl_test |
Xray テストケースを mabl テストに割り当てます。 | mabl テスト ID、Xray テストケース、Xray プロジェクト ID、ワークスペース ID オプション：上書き |
Xrayテストケース123をmablテスト456に割り当てる |
create_mabl_test_cloud |
ローカルブラウザを必要とせず、mablクラウド上で完全に実行される新しいブラウザテストまたはAPIテストを作成します。get_cloud_test_gen_statusでステータスをポーリングするためのセッションIDとインスタンスIDを返します。 | ワークスペースID、アプリケーションID、環境ID、URL、名前、インテント、およびAPIテストかどうか 省略可能：ステップとAPIスペック |
— |
get_applications |
ワークスペース内のすべてのアプリケーションを、関連する環境とURLとともに取得します。アプリケーションID、名前、および環境の詳細（ID、名前、URL）を返します。アプリケーションIDと環境IDは、run_mabl_test_cloudで必要です。 | ワークスペースID | — |
get_cloud_test_gen_status |
create_mabl_test_cloudによって開始されたクラウドテスト生成のステータスを確認します。現在のステータス、作成されたテストID（完了している場合）、および最新のモデルメッセージを返します。 | セッションID オプション：インスタンスID |
— |
get_credentials |
ワークスペースで利用可能なすべてのクレデンシャルを取得します。クレデンシャルID、名前、種類、およびcloud_onlyフラグを返します。クラウド専用のクレデンシャルは、ローカルのテスト実行では使用できません。クレデンシャルIDはrun_mabl_test_cloudではオプションです。 | ワークスペースID | — |
get_current_user_info |
現在認証されているユーザーに関する情報（userIdおよびデフォルトのワークスペースを含む）を取得します。認証後すぐにこのツールを呼び出して、userIdとdefaultWorkspaceIdを取得してください。これらは他の多くのツールで必要となります。 | none | — |
get_environments |
ワークスペース内のすべての環境（ステージング、本番環境など）を取得します。環境IDと名前を返します。環境IDはrun_mabl_test_cloudで必要です。 | ワークスペースID | — |
get_latest_authored_tests |
ワークスペース内で現在のユーザーが作成した最新のテストを取得します。名前、種類、ステップなどのテストの詳細を返します。結果はページネーションされます（デフォルト10件、最大100件）。 | ワークスペースIDとユーザーID 省略可能：制限 |
— |
get_latest_plan_runs |
プランIDを使用して、プランの最近の実行結果を取得します。プラン実行ID、ステータス、完了時刻、および失敗した実行のAI失敗分析を返します。プラン実行内の個々のテスト実行を確認するには、get_plan_run_resultを使用してください。 | プランIDとワークスペースID | — |
get_latest_test_runs |
テストIDを使用して、mablテストの最近の実行結果を取得します。テスト実行ID、ステータス、完了時刻、および失敗した実行のAI失敗分析を返します。特定の失敗した実行をより詳しく分析するには、analyze_failureを使用してください。 | テスト ID とワークスペース ID | — |
get_mabl_deployment |
コミットハッシュまたはデプロイメント ID を使用して mabl のデプロイメント結果を取得します。commitHash または deploymentId のいずれか一方のみを指定してください。両方は指定できません。デプロイメントイベント、プラン実行、および合否ステータスを含む個別のテスト実行を返します。失敗したテスト実行には、失敗の概要と分類が含まれます。テスト実行には、テストをローカルで再実行するために必要な環境、アプリケーション、クレデンシャル ID が含まれます。 | ワークスペースID オプション: コミットハッシュとデプロイメント ID |
— |
get_mabl_test_details |
テスト ID を指定して、単一の mabl テストの詳細を取得します。テスト名、説明、タイプ、タグ、ステップ、および設定を返します。特定のテストを確認する際は、get_mabl_tests の後にこれを使用してください。 | テストID | — |
get_mabl_tests |
自然言語クエリーを使用して mabl テストを検索します。テスト名、説明、タイプ、ステップの概要を返します。テストの内容（例：「ログインテスト」、「チェックアウトフロー」）でテストを検索する際に使用してください。特定のテストの詳細については、代わりに get_mabl_test_details を使用してください。 | クエリーとワークスペースID 省略可能：アプリケーションID |
— |
get_plan_run_result |
プラン実行 ID を指定して、特定のプラン実行の詳細な結果を取得します。プラン実行のステータスと、合否の結果、失敗の概要、クレデンシャルのコンテキストを含むすべての個別テスト実行を返します。get_latest_plan_runs から特定のプラン実行を詳しく調べる際に使用してください。 | プラン実行IDとワークスペースID | — |
get_plans |
ワークスペース内のテストプランを取得します。プラン ID、名前、説明、タイプ、タグ、および有効状態を返します。プラン ID は get_latest_plan_runs で必要です。結果はページネーションされます。返されたカーソルを使用して次のページを取得してください。 | ワークスペースID オプション: 上限とカーソル |
— |
get_workspace_test_run_summaries |
ワークスペース全体の最新テスト実行結果を取得します。「最新の結果を表示してください」や「ワークスペースに失敗はありますか？」など、最近のテストアクティビティの概要を確認したい場合にこのツールを使用してください。上限とカーソルによるページネーションをサポートしています。デフォルトでは、mabl が作成したデフォルトテストは除外されます。 | ワークスペース ID オプション: ステータス、テストタイプ、デフォルトテストの除外、上限、カーソル |
— |
get_workspaces |
現在のユーザーがアクセスできるすべてのワークスペースを取得します。ワークスペース ID と名前を返します。workspaceId はほとんどの他のツールで必要です。ユーザーがワークスペースを指定しない場合は、get_current_user_info の defaultWorkspaceId を使用してください。 | ユーザーID | — |
get_xray_test_cases |
特定の Xray プロジェクトの Xray テストケースを取得します。mabl テストにまだ割り当てられていないテストケースを返します。結果はページネーションされます。レスポンスに nextCursor が含まれている場合は、次のページを取得するためのフォローアップ呼び出しで cursor パラメータとして渡してください。 | ワークスペース ID 省略可能: xray プロジェクト ID、上限、カーソル、検索 |
— |
run_mabl_test_cloud |
mablテスト（ブラウザ、API、またはパフォーマンス）のクラウド実行をトリガーします。テストタイプはテスト自体によって決定されます。サポートされているすべてのタイプに同じパラメータが適用されます。モバイルテストはまだサポートされていません。個々のテスト実行リンクのリストを返します。 | テスト ID、ワークスペース ID、環境 ID、アプリケーション ID、およびブラウザー 省略可能：クレデンシャルID |
— |
IDの取得
多くの場合、プロンプトに含めることでAIエージェントからIDを直接取得できます。例：「'App - a11y tests'プランの最近のプラン実行を取得し、プラン実行IDも含めてください。」
特定のIDをmabl MCPから直接取得できない場合は、mablアプリ、CLI、APIから mabl リソースIDを取得する方法に関する記事をご覧ください。