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.

Table of contents

1. Overview
2. Setup Instructions
   1. Prerequisites
   2. Connect Your AI Client
      1. Claude Desktop
      2. Claude Code
      3. Copilot CLI
      4. Codex
      5. Cursor
      6. Gemini — Antigravity IDE / Antigravity 2.0
      7. ChatGPT
   3. Configure Tool Permissions
3. Troubleshooting
4. Security

Overview

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.

Some of the main operations currently available through the MagicPod MCP server include:

• Creating, editing, viewing, and running test cases
• Creating, editing, and viewing shared steps
• Retrieving test run results
• Retrieving UI information and validating locators
• Searching MagicPod Help Center articles

When creating or editing test cases, you can also have the AI read files such as Excel spreadsheets and give it instructions based on their contents. This enables workflows such as:

• Have the AI read test procedures created in Excel or a similar tool and create the necessary test cases.
• Have the AI read specifications for a new feature and update the affected test cases.
• Analyze the cause of a test failure and update the test case as necessary.

For specific examples of what you can do with the MagicPod MCP server, see also Prompt Examples.

The full list of available operations (tools) is provided below.

Future expansion plans: We plan to expand functionality in the future, including enhanced automatic repair. Reference: Press Release(Japanese)

Setup Instructions

Support for connections using OAuth authentication is coming soon.

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.

Configure Tool Permissions

Depending on the AI agent you use, you may be able to configure permissions for each tool provided by the MagicPod MCP server.

Restricting certain tools may limit some operations or reduce accuracy. Therefore, we generally recommend enabling all tools and setting them to Always allow.

However, your organization may have security policies or operational rules regarding the use of AI agents. Configure tool permissions as necessary in accordance with your organization's policies and rules.

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.