MagicPod MCP Server

Note
With the release of MagicPod version 1.69.0, the MCP server has been redesigned. As a result, existing users of the previous MCP server must update their configuration. Please follow the setup instructions below to migrate to the new MCP server.

MagicPod MCP Server is a module that enables AI agents (Cline, Cursor, Claude, etc.) to operate various MagicPod functions. By implementing this, you can automate MagicPod operations by giving instructions to AI agents in natural language.

Table of contents

1. Overview
2. Setup Instructions
   1. Claude Desktop
   2. Cursor
   3. Visual Studio Code
3. Prompt Examples
   1. Usage confirmation & troubleshooting
   2. Run tests
   3. Investigate test run results
   4. Create a test case
   5. Edit a test case
   6. Identifying Unstable Locators
   7. Other
4. Troubleshooting
5. Security

Overview

There are four main capabilities:

• Execute tests via MagicPod Web API
• Retrieve test execution information (statistics, etc.) via MagicPod Web API
• Suggest solutions for usage, errors, and troubleshooting by referencing MagicPod help pages
• Create and edit test cases in natural language via MagicPod Autopilot

Limitations: Test creation, editing, and execution are only supported in cloud environments. Local PC environments are not supported.
Future expansion plans: We plan to expand functionality in the future, including enhanced automatic repair. Reference: Press Release(Japanese)

Setup Instructions

Prerequisites

To use the MagicPod MCP Server, you need:

• A MagicPod account with API access enabled
• A MagicPod API token
• Node.js (only for AI clients that use npx)

Since the MagicPod MCP Server runs on MagicPod's infrastructure, your AI client connects directly to it. No additional software installation is required.

Connect Your AI Client

Claude Desktop

1. Open Settings > Developer > Edit Config.

2. Add the following configuration under "mcpServers". If "mcpServers" does not already exist, create it.

   {
     "mcpServers": {
       "magicpod": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://app.magicpod.com/mcp",
           "--header",
           "Authorization:Bearer YOUR_API_TOKEN"
         ]
       }
     }
   }

3. Save the file and restart Claude Desktop.

Claude Code

Run the following command in your terminal:

claude mcp add --transport http magicpod https://app.magicpod.com/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Copilot CLI

Run the following command in your terminal:

copilot mcp add --transport http magicpod https://app.magicpod.com/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Codex

1. First, set your MagicPod API token as an environment variable.

   export MAGICPOD_API_TOKEN=YOUR_API_TOKEN

2. Then run the following command in your terminal:

   codex mcp add magicpod --url https://app.magicpod.com/mcp --bearer-token-env-var MAGICPOD_API_TOKEN

To keep the environment variable across terminal sessions, add the export command to your shell profile (for example, ~/.zshrc or ~/.bashrc).

Cursor

1. Open the Cursor MCP configuration file.
   • For all projects: ~/.cursor/mcp.json
   • For a specific project only: <project-root>/.cursor/mcp.json

2. Add the following configuration under "mcpServers":

   {
     "mcpServers": {
       "magicpod": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://app.magicpod.com/mcp",
           "--header",
           "Authorization:Bearer YOUR_API_TOKEN"
         ]
       }
     }
   }

3. Restart Cursor.

Gemini — Antigravity IDE / Antigravity 2.0

Note

The browser version of Gemini and Gemini CLI do not support remote MCP servers. To use the MagicPod MCP Server with Gemini, use Antigravity IDE or Antigravity 2.0.

1. Open: Settings > Customizations > Open MCP Config

2. Add the following configuration:

   {
     "mcpServers": {
       "magicpod": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://app.magicpod.com/mcp",
           "--header",
           "Authorization:Bearer YOUR_API_TOKEN"
         ]
       }
     }
   }

3. Save the configuration and restart the IDE.

ChatGPT

Note

The browser version of ChatGPT does not currently support the MagicPod MCP Server. Support is planned in a future update.

Prompt Examples

Create a test case

Please create the following test:
Organization name: XX
Project name: XX
Test settings number: X
Please create steps to access <URL>, enter the following information, and complete the member registration.
Email address: test@example.com
Password: password

Edit a test case

Please edit the following test:
Organization name: XX
Project name: XX
Test case number: X
Please change the email address for registration to magicpod@example.com.

Usage confirmation & troubleshooting

Please explain how to handle click command failures in MagicPod.

Please explain how to exclude specific areas from the visual diff check in MagicPod.

Run tests

In MagicPod, please re-run only the failed test cases from the last batch execution in the "XX" organization's "XX" project.
When re-running, explicitly specify the failed test case numbers and skip the successful cases.

In MagicPod, please execute only the file operation-related test cases in the "XX" organization's "XX" project by specifying their numbers.
Use Chrome as the browser.

Investigate test run results

Get a list of failed test result URLs:

Please provide the URL list of failed test results for test case "XX" in the "XX" organization's "XX" project in MagicPod.

Investigate test failure reasons based on GitHub commit logs (requires GitHub MCP server installation):

Please investigate the following test failure:
https://app.magicpod.com/OrganziationName/ProjectName/batch-run/XXX/pattern-index/X/XXX/
Please refer to this test's execution log and identify the code changes that likely caused the failure from the commit logs in the <GitHub Organization>/<GitHub Project> repository on MM/DD.

Test Execution Result Analysis:

In MagicPod's "XX" organization's "XX" project,
please organize and output the results by test settings in CSV format based on batch execution results from the past 7 days.

Identifying Unstable Locators

The following page introduces a method for identifying unstable locators within test cases using an MCP server.

About "Utilization of stable locators"

Other

Please provide the health score of MagicPod's "XX" organization's "XX" project.

In MagicPod's "XX" organization's "XX" project, I want to delete .app files that meet all these conditions:
- The last upload date was more than 3 months ago
- A newer version with the same filename already exists
First, please extract a list of files to be deleted.
After I confirm the content and reply with "approved", please execute the deletion process.

Troubleshooting

• Connection or Authentication Errors

  Verify that your API token is correct, your API token has not expired, or your network can access https://app.magicpod.com.

  If necessary, generate a new API token from the MagicPod settings page.

• Displayed npx: command not found

  Install Node.js 18 or later. npx is included with Node.js.

   

• Error Displayed During Response Generation

  For example, when using the free version of Claude, you may see an error like "Claude's response was interrupted" during response generation. This is due to character limits in the free version and can be avoided by using the paid Claude Pro version. Similar issues may occur with other AI agents, so consider subscribing to paid plans.

Security

MagicPod MCP Server is currently a very simple module that connects AI agents with MagicPod services (MagicPod Web API and Help Center). The repository is publicly available on GitHub.

• Your information will not be used for machine learning.
• While the Web API token needs to be written in the MCP server's config file, it is designed not to pass this information to AI agents.
• We plan to expand functionality in the future while maintaining a security-conscious configuration.