mabl MCPツールとプロンプト – mablヘルプ

この記事では、利用可能なmabl MCPツールと、自然言語プロンプトで呼び出せるプロンプトを一覧で紹介します。

ツール

ツール	説明	プロンプト例
#analyze_failure*	入力: プラン実行IDまたはテスト実行ID テストやプランの実行が失敗した理由について、生成AIによる分析を返します。	「mabl MCPを使って、昨夜の『checkoutフロー』テストの失敗を分析してください。」
#assign_xray_to_mabl_test	入力: mablテストIDとXrayテストケースオプション入力: Xray プロジェクト ID (複数のプロジェクトがある場合は必須) mablテストとXrayテストケース間の関連付けを作成または更新します。事前にXray結果レポートの設定が必要です。	「Xray テストケース 'QA-159' を mabl テスト 'WkY5qe7Is3IOx3iGCK2Zbw-j' にリンクし、既存の割り当てを上書きします。」
#create_mabl_test*	入力：テスト名、プロンプト、およびベースURL 任意入力：アプリケーション、環境、API仕様（APIテストのみ）指定したプロンプトに従って、新しいブラウザーまたはAPIテストを作成します。	"このJiraチケット（TICKET-123）の詳細に基づいて、新しいmablブラウザーテストを作成してください。"
#create_mabl_test_from_plan*	入力: #plan_new_test ツールから生成されたアーティファクト提供されたテストプランに従って、mabl のブラウザーテストを作成します。	"「請求ページの読み込み」チェック用に生成されたプランを使って、mabl のテストを作成してください。"
#export_to_playwright	入力：テスト名またはID ローカルでの再生や CI のために、mabl のテストを Playwright のテストファイルにエクスポートします。	「mablテスト『App - User language - Dashboard』をPlaywrightにエクスポートできますか？」
#get_applications	mablアプリケーションの一覧表示と検索。	「『sandbox』アプリケーションに対してどのmablテストがありますか？」
#get_credentials	mablのクレデンシャルを一覧表示し、検索できます。#run-testと一緒に使うことで、使用したいクレデンシャルを指定できます。	「そのテストを 'staging_env' のクレデンシャルで実行できますか？」
#get_environments	mabl環境の一覧表示と検索。	「'QA'環境で非アクティブなプランは何ですか？」
#get_latest_authored_tests	現在のユーザーが最近作成したテストの一覧を取得します。	「最近作成したmablテストは何ですか？」
#get_latest_plan_runs	入力：プラン名またはID 最新の mabl プラン実行結果を取得します。合否サマリーと実行メタデータを含みます。	「過去24時間の『production deployment』プランの結果を要約してください。成功率と失敗率を表示し、テスト失敗の詳細も教えてください。」
#get_latest_test_runs	入力: テスト名またはID 特定のmablテストの最新結果を取得します。実行ID、ステータス、タイムスタンプ、エラーメッセージを含みます。	「『App - Clear filters』テストの結果を取得できますか？」
#get_mabl_deployment	入力: コミットハッシュまたはデプロイメントエベントID 最新のコミットに関連付けられたmablテスト実行の結果を取得できます。最新のコミットでテストが失敗したかどうかを確認するのに役立ちます。	「前回のmablデプロイメントで何が起こったのですか？」
#get_mabl_test_details	入力：テスト名またはID 特定のテストのメタデータとステップ定義を取得する	"「App - Clear filters」テストの詳細を取得します。"
#get_mabl_tests	現在のワークスペース内のテストを名前またはクエリーで検索し、一致するテストのメタデータを返します。アクションや目的に基づくセマンティック検索クエリーにも対応しています。	「このドロップダウンコンポーネントをカバーしているmablテストはありますか？」
#get_plan_run_result	入力: プラン実行ID 特定の mabl プラン実行の結果詳細をすべて取得します。	「プラン実行ID 12345-pr のテスト内訳を表示してください。」
#get_plans	すべてのmablプランを取得する。	「このワークスペースで現在有効になっているプランはどれですか？」
#get_workspaces	利用可能なワークスペースをすべて一覧表示し、現在のワークスペースを取得します。	「現在のmablワークスペースは何ですか？」
#get_xray_test_cases	オプション入力: Xray プロジェクト ID（複数の Xray プロジェクトがある場合は必須）、制限特定のプロジェクトのすべてのXrayテストケースを取得します。事前にXray結果レポートの設定が必要です。	「Xrayテストケースを取得して（上限10件）、ログイン機能のテストケースを見つけられるようにしてください。」
#plan_new_test*	入力: テスト要件要件に基づいて新しいブラウザーのテストのプランを立てます。プランは反復的に洗練できます。目標に合致したら、#create_mabl_test_from_plan ツールを使ってテストを作成してください。	"次のステップに基づいて、新しい mabl のテストをプランできますか：製品ページに移動し、「Add to Cart」をクリックして、カートの数量が増加することを確認する？"
#run_mabl_test_cloud	入力：テスト名またはID 任意入力：既定の構成を上書きするには、アプリケーション、環境、または URL を含めてください mabl クラウドでブラウザーまたは API の実行を開始し、アプリでテスト出力を確認できる URL を返します。	"Chrome と Firefox でステージング環境の「App - Settings - Address info」テストを実行してください。"
#run_mabl_test_local	入力: テスト名またはID オプション入力: 生成AIアサーションを有効にするには、 `allowLocalTestBilling: true`を含めてください。 mablのブラウザテストおよびAPIテストをローカルで実行する	「OK、最初のmablテストを自分のローカル環境で実行しましょう。」
#switch_workspace	入力: ワークスペース名またはID 別のmablワークスペースに切り替える。	「『project_alpha』ワークスペースに切り替えてもらえますか？」

