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

MagicPod MCPサーバーのセットアップ手順

  • 更新

注意
バージョン1.69.0のアップデートに伴い、MCPサーバーを刷新しました。バージョン1.75.0で、従来のMCPサーバーのサポートを終了しました。従来のMCPサーバーをご利用中の場合は、以下のセットアップ手順を参考に、新しいMCPサーバーへ切り替えてください。

 

目次

  1. はじめに
  2. サービスごとのセットアップ手順
    1. ChatGPT
    2. Claude (Desktop, Web, Mobile)
    3. Claude Code
    4. Copilot CLI
    5. Microsoft Copilot Studio
    6. Codex
    7. Cursor
    8. Gemini — Antigravity / Gemini CLI / Gemini Enterprise
  3. ツールの利用権限を設定する
  4. トラブルシューティング

 

はじめに

MagicPod MCPサーバーのURLは以下のとおりです。

お使いのAIクライアントで、このURLを設定してMagicPodの認証を行うことでセットアップが完了します。

https://app.magicpod.com/mcp

 

注意: 2要素認証を設定中のお客様へ
2要素認証を以前より設定いただいているお客様は、MCPサーバーの利用に際してワンタイムパスワードの再設定を求められる場合があります。お手数ですが、画面の指示に従って再設定を行った後に再度MCPサーバーのセットアップを進めてください。

 

サービスごとのセットアップ手順

ChatGPT

MagicPodでのログイン方式によってセットアップ手順が異なります。

Eメール（ユーザーネーム）とパスワードでログインしている場合

カスタムMCPアプリとしてMagicPod MCPサーバーを追加します。ChatGPTの契約プランによって設定方法が異なります。

MagicPod MCPサーバーはOpenAIによる審査を経ていないため、カスタムMCPアプリとして登録する必要があります。現在審査を進めており、近日中により簡単な手順でセットアップが行えるようになります。

  • Business プランの場合

    ワークスペースのAdminまたはOwnerが先にカスタムアプリを作成し、ワークスペースに公開する必要があります。

    • AdminまたはOwnerが ワークスペース設定 > アプリ を開き、作成をクリックします。
    • 以下を入力してMagicPodアプリを作成します。
      • 名前: MagicPod
      • MCPサーバーURL: https://app.magicpod.com/mcp
    • 作成したMagicPodアプリをワークスペースに公開します。

    • 各メンバーは公開されたMagicPodアプリを選択し、接続時に表示されるMagicPodのログイン画面からログインして認可を完了してください。

       

  • Enterprise / Edu プランの場合

    ワークスペースのAdminまたはOwnerが、カスタムアプリを利用するための権限を設定する必要があります。

    • AdminまたはOwnerが、必要に応じて対象ユーザーに開発者モードの利用権限を付与します。
    • 権限を付与されたユーザーが 設定 > アプリ > 詳細設定 を開き、開発者モードを有効にします。
    • 設定 > アプリ から アプリを作成 をクリックし、以下を入力して作成します。
      • 名前: MagicPod
      • MCPサーバーURL: https://app.magicpod.com/mcp

    • MagicPodへの接続時にブラウザでMagicPodのログイン画面が開きます。ログインして認可を完了してください。

       

  • Pro プランの場合

    ※ Proプランでは、MCP経由で利用できる機能は読み取り系の操作に限定されます。

    • ChatGPTの 設定 > アプリ > 詳細設定 を開き、開発者モード を有効にします。
    • 設定 > アプリ から アプリを作成 をクリックします。
    • 以下を入力して作成します。
      • 名前: MagicPod
      • MCPサーバーURL: https://app.magicpod.com/mcp
    • MagicPodへの接続時にブラウザでMagicPodのログイン画面が開きます。ログインして認可を完了してください。

     

  • Free / Go / Plus プランの場合

    カスタムMCPアプリは利用できません。近日中にカスタムではないApp DirectoryのMCPアプリとして登録することで対応予定です。 

 

シングルサインオン（SAML）またはGitHubでログインしている場合

シングルサインオン（SAML）またはGitHub認証を用いた接続は現在非対応です。近日対応予定です。

 

Claude (Desktop, Web, Mobile)

MagicPodでのログイン方式によってセットアップ手順が異なります。

Eメール（ユーザーネーム）とパスワードでログインしている場合

MagicPod MCPサーバーはClaudeのコネクタディレクトリにCommunityコネクタとして掲載されています。ディレクトリから追加することで、URLを手入力せずにセットアップできます。

MagicPodコネクタのページ: https://claude.ai/directory/magicpod

