Mage

公式

多くのフロンティアモデルでAI画像、動画、音声を生成。デフォルトでプライベート。

Mage MCPで何ができますか？

メディアを生成 — アシスタントに画像、動画、音声クリップの作成を依頼できます。Gems はお使いの Mage アカウントから課金されます。
生成前に価格を確認 — アシスタントに生成コストを先に見積もらせておけば、承認するまで何も課金されません。
保存済みのキャラクターと参照を使用 — @ana や @red-coat のようなハンドルを指定すると、生成時に保存済みのキャラクター、衣装、ポーズ、ボイスクリップが再利用されます。
過去の作品を確認 — 過去 30 日間の生成を依頼したり、保存済みの作品を内容、コレクション、日付で検索できます。
残高を確認して実行をキャンセル — 接続済みアカウントの Gems 残高を確認したり、実行中の生成を停止できます（Gems は返金されません）。

ホスト型 MCP サーバー

npx add-mcp 'https://mcp.mage.space/mcp'

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

Claude、ChatGPT、Grok、Cursor から Mage を使う

Mage MCP サーバーを通じて Claude、ChatGPT、Claude Code、Grok、Cursor を Mage アカウントに接続し、アシスタントに画像、動画、音声の生成を依頼できます。料金は Gems で支払われます。

Mage MCP サーバーは AI アシスタントを Mage アカウントに接続します。接続すると、Claude、ChatGPT、Claude Code、Grok、Cursor にモデルの選択、価格の見積もり、画像・動画・音声クリップの生成、結果の取得を依頼できます。また、生成履歴や保存済みの作品を読み取り、保存済みのキャラクターやリファレンスを使用します。

https://mcp.mage.space/mcp

[!WARNING]

アシスタントが開始するすべての生成は、あなたのアカウントの Gems で支払われます。アシスタントは事前に価格を確認でき、いつでも接続を解除できます。

アシスタントを接続する

Claude

Claude のウェブ版、デスクトップアプリ、モバイルアプリ、および Cowork で動作します。

Connect Mage to Claude を開きます。コネクタ名と URL は自動で入力されています。Add を選択します。
Connect を選択します。Mage のページが開き、まだサインインしていない場合はサインインを求められます。
ページに接続するアプリの名前が表示されていることを確認し、Connect を選択します。Claude に戻ります。
チャットで、+ メニューの Connectors から Mage コネクタをオンにし、作りたいものを依頼します。

Team または Enterprise プランでは、まずオーナーが Organization settings → Connectors でコネクタを追加します。Free プランではカスタムコネクタを 1 つまで利用できます。

ChatGPT

ChatGPT の Plugins ページから、Mage をパーソナルプラグインとして追加します。

ChatGPT Plugins を開きます。
Add をクリックし、Create MCP App を選択します。
Name に Mage、Server URL に https://mcp.mage.space/mcp を入力し、Authentication で OAuth を選択します。Advanced OAuth settings は空のままにします。クライアント ID やクライアントシークレットは不要です。アイコンと説明は任意です。
注意事項を確認し、I understand and want to continue にチェックを入れてから Create をクリックします。
開いたページで Mage にサインインし、アプリの名前を確認して Connect を選択します。
Personal プラグインから Mage をインストールし、Work チャットを開始して @Mage にメンションします。

[!NOTE]

Create MCP App が表示されない場合は、ChatGPT の Settings → Security and login で Developer mode をオンにしてから、 Plugins に戻ってください。詳細は ChatGPT のセットアップガイドを参照してください。

Claude Code

サーバーを追加し、Claude Code からサインインします:

claude mcp add --transport http mage https://mcp.mage.space/mcp

Claude Code で /mcp を実行し、mage を選択して認証します。ブラウザのページが開き、Mage にサインインして Connect を選択します。

サインインの代わりに API キーを使用する場合:

claude mcp add --transport http mage https://mcp.mage.space/mcp \
  --header "Authorization: Bearer $MAGE_API_KEY"

Grok

Mage をカスタム MCP コネクタとして追加します。

Grok connectors を開き、New Connector を選択してから Custom を選択します。
https://mcp.mage.space/mcp を入力し、認証のプロンプトに従って Mage アカウントを接続します。
会話を開始し、Grok に Mage を使って画像、動画、または音声を作成するよう依頼します。

