Nano Banana MCP & CLI
Genera immagini e video con Nano Banana Pro, Seedream, GPT Image, Seedance e altri, direttamente in Claude Code, Cursor e Codex. Il tuo agente usa i crediti e il piano che hai già.
Configuralo in un solo passaggio
- Claude Code
- Cursor
- Codex
Incolla questo messaggio nel tuo agente: installerà tutto e ti farà accedere.
Preferisci configurarlo da solo? Vedi le opzioni di configurazione
Nessuna fatturazione API separata. Funziona con il tuo account Nano Banana attuale.
Collega il tuo agente
Scegli il tuo client. L’MCP locale gira tramite npx e riusa l’accesso della CLI. L’MCP remoto richiede un token API nell’intestazione Authorization.
Esegui nel terminale
claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcpPrima del primo utilizzo di uno strumento, accedi con npx -y @nanobananana/cli@latest auth login oppure imposta NANOBANANANA_TOKEN.
Inizia in tre passaggi
Installa una volta, accedi dal browser e poi chiedi al tuo agente ciò che ti serve.
- 01
Aggiungi il server MCP
Un solo comando aggiunge Nano Banana a Claude Code. Per Cursor e Codex basta una breve voce di configurazione.
claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcp - 02
Accedi
Si apre una finestra del browser. Consenti l’accesso e la CLI salva un token sul tuo computer.
npx -y @nanobananana/cli@latest auth login - 03
Genera
Chiedi al tuo agente un’immagine o un video, oppure avvia tu la CLI. I risultati vengono scaricati nel progetto.
nanobanana generate create nano-banana-pro --prompt "a banana astronaut" --wait
Gli strumenti del tuo agente
Nove strumenti mirati coprono l’intero flusso, dalla scelta del modello al download dei risultati.
nano_account_statusEmail, piano, saldo crediti, modelli illimitati e quante immagini illimitate restano oggi.
nano_list_modelsModelli di immagini e video con breve descrizione e prezzo di partenza, filtrabili per tipo.
nano_get_modelTutti i parametri di un modello: tipi, valori ammessi, intervalli e opzioni compatibili.
nano_estimate_costIl costo esatto in crediti di una combinazione di parametri, o il motivo per cui non è valida.
nano_upload_imageCarica un’immagine di riferimento da un link HTTPS, o un file locale con l’MCP locale.
nano_generate_imageAvvia una generazione di immagini e restituisce l’ID della richiesta e i crediti addebitati.
nano_generate_videoAvvia una generazione video con le stesse opzioni del sito.
nano_get_generationControlla una generazione attendendo fino a 20 secondi e restituisce gli URL dei risultati quando è pronta.
nano_list_generationsLe tue generazioni recenti, pagina per pagina.
Preferisci il terminale?
Tutto funziona anche come normali comandi. Ogni comando supporta --json, quindi si integra in script e 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 --jsonCome funziona la fatturazione
Gli agenti usano il tuo account Nano Banana, non un saldo API separato.
Gli stessi crediti del sito
Ogni generazione scala crediti dal tuo account allo stesso prezzo di nanobananana.com. Le generazioni fallite vengono rimborsate.
L’illimitato resta illimitato
Con Plus e Ultra, Z Image e FLUX.2 restano illimitati. Tramite token hanno un limite di 300 immagini al giorno per fermare gli script fuori controllo.
Controlla prima il prezzo
Il tuo agente può chiamare nano_estimate_cost prima di generare e deve scegliere la risoluzione in modo esplicito, senza sceglierne una più costosa al posto tuo.
Ti servono più crediti? Vedi piani e pacchetti di crediti
Domande frequenti
Porta Nano Banana nel tuo agente
Crea un token, incolla la configurazione e inizia a generare dal tuo editor.
Crea un token API