注意
バージョン1.69.0のアップデートに伴い、MCPサーバーを刷新しました。このため、これまでのMCPサーバーを利用中のお客様も切り替え作業が必要となります。以下のセットアップ手順を参考にご設定ください。
目次
概要
MagicPod MCPサーバーは、AIエージェント（Cline、Cursor、Claudeなど）からMagicPodの各種機能を操作するためのモジュールです。これを導入することで、AIエージェントに対して自然言語で指示を出し、MagicPodの操作を自動化できます。
MagicPod MCPサーバーでは、主に以下の操作を行うことができます。
- テストケースの作成・編集・参照・実行
- 共有ステップの作成・編集・参照
- テスト実行結果の取得
- UI情報の取得やロケータの検証
- MagicPodヘルプセンターの記事検索
テストケースの作成・編集にあたっては、Excelなどのファイルを読み込ませ、その内容に応じた指示を行うことも可能です。このため、次のようなワークフローを作成できます。
- Excelなどで作成したテスト手順書をAIに読み込ませ、必要なテストケースを作成する
- 新機能の仕様書をAIに読み込ませ、影響を受けるテストケースを修正する
- テストの失敗をもとに原因を分析し、必要に応じてテストケースを修正する
MagicPod MCPサーバーで実現できる具体的な利用例については、プロンプト集 もあわせてご覧ください。
そのほか呼び出せる操作（ツール）の一覧はこちらに記載しております。
| ツール名 | 用途 |
capture_ui |
デバイスの現在のUIをキャプチャする |
create_shared_step |
現在のテストケース内の連続したステップ範囲から共有ステップを作成する |
delete_ui |
未使用のUIを削除する |
edit_data_pattern |
現在のテストケースのデータパターン(データ駆動テストの値)を編集する |
edit_shared_step_parameter |
現在の共有ステップが持つパラメータの追加・削除を行う |
edit_shared_step_steps |
共有ステップ内のテストステップを編集する |
edit_steps |
現在のテストケースのテストステップを編集する |
edit_ui_elements |
保存済みUI上のUI要素のプロパティ(名前・ロケーター)を編集する |
execute_batch_run |
バッチ実行を新規開始、または再実行する |
execute_partial_steps |
開始・終了ステップを指定して部分的なテスト実行を行う |
find_help_center_article |
MagicPodヘルプセンターの記事を検索・閲覧する |
get_command_definition |
1つ以上のMagicPodコマンドの詳細な定義を取得する |
get_health_score |
プロジェクトのヘルススコアを取得する |
get_shared_step |
単一の共有ステップの詳細(人が読める形式のステップを含む)を取得する |
get_shared_step_internal_steps |
共有ステップ定義内のテストステップを取得する |
get_test_case_detail |
単一のテストケースの詳細(人が読める形式のステップを含む)を取得する |
get_test_run |
1件のテスト実行に関する情報・成果物を取得する |
inspect_locators |
画面の安定したロケーターを提案する、または既存のものを検証する |
inspect_ui |
既にキャプチャ済みのUI(画面)を取得・検索する |
list_batch_run_test_runs |
バッチ実行内の全テスト実行をテストパターンごとにグループ化して一覧表示する |
list_batch_runs |
プロジェクトのバッチ実行を新しい順に一覧表示する |
list_fixture_images |
プロジェクトのフィクスチャ画像を一覧表示する |
list_organizations |
アクセス可能な組織を一覧表示する |
list_projects |
組織内でアクセス可能なプロジェクトを一覧表示する |
list_shared_steps |
プロジェクトの共有ステップと共有ステップフォルダを一覧表示する |
list_test_cases |
プロジェクトのテストケースとテストケースフォルダを一覧表示する |
list_test_runs |
テストケースのテスト実行を実行番号の降順(新しい順)で一覧表示する |
list_test_settings |
プロジェクトのテスト設定をテスト設定パターンとあわせて一覧表示する |
manage_device |
指定したセッション用のデバイスを起動・終了する |
manage_shared_steps |
共有ステップとそのフォルダを管理する(フォルダの作成・リネーム・削除・並べ替え、共有ステップの移動、名前・説明の編集、ゴミ箱への移動) |
manage_test_cases |
テストケースの作成、テストケースの名前・説明・開始モード（起動モード）の変更、テストケースフォルダの作成・リネーム・削除を行う |
read_shared_step |
現在の共有ステップのステップとパラメータ定義を読み込む |
read_test_case |
現在のテストケースのデータを読み込む |
reorder_test_case |
テストケースとフォルダの並び順を変更する(1件ずつの移動、または一括並べ替え) |
search_shared_steps |
共有ステップを名前・説明・フォルダ名から検索する |
start_session |
指定したテストケース用のMagicPodセッションを開始する |
start_shared_step_session |
指定した共有ステップの編集用にMagicPodセッションを開始する |
upload_fixture_image |
画像をMagicPodのフィクスチャとしてアップロードする |
今後の拡張予定：自動修復の高度化など機能拡充を予定しています。参考: プレスリリース
セットアップ手順
OAuth認証またはAPIトークンを用いて設定いただけます。
AIサービスごとの詳細なセットアップ手順はこちらのページをご参照ください。
Q&A
Q. ローカルPC環境でのテストにも利用できますか？
はい。MagicPod MCPサーバーは、クラウド環境とローカルPC環境のどちらのテストにも利用できます。
Q. MagicPod MCPサーバーを使ってテストケースを作成・編集する際に、MagicPodのAIクレジットは消費されますか？
いいえ。MagicPod MCPサーバーを利用したテストケースの作成・編集では、MagicPodのAIクレジットは消費されません。
AIによる処理には、MagicPod MCPサーバーに接続しているAIエージェント側のAIトークンが使用されます。そのため、利用可能な量や料金などについては、ご利用のAIエージェントや契約プランをご確認ください。
Q. MagicPod MCPサーバーはどのプランで利用できますか？
MagicPod MCPサーバーは、MagicPodのすべてのプランで利用できます。
セキュリティについて
- お客様の情報が機械学習に使用されることはありません。
- APIトークンをMCPサーバーのconfigファイルに記載した場合でも、AIエージェントに情報は渡らない作りとなっています。
- 今後機能を拡充していく予定ですが、引き続きセキュリティ面を考慮した構成とします。