ひと目でわかる概要
Claude CodeでMageを使うには、Mage MCPサーバー(https://mcp.mage.space/mcp)を追加し、Mageアカウントでサインインします。すると、Claude CodeがMango 3で画像、Cherry 2 Proで動画、Seed Audioで音声を生成でき、指定すればMageの28モデルのどれでも使えます。料金は生成ごとにGemsで支払います。
16
MCPツール
28
画像・動画・音声モデル
5
対応アシスタント
$0
接続方法
セットアップ
MageをClaude Codeに接続する方法
Mageアカウントが必要です。ゲストセッションではアプリを接続できません。
サーバーを追加
ターミナルで次のコマンドを実行します。
claude mcp add --transport http mage https://mcp.mage.space/mcp認証する
Claude Codeで/mcpを実行し、mageを選んで認証します。ブラウザのページが開くので、Mageにサインインして「接続」を選択してください。
APIキーを使う場合
ブラウザでのサインインを省略するには、代わりにヘッダーにキーを指定してサーバーを追加します。
claude mcp add --transport http mage https://mcp.mage.space/mcp \ --header "Authorization: Bearer $MAGE_API_KEY"
試してみよう
Claude CodeでMageを使うプロンプト例
- このブログ記事用の1200×630のOpen Graph画像を生成して、public/og.pngに保存して。
- ブランドカラーで、ランディングページの3つのセクション用のヒーローイラストを作って。
- assets/demo.mp4をアップロードして、水彩アニメ風にスタイル変換して。
- ホームページ用に、5秒のループ背景動画を作って。
ツール
アシスタントが呼び出せる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
よくある質問
Claude Codeでプロジェクト用の画像を生成できますか?
はい。Mage MCPサーバーを使えば、Claude Codeで画像・動画・音声を生成し、結果をリポジトリにダウンロードできます。create_uploadで、編集したいクリップなどプロジェクト内のファイルをアップロードすることも可能です。
Claude CodeではOAuthとAPIキーのどちらを使うべき?
どちらでも使えます。OAuthはブラウザでサインインするため、シェルにシークレットを置く必要がありません。APIキーはCIやヘッドレス環境に向いており、Authorization: Bearerヘッダーで渡します。
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の残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。