Claudeの契約プランによって設定方法が異なります。

  • Team / Enterprise プランの場合

    Claude Team / Enterprise の組織のオーナーが先に組織にコネクタを追加する必要があります。

    1. オーナーが 組織設定 > コネクタ を開き、ディレクトリから「MagicPod」を検索するか、コネクタのページを開いて組織に追加します。
    2. 各メンバーは カスタマイズ > コネクタ で MagicPod（「カスタム」ラベル付き）を探し、 連携させる をクリックしてMagicPodにログインします。

     

  • Free / Pro / Max プランの場合
    1. Claudeで カスタマイズ > コネクタ を開き、ディレクトリから「MagicPod」を検索するか、コネクタのページを開き、Claudeに接続 をクリックします。
    2. ブラウザでMagicPodのログイン画面が開きます。ログインして認可を完了してください。

シングルサインオン（SAML）またはGitHubでログインしている場合

  1. Claude Desktopを開き、Settings > Developer > Edit Configを開きます。

  2. claude_desktop_config.jsonファイルが立ち上がるため、ファイル内に以下の設定を追加してください。YOUR_API_TOKEN の箇所については、MagicPod APIトークンの実際の値に置き換えてください。

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

  3. ファイルを保存し、Claude Desktopを再起動します。

     

Claude Code

MagicPodでのログイン方式によってセットアップ手順が異なります。

Eメール（ユーザーネーム）とパスワードでログインしている場合

ターミナルで以下のコマンドを実行します。

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

その後表示される画面にて、Eメール（ユーザーネーム）とパスワードでログインすることでセットアップが完了します。

 

シングルサインオン（SAML）またはGitHubでログインしている場合 / CIなどのヘッドレスな環境で用いる場合

ターミナルで以下のコマンドを実行します。YOUR_API_TOKEN の箇所については、MagicPod APIトークンの実際の値に置き換えてください。

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

シングルサインオン（SAML）またはGitHub認証の場合についてもEメール/パスワードと同様の手順でセットアップできるよう近日対応予定です。

 

Copilot CLI

MagicPodでのログイン方式によってセットアップ手順が異なります。

Eメール（ユーザーネーム）とパスワードでログインしている場合

  1. ターミナルで以下のコマンドを実行します。

    copilot mcp add --transport http magicpod https://app.magicpod.com/mcp

  2. Copilot CLIを起動し、以下のコマンドを実行します。

    /mcp auth magicpod
  3. ブラウザでMagicPodのログイン画面が開きます。ログインして認可を完了してください。

※ OAuthでの接続にはCopilot CLI 1.0.15以降が必要です。認証の有効期限が切れた場合も、/mcp auth magicpod で再度ログインできます。

 

シングルサインオン（SAML）またはGitHubでログインしている場合 / CIなどのヘッドレスな環境で用いる場合

ターミナルで以下のコマンドを実行します。YOUR_API_TOKEN の箇所については、MagicPod APIトークンの実際の値に置き換えてください。

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

シングルサインオン（SAML）またはGitHub認証の場合についてもEメール/パスワードと同様の手順でセットアップできるよう近日対応予定です。

 

Microsoft Copilot Studio

Microsoft Copilot Studioでは、エージェントのツールとしてMagicPod MCPサーバーを追加できます。

Eメール（ユーザーネーム）とパスワードでログインしている場合

  1. Copilot Studioを開き、左メニューの エージェント からMagicPod MCPサーバーを追加したいエージェントを開きます。
  2. 作成 タブの右側にある ツール の + をクリックします。
  3. ツールの追加 画面で + 追加 をクリックし、モデル コンテキスト プロトコル (MCP) を選択します。
  4. MCP サーバーを追加 画面で以下を入力し、追加 をクリックします。
    • サーバー名: 任意の名前（例: MagicPod）
    • サーバーの説明: 任意の説明
    • サーバー URL: https://app.magicpod.com/mcp
    • 認証: OAuth 2.0
    • 構成の種類: 動的 (検出あり)
  5. 接続を選択します 画面で 接続 のプルダウンを開き、Create new connection を選択します。
  6. Create をクリックします。
  7. ブラウザでMagicPodのログイン画面が開きます。ログインして認可を完了してください。
  8. 接続 に接続が表示されたら 追加 をクリックします。ツール にMagicPodが追加されていれば、セットアップは完了です。

シングルサインオン（SAML）またはGitHubでログインしている場合

シングルサインオン（SAML）またはGitHub認証の場合についてもEメール/パスワードと同様の手順でセットアップできるよう近日対応予定です。

Codex

Codex CLI、Codex IDE拡張機能、Codexアプリは同じ設定ファイル（~/.codex/config.toml）を共有するため、以下の手順でCLIから追加したMCPサーバーはいずれでも利用できます。

MagicPodでのログイン方式によってセットアップ手順が異なります。

Eメール（ユーザーネーム）とパスワードでログインしている場合

  1. ターミナルで以下のコマンドを実行します。

    codex mcp add magicpod --url https://app.magicpod.com/mcp

  2. ブラウザでMagicPodのログイン画面が開きます。ログインして認可を完了してください。
    ブラウザが自動で開かない場合、ログインが完了する前にタイムアウトした場合、または再度ログインが必要になった場合は、以下のコマンドを実行してください。

    codex mcp login magicpod

 

