MCP サーバーと CLI

Nano Banana MCP & CLI

Claude Code、Cursor、Codex の中で、Nano Banana Pro、Seedream、GPT Image、Seedance などのモデルを使って画像や動画を直接生成。エージェントは今お持ちのクレジットとプランを使います。

ワンステップでセットアップ

  • Claude Code
  • Cursor
  • Codex

このメッセージをエージェントに貼り付ければ、インストールとログインを代わりに行います。

自分で設定したい場合は 接続方法を見る

API の別料金は不要。今の Nano Banana アカウントでそのまま使えます。

エージェントを接続

クライアントを選んでください。ローカル MCP は npx で動き CLI のログインを再利用します。リモート MCP は Authorization ヘッダーに API トークンが必要です。

ターミナルで実行

claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcp

初めてツールを使う前に npx -y @nanobananana/cli@latest auth login でログインするか、NANOBANANANA_TOKEN を設定してください。

3 ステップで始める

一度インストールしてブラウザでログインすれば、あとはエージェントに頼むだけです。

  1. 01

    MCP サーバーを追加

    Claude Code ならコマンド 1 つ。Cursor と Codex は短い設定を追加するだけです。

    claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcp
  2. 02

    ログイン

    ブラウザが開きます。アクセスを許可すると CLI がトークンを端末に保存します。

    npx -y @nanobananana/cli@latest auth login
  3. 03

    生成する

    エージェントに画像や動画を頼むか、CLI を直接実行。結果はプロジェクトにダウンロードされます。

    nanobanana generate create nano-banana-pro --prompt "a banana astronaut" --wait

エージェントが使えるツール

モデル選びから結果のダウンロードまで、9 つのツールでカバーします。

  • nano_account_status

    メールアドレス、プラン、クレジット残高、無制限のモデル、今日の無制限枠の残り。

  • nano_list_models

    画像・動画モデルの一覧。短い説明と最低価格付きで、種類で絞り込めます。

  • nano_get_model

    モデルの全パラメーター:型、指定できる値、範囲、組み合わせ可能なオプション。

  • nano_estimate_cost

    パラメーターに対する正確なクレジット消費。組み合わせが無効ならその理由。

  • nano_upload_image

    HTTPS リンクから参照画像をアップロード。ローカル MCP ではローカルファイルも可。

  • nano_generate_image

    画像生成を開始し、リクエスト ID と消費クレジットを返します。

  • nano_generate_video

    Web と同じオプションで動画生成を開始します。

  • nano_get_generation

    生成状況を最大 20 秒待って確認し、完了したら結果の URL を返します。

  • nano_list_generations

    最近の生成履歴をページ単位で取得します。

ターミナル派ですか?

同じ機能を通常のコマンドでも使えます。すべてのコマンドが --json に対応し、スクリプトや CI に組み込めます。

nanobanana model list --type text_to_image
nanobanana model get nano-banana-pro
nanobanana generate cost nano-banana-pro --prompt "a cozy reading nook" --resolution 2K
nanobanana generate create nano-banana-pro --prompt "a cozy reading nook" --resolution 2K --wait --out ./out
nanobanana generate create seedance --prompt "waves at sunset" --image ./frame.png --wait
nanobanana generate list --limit 20 --json

料金の仕組み

エージェントは別の API 残高ではなく、あなたの Nano Banana アカウントを使います。

Web と同じクレジット

生成ごとに nanobananana.com と同じ価格でアカウントのクレジットを消費します。失敗した生成は返金されます。

無制限はそのまま

Plus と Ultra では Z Image と FLUX.2 が引き続き無制限です。トークン経由では暴走するスクリプトを防ぐため 1 日 300 枚までです。

先に価格を確認

エージェントは生成前に nano_estimate_cost で見積もれます。解像度は明示的に選ぶ必要があり、勝手に高い設定を選びません。

クレジットが足りませんか? プランとクレジットパックを見る

よくある質問

トークンでできるのは生成、参照画像のアップロード、生成履歴と残高の確認だけです。パスワード変更、アカウント削除、プラン購入、サポートチケットの作成はできません。トークン経由のプロンプトも Web と同じコンテンツ審査を通ります。

Nano Banana をエージェントに

トークンを作成して設定を貼り付ければ、エディターから生成を始められます。

API トークンを作成
このページをシェア