メインコンテンツへスキップ

MagicPod MCPサーバー（ベータ版）

  • 更新

MagicPod MCPサーバーは、AIエージェント（Cline、Cursor、Claudeなど）からMagicPodの各種機能を操作するためのモジュールです。​これを導入することで、AIエージェントに対して自然言語で指示を出し、MagicPodの操作を自動化できます。

Screenshot 2025-04-25 at 17.50.25.png

2025年4月現在できることは主に次の3つです。

  • MagicPodのWeb APIを経由して、テストを実行する
  • MagicPodのWeb APIを経由して、テストの実行情報(統計情報など)を取得する
  • MagicPodのヘルプページを参考にして、使い方やエラーやトラブルの解決策を提案する

今後は自然言語でのテストケースの作成や自動修復の高度化など機能拡充を予定しています。参考: プレスリリース

目次

  1. セットアップ手順
    1. Claude Desktop
    2. Cursor
  2. プロンプト例
    1. 使い方確認・トラブルシューティング
    2. テストを実行する
    3. テスト実行結果を調査する
    4. その他
  3. トラブルシューティング
  4. セキュリティについて

 

セットアップ手順

ここではClaude Desktop、CursorでMagicPod MCPサーバーをツールとして組み込む方法を説明します。MacOS、Windowsともに同手順でセットアップ可能です。

 

Claude Desktop

1. Claude Desktopをインストールする

こちらからClaude Desktopをダウンロードし、PCにインストールしてください。

 

2. npxをインストールする

npxとはNode.js v8.2.0以降に標準で付属しているツールです。MCPサーバーの利用にはこのnpxが必要となります。

このコマンドをコマンドラインツールで実行した際にバージョン番号が表示されれば既にnpxがインストール済みなので次のステップに進んでください。

npx -v

npxがインストールされていない場合は、最新版のNode.jsをこちらからインストールしてください。

 

3. MagicPod MCPサーバーをセットアップする

claude_desktop_config.json というファイルを開き(無い場合は新規作成してください)、以下のように記述してください。

MacOSの場合のパス：~/Library/Application Support/Claude/claude_desktop_config.json

Windowsの場合のパス：%APPDATA%\Claude\claude_desktop_config.json

 

「YOUR-API-TOKEN」と記載されている部分はシステム連携ページでAPIトークンをコピーし、書き換えてください。

MacOSの場合:

{
  "mcpServers": {
    "magicpod-mcp-server": {
      "command": "npx",
      "args": ["-y", "magicpod-mcp-server", "--api-token=YOUR-API-TOKEN"]
    }
  }
}

Windowsの場合:

{
  "mcpServers": {
    "magicpod-mcp-server": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "magicpod-mcp-server", "--api-token=YOUR-API-TOKEN"]
    }
  }
}

 

その後、Claude Desktopを再起動し、画像のようにインストールされたMCPツールの数を確認できれば成功です。

1744959743-iOnYzTF6C2KMd8L4SGh5Aq7x.webp

 

Cursor

1. Cursorをインストールする

こちらからCursorをダウンロードし、PCにインストールしてください。

 

2. npxをインストールする

npxとはNode.js v8.2.0以降に標準で付属しているコマンドラインツールです。MCPサーバーの利用にはこのnpxが必要となります。

このコマンドをコマンドラインツールで実行した際にバージョン番号が表示されれば既にインストール済みなので次のステップに進んでください。

npx -v

npxがインストールされていない場合は、最新版のNode.jsをこちらからインストールしてください。

 

3. MagicPod MCPサーバーをセットアップする

Cursor Settingsを開きます。(Windowsの場合は歯車のアイコンから開けます)

Screenshot 2025-04-25 at 20.23.16.png

「MCP」 > 「Add new global MCP server」をクリックします。

Screenshot 2025-04-25 at 20.24.01.png

mcp.jsonファイルに以下のように記述して保存してください。

「YOUR-API-TOKEN」と記載されている部分はシステム連携ページでAPIトークンをコピーし、書き換えてください。

