Server MCP e CLI

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 mcp

Prima 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.

  1. 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
  2. 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
  3. 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_status

    Email, piano, saldo crediti, modelli illimitati e quante immagini illimitate restano oggi.

  • nano_list_models

    Modelli di immagini e video con breve descrizione e prezzo di partenza, filtrabili per tipo.

  • nano_get_model

    Tutti i parametri di un modello: tipi, valori ammessi, intervalli e opzioni compatibili.

  • nano_estimate_cost

    Il costo esatto in crediti di una combinazione di parametri, o il motivo per cui non è valida.

  • nano_upload_image

    Carica un’immagine di riferimento da un link HTTPS, o un file locale con l’MCP locale.

  • nano_generate_image

    Avvia una generazione di immagini e restituisce l’ID della richiesta e i crediti addebitati.

  • nano_generate_video

    Avvia una generazione video con le stesse opzioni del sito.

  • nano_get_generation

    Controlla una generazione attendendo fino a 20 secondi e restituisce gli URL dei risultati quando è pronta.

  • nano_list_generations

    Le 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 --json

Come 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

Un token può solo generare, caricare immagini di riferimento e leggere generazioni e saldo. Non può cambiare la password, eliminare l’account, acquistare piani o aprire ticket di assistenza. I prompt inviati con un token passano per la stessa moderazione dei contenuti del sito.

Porta Nano Banana nel tuo agente

Crea un token, incolla la configurazione e inizia a generare dal tuo editor.

Crea un token API
Condividi questa pagina