開発者向け
Nano Banana Pro MCP サーバー
AI アシスタントに画像や動画の生成を任せられます。Model Context Protocol に対応したクライアントにサーバーのアドレスを一つ追加し、ブラウザでアカウントにログインしたあと、やりたいことを自然な言葉で伝えてください。
利用の流れ
サーバーのアドレスを追加
下のアドレスを、クライアントのコマンド、設定ファイル、またはカスタムコネクターの入力欄に貼り付けます。
MCP サーバーのアドレス
https://preview.bananapro.site/api/mcpログインして許可
クライアントがブラウザーのウィンドウを開きます。Nano Banana Pro のアカウントにログインし、「許可」を押してください。API キーの入力は不要です。
やりたいことを伝える
会話の中で画像や動画を依頼します。アシスタントがツールを選んでタスクを開始し、結果のリンクを返します。
クライアント別の設定
お使いのクライアントを選んでください。メニューの名称はバージョンによって多少異なる場合があります。
Claude Code
- 1ターミナルで下のコマンドを実行し、サーバーを追加します。
- 2Claude Code で /mcp を開き、nanobanana を選択して、ブラウザーでログインを完了します。
claude mcp add --transport http nanobanana https://preview.bananapro.site/api/mcpCodex
- 1ターミナルで最初のコマンドを実行し、サーバーを追加します。
- 2二つ目のコマンドを実行すると、ブラウザーのウィンドウが開きます。
- 3アカウントにログインし、「許可」を押します。
codex mcp add nanobanana --url https://preview.bananapro.site/api/mcpcodex mcp login nanobananaCursor と JSON 設定のクライアント
- 1クライアントの MCP 設定ファイル(Cursor では mcp.json など)に次の内容を追加します。
- 2必要に応じてクライアントを再起動します。初回の利用時にブラウザーが開くので、ログインして「許可」を押してください。
{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp"
}
}
}カスタムコネクター
- 1クライアントの設定を開き、カスタムコネクターまたはリモート MCP サーバーの入力欄を探します。
- 2下に表示されているサーバーのアドレスを貼り付けて保存します。
- 3「接続」を選び、アカウントにログインして「許可」を押します。
https://preview.bananapro.site/api/mcpAPI キー
- 1この方法は、ブラウザーを開けないクライアントでのみ使用してください。
- 2API キーのページでキーを作成します。最初の欄のヘッダーで送信するか、JSON 設定では二つ目の欄のように headers に追加します。
- 3キーはクライアントの認証情報の設定に保管し、他の人に共有しないでください。
Authorization: Bearer YOUR_API_KEY{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}アシスタントにできること
サーバーには6つのツールがあります。4つは情報の取得のみでクレジットを消費せず、2つは生成を開始するためクレジットを消費します。
| ツール | 機能 | クレジット消費 |
|---|---|---|
| list_models | お客様のアカウントで利用できる画像・動画モデルと、各モデルが受け付けるリクエストの種類を一覧表示します。 | なし |
| get_balance | アカウントに残っているクレジット数を表示します。 | なし |
| generate_image | プロンプトと任意の参照画像から、画像の生成または編集を開始します。 | あり |
| generate_video | プロンプト、画像、その他の参照メディアから動画の生成を開始します。 | あり |
| get_task | 生成の状況を確認し、完了している場合は結果のリンクを返します。 | なし |
| list_tasks | 最近の生成を一覧表示します。タスク ID を紛失した場合に役立ちます。 | なし |
コマンドラインツール
nanobanana コマンドで、ターミナルやスクリプト、お使いのコンピューターでコマンドを実行できる AI アプリから、画像と動画を生成できます。
macOS または Linux と、Node.js 22 以降が必要です。
CLI をインストール
npm でパッケージ @nanobanana-pro/cli をインストールします。
npm install -g @nanobanana-pro/cliログイン
コマンドを実行し、開いたブラウザーでアカウントにログインして「許可」を押します。
nanobanana auth loginアカウントとモデルを確認
このコマンドでクレジット残高を確認できます。nanobanana models を実行すると、利用できるモデルが表示されます。
nanobanana account生成を開始
モデルとプロンプトを request.json に保存し、コマンドを実行します。--wait を付けると、タスクが完了するまで待機します。
nanobanana create --input request.json --wait結果をダウンロード
TASK_ID は、前のコマンドが返したタスク ID に置き換えてください。
nanobanana download TASK_ID --output result.png
実行例
一文で画像を依頼するだけです。AI アプリがリクエストを作成し、画像を生成してファイルに保存します。
$ nanobanana create --input request.json --wait
Task TASK_ID submitted; waiting for the result…
{ "status": "completed" }
$ nanobanana download TASK_ID --output result.png
{ "files": ["result.png"] }
利用できるモデル
アシスタントは、ウェブサイトや API でお使いのアカウントが利用できる画像・動画モデルを使えます。
- アシスタントに list_models を呼び出させると、現在のモデル一覧と、各モデルが受け付けるリクエストの種類を確認できます。
- 各モデルで選べる項目はウェブサイトと同じです。モデルが対応していない設定は、理由とともに受け付けられません。
- 参照用の画像や動画は、公開されている https のリンクである必要があります。MCP ではファイルをアップロードできません。
クレジットと課金
- ログインと無料のツール(list_models、get_balance、get_task、list_tasks)にクレジットはかかりません。
- generate_image と generate_video は、ウェブサイトや API と同じクレジットをアカウントの残高から消費します。
- 失敗したタスクは自動的に返金されます。
- AI アシスタント自体の契約は別で、そのアシスタントから請求されます。
依頼の例
接続したら、次のような依頼をアシスタントに送ってみてください。
- 使える画像モデルと動画モデルを、短い一覧で教えてください。
- 木のテーブルに置かれた陶器のマグカップの商品写真を、16:9 で作成してください。
- この風景写真から 5 秒の動画を作成してください:https://example.com/photo.jpg
- 直近のタスクの状況を確認して、結果のリンクを送ってください。
よくある質問
API キーは必要ですか。
ブラウザーを開けるクライアントでは不要です。ログインして「許可」を押すだけで利用できます。キーが必要なのは、ブラウザーを開けないクライアントのみで、手順は「API キー」に記載しています。
接続の確認や削除はどこでできますか。
API キーのページを開いてください。各接続がクライアント名で表示され、削除するとそのクライアントのアクセスは終了します。
生成にはどれくらいのクレジットがかかりますか。
ウェブサイトや API と同じクレジットです。失敗したタスクは自動的に返金されます。
自分の画像や動画を参照として使えますか。
はい。公開されている https のリンクとして指定してください。ファイルのアップロードはできないため、アクセスできる場所に置いてそのアドレスを渡します。
接続できているのにツールが表示されません。
ログインが完了していることと、クライアント上でサーバーが接続済みと表示されていることを確認してください。そのうえで新しい会話を始めてください。クライアントによっては、会話の開始時にしかツールを読み込みません。
結果はどこで確認できますか。
アシスタントが会話の中で結果のリンクを返します。以前のタスクは list_tasks で再び一覧にできます。
API を自分で呼び出したい場合は
MCP サーバーは公開 API をもとに構築されています。ドキュメントには、すべてのエンドポイント、パラメーター、モデルを掲載しています。