Skip to main content

Setting Up MagicPod MCP Server

  • Updated

Note
With the release of version 1.69.0, we have revamped our MCP server. As a result, customers already using the previous MCP server will also need to switch over. Please refer to the setup instructions below.

 

Table of Contents

  1. Introduction
  2. Setup Instructions by Service
    1. ChatGPT
    2. Claude Desktop
    3. Claude Code
    4. Copilot CLI
    5. Codex
    6. Cursor
    7. Gemini — Antigravity IDE / Antigravity 2.0
  3. Configuring Tool Permissions
  4. Troubleshooting

 

Introduction

The MagicPod MCP server URL is as follows.

Setup is complete once you configure this URL in your AI client and authenticate with MagicPod.

https://app.magicpod.com/mcp

 

Note for customers using two-factor authentication
If you have previously set up two-factor authentication, you may be asked to reconfigure your one-time password when using the MCP server. We apologize for the inconvenience; please follow the on-screen instructions to reconfigure it, then proceed with the MCP server setup again.

 

Setup Instructions by Service

ChatGPT

The setup procedure differs depending on how you log in to MagicPod.

If you log in with email (username) and password

Add the MagicPod MCP server as a custom MCP app. The configuration method differs depending on your ChatGPT plan.

Because the MagicPod MCP server has not yet been reviewed by OpenAI, it must be registered as a custom MCP app. The review is currently in progress, and a simpler setup procedure will be available soon.

  • Business plan

    A workspace Admin or Owner must first create the custom app and publish it to the workspace.

    • The Admin or Owner opens Workspace settings > Apps and clicks Create.
    • Enter the following to create the MagicPod app.
      • Name: MagicPod
      • MCP server URL: https://app.magicpod.com/mcp
    • Publish the created MagicPod app to the workspace.

    • Each member then selects the published MagicPod app and completes authorization by logging in on the MagicPod login screen that appears when connecting.

       

  • Enterprise / Edu plans

    A workspace Admin or Owner must configure permissions to allow the use of custom apps.

    • The Admin or Owner grants permission to use Developer mode to the relevant users as needed.
    • Users who have been granted permission open Settings > Apps > Advanced settings and enable Developer mode.
    • From Settings > Apps, click Create app, then enter the following to create it.
      • Name: MagicPod
      • MCP server URL: https://app.magicpod.com/mcp

    • When connecting to MagicPod, the MagicPod login screen opens in your browser. Log in to complete authorization.

       

  • Pro plan

    * On the Pro plan, features available via MCP are limited to read-only operations.

    • In ChatGPT, open Settings > Apps > Advanced settings and enable Developer mode.
    • From Settings > Apps, click Create app.
    • Enter the following to create it.
      • Name: MagicPod
      • MCP server URL: https://app.magicpod.com/mcp
    • When connecting to MagicPod, the MagicPod login screen opens in your browser. Log in to complete authorization.

     

  • Free / Go / Plus plans

    Custom MCP apps are not available. We plan to support these plans soon by registering MagicPod as a standard (non-custom) MCP app in the App Directory. 

 

If you log in with single sign-on (SAML) or GitHub

Connecting via single sign-on (SAML) or GitHub authentication is not currently supported. Support is coming soon.

 

Claude Desktop

The setup procedure differs depending on how you log in to MagicPod.

If you log in with email (username) and password

Add the MagicPod MCP server as a custom connector. The configuration method differs depending on your Claude plan.