Grok Business または Enterprise では、まずチーム管理者がクラウドコンソールでコネクタをプロビジョニングする必要があります。

Cursor

このボタンは公開 OAuth クライアント ID を使って Mage をインストールします。プロンプトが表示されたら Mage にサインインしてください。Mage がすでにインストールされている場合は、既存の設定をこのリンクの設定に置き換えてください。ボタンが機能しない場合は、代わりにウェブインストールリンクを開いてください。ブラウザから Cursor が開き、手動で追加する同じ設定が表示されます。

手動でセットアップするには、次のエントリを ~/.cursor/mcp.json に追加します:

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com/mcp",
        "scopes": [
          "mage",
          "offline_access"
        ]
      }
    }
  }
}

クライアント ID は公開されており、クライアントシークレットは不要です。Cursor は静的 OAuth 設定を使って Mage の同意ページを開きます。

API キーで接続することもできます:

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "headers": { "Authorization": "Bearer ${env:MAGE_API_KEY}" }
    }
  }
}

アプリがサインインで接続するとき、Mage は何かが共有される前に、要求元が誰かを表示します: アプリの名前、そのアプリの提供元サイト、およびその後の戻り先です。ゲストセッションではアプリを接続できません。先に Mage アカウントでサインインしてください。

アシスタントにできること

ツール	機能
`list_models`	推奨モデルを価格、それぞれの得意分野、トレードオフとともに一覧表示します。それ以外はリクエストに応じて表示します。
`get_model`	1 つのモデルについて、そのフィールド、許可される値、デフォルト、ルール、価格を説明します。
`estimate_cost`	生成を開始する前に価格を見積もります。料金は発生しません。
`create_upload`	コンピューターからファイルをアップロードするための署名付きリンクを取得します。コマンドを実行できるアシスタント向けです。
`generate`	生成を開始します。Gems で支払われます。
`get_request`	生成が完了するまで待機し、結果のリンクを返します。
`cancel_request`	実行中の生成を停止します。Gems は返金されません。
`get_account`	接続中のアカウントとその Gems 残高を表示します。
`list_characters`	あなたのキャラクターとその `@handle` を一覧表示します。
`create_character`	画像リンクからプライベートなキャラクターを保存します。任意で音声クリップも指定できます。
`delete_character`	あなたのキャラクターの 1 つを削除します。
`list_references`	あなたの衣装、ポーズ、場所、オブジェクト、音声クリップを、すべてまたは 1 種類だけ一覧表示します。
`create_reference`	画像または音声のリンクからプライベートなリファレンスを保存します。
`delete_reference`	あなたのリファレンスの 1 つを削除します。
`list_history`	過去 30 日間の生成を一覧表示します。Mage で自分で作成したものも含まれます。
`search_creations`	保存した作品を、内容、コレクション、または日付で検索します。

リクエスト内で保存済みのキャラクターやリファレンスをハンドルで指定してください。たとえば「@ana が @red-coat を着ているポートレートを作って」と指定すると、アシスタントがそれをモデルに渡します。

スキル

Mage スキルは、これらのツールの上でアシスタントに完全な作業を教えます: 商品のフォトシュート、マーケットプレイスの出品、広告バリエーション、UGC と顔出しなしの動画、YouTube サムネイル、そして Mage アプリ（フェイススワップやリライティングから動画編集やリップシンクまで）。npx skills add mage-space/skills で追加するか、mage.space/skills で例とともに閲覧できます。

アシスタントが使用するモデル

モデルを指定しない限り、アシスタントは画像を Mango 3、動画を Cherry 2 Pro、音声を Seed Audio で生成します。開始前にモデルと価格を伝え、結果の後には、そのトレードオフがあなたの用途に合う場合に代替案を 1 つ提案することがあります。

	画像	動画
デフォルト	Mango 3	Cherry 2 Pro
同じファミリー	Mango 3S（より安価、最大 3K）、Mango 2（最大 4K）、Mango	Cherry Pro（4K）、Cherry、Cherry Mini（最も安価な Cherry）
その他の推奨	Guava 2 Pro と Guava 2（フォトリアル）、GPT Image 2.5 Flare（テキストと正確な編集）	Lemon（最初と最後のフレーム、最大 30 秒のクリップ）