シングルサインオン（SAML）またはGitHubでログインしている場合 / CIなどのヘッドレスな環境で用いる場合

  1. MagicPod APIトークンを環境変数として設定します。YOUR_API_TOKEN の箇所については、MagicPod APIトークンの実際の値に置き換えてください。

    export MAGICPOD_API_TOKEN=YOUR_API_TOKEN

  2. ターミナルで以下のコマンドを実行します。

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

セッションをまたいで環境変数を保持する場合は、exportの行をシェルのプロファイル（例：~/.zshrcまたは~/.bashrc）に追加してください。

シングルサインオン（SAML）またはGitHub認証の場合についてもEメール/パスワードと同様の手順でセットアップできるよう近日対応予定です。

 

Cursor

MagicPodでのログイン方式によってセットアップ手順が異なります。いずれの場合も、まずCursorのMCP設定ファイルを開きます。

  • すべてのプロジェクトで使用する場合：~/.cursor/mcp.json
  • 特定のプロジェクトでのみ使用する場合：プロジェクトルートの.cursor/mcp.json

Eメール（ユーザーネーム）とパスワードでログインしている場合

  1. MCP設定ファイルに以下の設定を追加し、保存します。

    {
  "mcpServers": {
    "magicpod": {
      "url": "https://app.magicpod.com/mcp"
    }
  }
}
  2. Cursorのサイドバーから Customize > MCPs を開き、MagicPodの Authenticate をクリックします。
  3. ブラウザでMagicPodのログイン画面が開きます。ログインして認可を完了してください。

Cursor CLIを利用する場合は、上記の設定ファイルを保存した後、ターミナルで以下のコマンドを実行してログインします。

agent mcp login magicpod

 