Because the MagicPod MCP server has not yet been reviewed by Anthropic, it must be registered as a custom connector. The review is currently in progress, and a simpler setup procedure will be available soon.

  • Team / Enterprise plans

    The organization Owner must first add the connector to the organization.

    1. The Owner opens Organization settings > Connectors and selects "Add" → "Custom" → "Web".
    2. Enter https://app.magicpod.com/mcp as the URL and add it. 
    3. Each member finds MagicPod (labeled "Custom") under Customize > Connectors, clicks Connect, and logs in to MagicPod.

     

  • Free / Pro / Max plans
    1. In Claude Desktop, open Customize > Connectors.
    2. From the "+" button, select Add custom connector.
    3. Enter the following and click Add.
      • Name: MagicPod
      • URL: https://app.magicpod.com/mcp
      • You can leave the advanced settings (OAuth Client ID / Secret) blank. 
    4. Click Connect next to MagicPod in the list, and the MagicPod login screen will open in your browser. Log in to complete authorization.

If you log in with single sign-on (SAML) or GitHub

  1. Open Claude Desktop and go to Settings > Developer > Edit Config.

  2. The claude_desktop_config.json file will open. Add the following configuration to the file. Replace YOUR_API_TOKEN with the actual value of your MagicPod API token.

    {
  "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

The setup procedure differs depending on how you log in to MagicPod.

If you log in with email (username) and password

Run the following command in your terminal.

claude mcp add --transport http magicpod https://app.magicpod.com/mcp && claude mcp login magicpod

Setup is complete once you log in with your email (username) and password on the screen that appears.

 

If you log in with single sign-on (SAML) or GitHub / If you use it in a headless environment such as CI

Run the following command in your terminal. Replace YOUR_API_TOKEN with the actual value of your MagicPod API token.

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

We plan to support setup for single sign-on (SAML) and GitHub authentication using the same procedure as email/password soon.

 

Copilot CLI

Run the following command in your terminal. Replace YOUR_API_TOKEN with the actual value of your MagicPod API token.

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

 

Codex

  1. Set your MagicPod API token as an environment variable. Replace YOUR_API_TOKEN with the actual value of your MagicPod API token.

    export MAGICPOD_API_TOKEN=YOUR_API_TOKEN

  2. 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 sessions, add the export line to your shell profile (e.g., ~/.zshrc or ~/.bashrc).

 

Cursor

  1. Open Cursor's MCP configuration file.
    • To use it in all projects: ~/.cursor/mcp.json
    • To use it only in a specific project: .cursor/mcp.json in the project root

  2. Add the following configuration inside "mcpServers". Replace YOUR_API_TOKEN with the actual value of your MagicPod API token.

    {
  "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 from Gemini, please use Antigravity IDE or Antigravity 2.0.

  1. Open Settings > Customizations > Open MCP Config.
  2. Add the following configuration. Replace YOUR_API_TOKEN with the actual value of your MagicPod API token.
{
  "mcpServers": {
    "magicpod": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.magicpod.com/mcp",
        "--header",
        "Authorization:Bearer YOUR_API_TOKEN"
      ]
    }
  }
}
  1. Save the configuration and restart the IDE.

 

Configuring Tool Permissions

Some AI agents let you configure permissions for each tool provided by the MagicPod MCP server.

For example, in Claude Desktop, you can set each tool to always allow, require approval each time it is used, or block its use, from the MagicPod MCP server's connector settings screen.

Restricting some tools may limit certain operations or reduce accuracy, so we generally recommend enabling all tools (set to always allow).

However, your company may have security policies or operational rules governing the use of AI agents, so please apply restrictions as needed.

 

Troubleshooting

If a connection error or authentication error occurs

Make sure your API token is correct and has not expired, and that https://app.magicpod.com is accessible from your network. If necessary, issue a new token from the MagicPod settings screen.

 

If npx: command not found is displayed

Install Node.js (version 18 or later). npx is included with Node.js.

 

If an error appears while a response is being generated

For example, if you are using the free version of Claude, the error "Claude's response was interrupted." may appear while a response is being generated. This is caused by the character limit on the free version and can be avoided by using the paid Claude Pro plan. Similar issues may occur with other AI agents, so please consider subscribing to a paid plan.

 

 

Was this article helpful?
0 out of 0 found this helpful
If the problem persists, please contact us from here.
Contact
Return to top

Related articles