※「高度なAI」アドオンでのみ利用できるツールを示します

MCPツールを呼び出すとき、コマンド名を正確に入力する必要はありません。やりたいことを自然な言葉で説明し、必要に応じて入力を行ってください。例えば：

ユーザー：「このドロップダウンコンポーネントを検証するmablテストはありますか？」

AI：#get-testsツールで一致するテストを取得します。

ユーザー：そのテストをローカルで実行できますか？URLはhttps://localhost:3000を使用してください。

AI：#run-testツールを使ってテストをローカルで実行します。

プロンプトに「mabl」を含めてください

AIクライアントが、テストの作成や実行など、mabl MCPと同様のタスクを行う他のツールやMCPと接続されている場合は、曖昧さを避けるためにプロンプト内で「mabl」を含めてください。例えば、「このプロンプトを使ってmablテストを作成してください…」のように記載します。

IDの取得

多くの場合、AIエージェントにプロンプトで依頼することでIDを直接取得できます。例えば、「最近のプラン実行結果をプラン『App - a11y tests』について取得し、プラン実行IDも含めてください。」のように依頼できます。

mabl MCPから特定のIDを直接取得できない場合は、mablリソースIDの取得方法に関する記事をご覧ください。mablアプリ、CLI、APIから取得する方法を紹介しています。

プロンプト

mabl MCP には、create_mabl_test_for_current_work というプロンプトも用意されています。これを使うと、現在の作業状況に基づいて新しいテストを作成できます。利用するには、AIクライアントのチャットに次の内容を入力してください：「/mcp.mcp-mabl.create_mabl_test_for_current_work」。

MCPツールの権限を管理する

さまざまなMCPツールを使い始めると、AIエージェントが各ツールの権限設定を促します。利用しているAIクライアントによって、権限には次のようなものが含まれる場合があります：

「一度だけ許可」
「このセッションで許可」
「常に許可」
「辞退/キャンセル」

mabl MCP を快適にご利用いただくために、ご自身のニーズやワークフローに合わせてこれらの権限を意図的に設定してください。#create_mabl_test や #run_mabl_test_cloud のように簡単に元に戻せない操作には、「一度だけ許可」や「このセッションで許可」など、より限定的な権限を付与することをおすすめします。閲覧専用の操作には、ボトルネックを減らすために「常に許可」を選択するとよいでしょう。

ツール

IDの取得

プロンプト

関連記事