ひと目でわかる概要
CursorでMageを使うには、Mage MCPサーバー(https://mcp.mage.space/mcp)を追加し、Mageアカウントでサインインします。すると、Cursorから画像はMango 3、動画はCherry 2 Pro、音声はSeed Audio、そのほか指定した28種類のMageモデルで生成できます。料金は生成ごとにGemで支払います。
16
MCPツール
28
画像・動画・音声モデル
5
対応アシスタント
$0
接続方法
セットアップ
MageをCursorに接続する方法
Mageアカウントが必要です。ゲストセッションではアプリを接続できません。
ワンクリックでインストール
「MageをCursorに追加」を選ぶと、公開OAuthクライアントIDつきでサーバーがインストールされます。Mageがすでにインストール済みの場合は、設定を置き換えてください。
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" ] } } } }サインインして頼む
求められたらMageアカウントで認証し、AgentモードのCursorにプロジェクト用のメディアの生成を頼みましょう。
試してみよう
CursorでMageを使うプロンプト例
- シードデータ用に仮の商品写真を生成して、/public/productsに保存して。
- アプリアイコンを3種類のスタイルで作って、designフォルダに追加して。
- 空の状態の画面に表示する、短いオンボーディング動画を作って。
ツール
アシスタントが呼び出せる16個のツール
| ツール | できること |
|---|---|
| list_models | おすすめモデルを、料金、得意なこと、注意点とともに一覧表示します。 |
| get_model | 1つのモデルの項目、指定できる値、デフォルト、ルール、料金を説明します。 |
| 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アシスタントすべてで使えます
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の残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。