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

Claude Code向けMage

Claude Codeで画像・動画・音声を生成

ターミナルやエディタのClaude CodeにMageを接続すれば、普通の言葉で画像・動画・音声を頼めます。モデルの選択、料金の見積もり、結果の受け取りまでClaude Codeにおまかせ。

https://mcp.mage.space/mcp

ひと目でわかる概要

Claude CodeでMageを使うには、Mage MCPサーバー(https://mcp.mage.space/mcp)を追加し、Mageアカウントでサインインします。すると、Claude CodeがMango 4で画像、Cherry 2 Proで動画、Seed Audioで音声を生成でき、名前を指定すればMageの37モデルのどれでも使えます。生成ごとにGemsで支払います。

  • 16MCPツール
  • 37画像・動画・音声モデル
  • 5対応アシスタント
  • $0接続方法

セットアップ

MageをClaude Codeに接続する方法

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

  1. サーバーを追加

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

    claude mcp add --transport http mage https://mcp.mage.space/mcp
  2. 認証する

    Claude Codeで/mcpを実行し、mageを選んで認証します。ブラウザのページが開くので、Mageにサインインして「接続」を選択してください。

  3. 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_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で画像・動画・音声を生成できます。

  • Grok で使う Mage

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

  • Cursor で使う Mage

    Cursor のエージェントモードで、画像・動画・音声を生成できます。

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 などのヘッドレス環境で使います。
料金はいくらですか?
接続は無料です。ただし、まずアカウントでGemパックまたはプランのいずれかを一度ご購入いただく必要があります。サインアップボーナスのGemはMageアプリでのみ使えます。アシスタントが開始する生成は、モデルの表示価格に応じて、MageアカウントのGemで支払われます。アシスタントは、生成を開始する前に estimate_cost で料金を確認できます。
アシスタントはどのモデルを使いますか?
モデルを指定しない場合、アシスタントは画像をMango 4、動画をCherry 2 Pro、音声をSeed Audioで生成します。他のMageモデルも、名前を指定すればリクエストできます。
Mageアカウントを接続しても安全ですか?
何かが共有される前に、Mageがアプリの名前、サイト、戻り先を表示し、接続ごとにあなたが承認します。接続したアプリは、MCP → 接続済みアプリからいつでも解除できます。

Mageで開発を始めよう

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

Charactersコミュニティ