その他のすべてのモデルは、名前を指定した場合にのみ実行されます。たとえば「Melon で作って」や「Nano Banana 2 を使って」などです。アシスタントは、アニメクリップにアニメモデルを使う場合など、リクエストにより適しているときに提案し、あなたの回答を待つことがあります。どのモデルを使うべきか？ではすべてを比較しています。

Cherry 2 Pro は Mage で最も高性能かつ最も高価な動画モデルであり、解像度と長さに応じて価格が急激に上がります。下書きの間は Cherry Mini または Lemon を指定してください。

生成の仕組み

アシスタントは上記のように list_models でモデルを選び、get_model でそのフィールドを読み取ります。
estimate_cost で価格を確認します。これはモデルが拒否するリクエストも検出します。動画の価格は長さに依存します: Mage は見積もり時に、アップロードされたファイルや以前の結果など Mage 上にすでにある動画を測定し、他のサイトからリンクされた動画は生成開始時にのみ測定します。
generate で生成を開始します。これにより Gems が課金されます。各生成にはアシスタントが生成するキーが付与されるため、接続が切れた後の再試行では二重に支払うことなく同じ生成が返されます。
get_request で結果の準備ができるまで待機し、リンクを返します。

結果は 30 日間利用可能です: 保持したいものはダウンロードするか、Mage に保存してください。モデレーションによって NSFW とフラグが付けられた結果はそのようにマークされます。生成が経る状態については Requests を、Gems の課金方法については Billing を参照してください。

画像とファイル

最初のフレーム、リファレンス画像、編集する動画などのメディア入力はリンクです: ファイル自体への公開 https リンク、または最大約 3 MB のデータ URL です。

Claude Code、Cursor、その他コマンドを実行するアシスタント は、コンピューターからファイルをアップロードできます: create_upload で署名付きアップロードリンクを取得し、そこにファイルを送信し、そのファイルの新しいリンクを他のリンクと同様に使用します。ファイルは最大 100 MB で、30 日後に削除されます。各アップロードは 1 つのファイルを保持します: 修正したファイルは新しいアップロードとして送信してください。古いリンクは最大 4 時間、最初のファイルを表示し続ける可能性があるためです。
Claude、ChatGPT、Grok のチャット は、チャットに添付したファイルを Mage に渡すことができません。代わりにファイルへの直接リンクを共有するか、Mage 上にすでにある作品を使用してください。
YouTube や TikTok の動画など、ウェブページへのリンクはファイルではないため拒否されます。

接続済みアプリの管理

接続したすべてのアプリは MCP → Connected apps に一覧表示され、接続した日時と最後に使用された日時が表示されます。Disconnect を選択するとアプリを即座に停止できます。再度接続するまで、そのアプリはあなたのアカウントを使用したり Gems を消費したりできません。フローティングナビゲーションで MCP を開き、Connected apps を選択してください。

制限

API と同様に、あなたのアカウントでは最大 20 件の生成を同時に実行できます。
アプリは 1 分間に最大 120 回のツール呼び出しを行えます。
get_request は呼び出しごとに最大 2 分間待機します。より長い生成では、アシスタントが再度呼び出します。

トラブルシューティング

Cursor が「Incompatible auth server: does not support dynamic client registration」と表示する: ~/.cursor/mcp.json の既存の Mage エントリを更新して、上記の Cursor セットアップの auth ブロックを含めてから、再接続してください。サーバー URL だけでは、Mage の事前登録済み Cursor クライアント ID は含まれません。
「Couldn't reach the MCP server」: URL が正確に https://mcp.mage.space/mcp であることを確認し、コネクタを削除してから再度追加してください。
接続時に再度サインインを求められる: 接続は最大 180 日間持続し、その後アプリは再度承認を求めます。Mage で切断することでも終了します。
生成が insufficient_gems で失敗した: API → Billing で Gems を追加し、再試行してください。

このドキュメントは、開発者向けドキュメントプラットフォームである Mintlify 上で構築およびホストされています。