シングルサインオン（SAML）またはGitHubでログインしている場合 / CIなどのヘッドレスな環境で用いる場合

  1. MCP設定ファイルに以下の設定を追加します。YOUR_API_TOKEN の箇所については、MagicPod APIトークンの実際の値に置き換えてください。

    {
  "mcpServers": {
    "magicpod": {
      "url": "https://app.magicpod.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
  2. Cursorを再起動します。

シングルサインオン（SAML）またはGitHub認証の場合についてもEメール/パスワードと同様の手順でセットアップできるよう近日対応予定です。

 

Gemini — Antigravity / Gemini CLI / Gemini Enterprise

注意
Geminiアプリ（gemini.google.com）は、MagicPod MCPサーバーの利用に対応していません。MagicPod MCPサーバーをGeminiから利用する場合は、Antigravity（Antigravity IDE / Antigravity 2.0）、Gemini CLI、またはGemini Enterpriseを使用してください。

Antigravity

MCP設定ファイル（mcp_config.json）を開きます。Antigravity IDEの場合は、エージェントパネルの ... > MCP Servers > Manage MCP Servers > View raw config から開けます。

MagicPodでのログイン方式によってセットアップ手順が異なります。

Eメール（ユーザーネーム）とパスワードでログインしている場合

  1. 以下の設定を追加し、保存します。

    {
  "mcpServers": {
    "magicpod": {
      "serverUrl": "https://app.magicpod.com/mcp"
    }
  }
}
  2. Settings（macOSは Cmd+,、Windows/Linuxは Ctrl+,）を開き、Customizations タブでMagicPodの横にある Authenticate をクリックします。
  3. ブラウザでMagicPodのログイン画面が開きます。ログインして認可を完了した後、表示された認可コードをコピーし、Antigravityの設定画面に貼り付けて Submit をクリックします。

 

シングルサインオン（SAML）またはGitHubでログインしている場合 / CIなどのヘッドレスな環境で用いる場合

  1. 以下の設定を追加します。YOUR_API_TOKEN の箇所については、MagicPod APIトークンの実際の値に置き換えてください。

    {
  "mcpServers": {
    "magicpod": {
      "serverUrl": "https://app.magicpod.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
  2. 設定を保存し、Antigravityを再起動します。

シングルサインオン（SAML）またはGitHub認証の場合についてもEメール/パスワードと同様の手順でセットアップできるよう近日対応予定です。

 

Gemini CLI

MagicPodでのログイン方式によってセットアップ手順が異なります。

Eメール（ユーザーネーム）とパスワードでログインしている場合

  1. ターミナルで以下のコマンドを実行します。

    gemini mcp add --scope user --transport http magicpod https://app.magicpod.com/mcp

  2. Gemini CLIを起動し、以下のコマンドを実行します。

    /mcp auth magicpod
  3. ブラウザでMagicPodのログイン画面が開きます。ログインして認可を完了してください。

 

シングルサインオン（SAML）またはGitHubでログインしている場合 / CIなどのヘッドレスな環境で用いる場合

ターミナルで以下のコマンドを実行します。YOUR_API_TOKEN の箇所については、MagicPod APIトークンの実際の値に置き換えてください。

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

シングルサインオン（SAML）またはGitHub認証の場合についてもEメール/パスワードと同様の手順でセットアップできるよう近日対応予定です。

 

Gemini Enterprise

Gemini Enterpriseでは、カスタムMCPサーバーのデータストア（データコネクタ）としてMagicPod MCPサーバーを追加できます。

Eメール（ユーザーネーム）とパスワードでログインしている場合

Gemini Enterpriseの管理者が先にGoogle Cloudコンソールでデータストアを作成し、アクション（MagicPod MCPサーバーのツール）を有効にする必要があります。

管理者が行うこと

  1. Google Cloudで事前に必要な設定を行います。詳しくは、Gemini Enterpriseのドキュメント「カスタム MCP サーバーのデータストアを設定する — 始める前に」を参照してください。

  2. Gemini Enterpriseのドキュメント「カスタム MCP サーバーのデータストアを作成する」の手順に沿ってデータストアを作成します。認証方法は OAuth 2.0 を選択し、以下の値を入力します。

    • MCP サーバーの URL: https://app.magicpod.com/mcp
    • 認可 URL: https://app.magicpod.com/api/magicpod/authorize
    • トークン URL: https://app.magicpod.com/api/magicpod/token
    • クライアント ID: magicpod-gemini-enterprise
    • クライアント シークレット: 空欄のまま
    • スコープ: openid email profile
    • PKCE サポートを有効にする: オン
    • HTTP 基本認証を使用する: オフ（デフォルトでオンになっているため、チェックを外してください）

    [認証を確認] をクリックすると、MagicPodへのサインイン画面が開きます。Sign in to MagicPod をクリックしてMagicPodにログインし、認可を完了してください。

  3. データストアの状態が Active になったら、データストアの [アクション] タブで [カスタム アクションを再読み込み] をクリックします。失敗する場合は、再度認証してからやり直してください。
  4. 有効にするアクションを選択し、[アクションを有効にする] をクリックします。

メンバーが行うこと

  1. Gemini Enterpriseを開き、チャットの入力欄の下にある Connectors アイコンをクリックします。
  2. Custom MCP に表示されたMagicPodのデータストア（管理者が付けた名前で表示されます）の Authorize をクリックします。
  3. MagicPodへのサインイン画面が開きます。Sign in to MagicPod をクリックしてMagicPodにログインし、認可を完了してください。
  4. MagicPodのデータストアのトグルがオンになっていれば、セットアップは完了です。

 

シングルサインオン（SAML）またはGitHubでログインしている場合

シングルサインオン（SAML）またはGitHub認証の場合についてもEメール/パスワードと同様の手順でセットアップできるよう近日対応予定です。

 

ツールの利用権限を設定する

AIエージェントによっては、MagicPod MCPサーバーが提供するツールごとに利用権限を設定できます。

例えばClaude Desktopでは、MagicPod MCPサーバーのコネクタ設定画面から、各ツールの利用について、常に許可する、利用時に都度承認を必要とする、利用を許可しない、といった設定を行えます。

一部ツールを制限すると、特定の操作が制限されたり、精度が落ちる可能性があるため、基本的には全てのツールを（常に許可として）有効化しておくことを推奨しております。

ただし、AIエージェントの利用にあたっては、会社によってセキュリティポリシーや運用ルールが定められている場合があるため、必要に応じて制限を行ってください。

 

トラブルシューティング

接続エラーまたは認証エラーが発生する場合

APIトークンが正しいこと、有効期限が切れていないこと、およびご利用のネットワークから https://app.magicpod.com にアクセスできることをご確認ください。必要に応じて、MagicPodの設定画面から新しいトークンを発行してください。

 

ブラウザでのログイン後に接続できない場合 / 再度ログインが必要な場合

認証の有効期限が切れた場合や、別のMagicPodアカウントに切り替えたい場合は、以下の方法で再度ログインしてください。

  • Claude Code：claude mcp login magicpod
  • Copilot CLI：Copilot CLI内で /mcp auth magicpod
  • Codex：codex mcp logout magicpod の後に codex mcp login magicpod
  • Cursor CLI：agent mcp login magicpod
  • Gemini CLI：Gemini CLI内で /mcp auth magicpod

また、ブラウザを利用できない環境（SSH接続先やコンテナ内など）ではブラウザでのログインを完了できないため、APIトークンを用いた手順でセットアップしてください。

 

npx: command not found と表示される場合

Node.js（バージョン18以降）をインストールしてください。npx はNode.jsに含まれています。

 

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

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

 

 

関連記事