MacOSの場合:

{
  "mcpServers": {
    "magicpod-mcp-server": {
      "command": "npx",
      "args": ["-y", "magicpod-mcp-server", "--api-token=YOUR-API-TOKEN"]
    }
  }
}

Windowsの場合:

{
  "mcpServers": {
    "magicpod-mcp-server": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "magicpod-mcp-server", "--api-token=YOUR-API-TOKEN"]
    }
  }
}

 

MCP Serversの設定画面にて以下の画像にようにmagicpod-mcp-serverが表示されていれば成功です。AIチャットエリアで質問した際にMagicPod MCPサーバーを経由し、MagicPodの操作を自動化出来るようになります。

Screenshot 2025-04-25 at 20.27.53.png

 

プロンプト例

使い方確認・トラブルシューティング

MagicPodでクリックコマンドが失敗したときの対処法を教えてください。
MagicPodの画像差分で特定の領域をチェック対象から除外する方法を教えてください。

 

テストを実行する

MagicPodで、"〇〇" 組織の "〇〇" プロジェクトにおいて、前回の一括実行で失敗したテストケースのみを再実行してください。
再実行時には、失敗したテストケースの番号を明示的に指定して、成功したケースはスキップしてください。
MagicPodで、"〇〇" 組織の "〇〇" プロジェクトにおいて、ファイル操作に関連するテストケースのみを番号で指定し、一括実行してください。
使用するブラウザは Chrome としてください。

 

テスト実行結果を調査する

失敗したテスト結果のURL一覧を取得:

MagicPodで、"〇〇" 組織の "〇〇" プロジェクトのテストケース "〇〇" で失敗したテスト実行結果のURL一覧をください。

GitHubのコミットログを元にしたテスト失敗理由の調査(GitHub MCPサーバーのインストールが必要です):

以下のテストの失敗について調査してください。
https://app.magicpod.com/OrganziationName/ProjectName/batch-run/XXX/pattern-index/X/XXX/
このテストの実行ログを参照し、失敗の原因となったであろうコードの変更を〇月〇日の <GitHub組織名>/<GitHubプロジェクト名> リポジトリにおけるコミットログから特定してください。

テスト実行結果分析:

MagicPodで、"〇〇" 組織の "〇〇" プロジェクトにおいて、
過去7日以内に実行された一括実行結果をもとに、テスト設定ごとの結果をCSV形式で整理し、出力してください。

 

その他

MagicPodの "〇〇" 組織の "〇〇" プロジェクトのヘルススコアを教えて下さい。
MagicPodで、"〇〇" 組織の "〇〇" プロジェクトにおいて、以下の条件をすべて満たす.appファイルを削除したいです：
- 最終アップロード日時が3ヶ月以上前である
- 同じファイル名のより新しいバージョンがすでに存在している
まずは削除対象となるファイルの一覧を抽出して提示してください。
内容を確認したうえで、私が「承認」と返信したら、削除処理を実行してください。

 

トラブルシューティング

回答生成中にエラーが表示される

例えばClaudeの無料版を使用している場合、「Claudeの応答が中断されました。」というエラーが回答生成中に表示されることがあります。これは無料版での文字数制限に起因するため、有償版のClaude Proを利用することで回避することができます。他のAIエージェントについても同様の問題が生じる可能性があるため、有償プランの契約を検討してください。

 

セキュリティについて

MagicPod MCPサーバーは現状AIエージェントとMagicPodサービス(MagicPod Web APIとヘルプセンター)を繋ぐ非常にシンプルな構成のモジュールです。リポジトリはGitHubにて公開しています。

  • お客様の情報が機械学習に使用されることはなく、入力されたプロンプト情報を当社が保持することはありません。
  • Web APIのトークンについてMCPサーバーのconfigファイルに記載する必要がありますが、AIエージェントに情報は渡らない作りとなっています。
  • 今後機能を拡充していく予定ですが、引き続きセキュリティ面を考慮した構成とします。

関連記事