Cursor向けMage

Cursorで画像・動画・音声をAI生成

MageをCursorのAgentモードに接続して、画像・動画・音声を普通の言葉で頼むだけ。モデルの選択、料金の見積もり、結果の受け取りまでCursorが行います。

MageをCursorに追加MageでMCP設定を開く
https://mcp.mage.space/mcp

ひと目でわかる概要

CursorでMageを使うには、Mage MCPサーバー(https://mcp.mage.space/mcp)を追加し、Mageアカウントでサインインします。すると、Cursorから画像はMango 3、動画はCherry 2 Pro、音声はSeed Audio、そのほか指定した28種類のMageモデルで生成できます。料金は生成ごとにGemで支払います。

セットアップ

MageをCursorに接続する方法

Mageアカウントが必要です。ゲストセッションではアプリを接続できません。

  1. ワンクリックでインストール

    「MageをCursorに追加」を選ぶと、公開OAuthクライアントIDつきでサーバーがインストールされます。Mageがすでにインストール済みの場合は、設定を置き換えてください。

  2. mcp.jsonに追加する場合

    手動で設定するには、次のエントリを~/.cursor/mcp.jsonに追加します。クライアントIDは公開されており、シークレットは不要です。

    {
      "mcpServers": {
        "mage": {
          "url": "https://mcp.mage.space/mcp",
          "auth": {
            "CLIENT_ID": "https://cursor.com/mcp",
            "scopes": [
              "mage",
              "offline_access"
            ]
          }
        }
      }
    }
  3. サインインして頼む

    求められたらMageアカウントで認証し、AgentモードのCursorにプロジェクト用のメディアの生成を頼みましょう。

試してみよう

CursorでMageを使うプロンプト例

ツール

アシスタントが呼び出せる16個のツール

ツールできること
list_modelsおすすめモデルを、料金、得意なこと、注意点とともに一覧表示します。
get_model1つのモデルの項目、指定できる値、デフォルト、ルール、料金を説明します。
estimate_cost生成を始める前に料金を見積もります。料金は一切かかりません。
create_uploadローカルファイルをアップロードするための署名付きリンクを取得します。コマンドを実行できるアシスタント向けです。
generate画像、動画、音声の生成を開始します。
get_request生成の完了を待って、結果のリンクを返します。
cancel_request実行中の生成を停止します。
get_account接続中のアカウントとGemsの残高を表示します。
list_characters保存したキャラクターとその@handleを一覧表示します。
create_character画像から非公開のキャラクターを保存します。ボイスも追加できます。
delete_characterキャラクターを1つ削除します。
list_references保存した衣装、ポーズ、ロケーション、オブジェクト、ボイスクリップを一覧表示します。
create_reference画像または音声のリンクから、非公開のリファレンスを保存します。
delete_referenceリファレンスを1つ削除します。
list_historyアプリで作成したものも含め、過去30日間の生成を一覧表示します。
search_creations保存した作品を、内容、コレクション、日付で検索します。

ほかのアシスタント

Mageは主要なAIアシスタントすべてで使えます

ClaudeでMageを使う

Claudeのウェブ版、デスクトップアプリ、モバイルアプリ、Coworkで、画像・動画・音声を生成できます。

ChatGPTでMageを使う

個人用MCPアプリとして、ChatGPTで画像・動画・音声を生成できます。

Claude Code で使う Mage

ターミナルやエディタの Claude Code で、画像・動画・音声を生成できます。

Grok で使う Mage

カスタムコネクタとして、Grok で画像・動画・音声を生成できます。

FAQ

よくある質問

CursorでOAuthの代わりにAPIキーは使えますか?

はい。サーバーのエントリにURLと headers: { "Authorization": "Bearer ${env:MAGE_API_KEY}" } を設定し、キーは環境変数に保存してください。

Mage MCP サーバーとは?

https://mcp.mage.space/mcp で提供されるリモートの Model Context Protocol サーバーで、AI アシスタントがあなたの Mage アカウントで画像・動画・音声を生成できるようになります。アシスタントは 16 個のツールを使って、モデルの選択、料金の見積もり、生成、結果の待機、保存済みのキャラクター・リファレンス・履歴の利用ができます。

MCP サーバーの利用に API キーは必要ですか?

いいえ。Claude、ChatGPT、Grok、Cursor、Claude Code は、OAuth で Mage にサインインして接続します。API キーは任意で、CI などのヘッドレス環境で使います。

料金はいくらですか?

接続は無料です。アシスタントが開始する生成ごとに、モデルの表示価格に応じてMageアカウントのGemsが消費されます。アシスタントは生成を始める前に estimate_cost で料金を確認できます。

アシスタントはどのモデルを使いますか?

モデルを指定しない場合、アシスタントは画像にMango 3、動画にCherry 2 Pro、音声にSeed Audioを使います。ほかのMageモデルも、名前を伝えれば指定できます。

Mageアカウントを接続しても安全ですか?

何かが共有される前に、Mageがアプリの名前、サイト、戻り先を表示し、接続ごとにあなたが承認します。接続したアプリは、MCP → 接続済みアプリからいつでも解除できます。

Mageで開発を始めよう

アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。

MageをCursorに追加MageでMCP設定を開く

関連情報