Per sviluppatori
Server MCP di Nano Banana Pro
Lasci che il suo assistente IA crei immagini e video per suo conto. Aggiunga un indirizzo di server a un client compatibile con il Model Context Protocol, acceda al suo account dal browser e descriva ciò che le serve con parole sue.
Come funziona
Aggiunga l’indirizzo del server
Incolli l’indirizzo qui sotto nel client, usando il suo comando, il file di configurazione o il campo del connettore personalizzato.
Indirizzo del server MCP
https://preview.bananapro.site/api/mcpAcceda e autorizzi l’accesso
Il client apre una finestra del browser. Acceda al suo account Nano Banana Pro e faccia clic su Consenti. Non occorre digitare alcuna chiave API.
Descriva ciò che le serve
Chieda un’immagine o un video nella conversazione. L’assistente sceglie uno strumento, avvia l’attività e restituisce i link del risultato.
Configurazione per client
Scelga il suo client. I nomi dei menu possono variare leggermente tra le versioni.
Claude Code
- 1Esegua il comando seguente in un terminale per aggiungere il server.
- 2In Claude Code apra /mcp, selezioni nanobanana e completi l’accesso nel browser.
claude mcp add --transport http nanobanana https://preview.bananapro.site/api/mcpCodex
- 1Esegua il primo comando in un terminale per aggiungere il server.
- 2Esegua il secondo comando. Si apre una finestra del browser.
- 3Acceda al suo account e faccia clic su Consenti.
codex mcp add nanobanana --url https://preview.bananapro.site/api/mcpcodex mcp login nanobananaCursor e client con JSON
- 1Aggiunga quanto segue al file di configurazione MCP del client, ad esempio mcp.json in Cursor.
- 2Riavvii il client se necessario. Al primo utilizzo si apre una finestra del browser: acceda e faccia clic su Consenti.
{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp"
}
}
}Connettore personalizzato
- 1Apra le impostazioni del client e individui il campo per un connettore personalizzato o un server MCP remoto.
- 2Incolli l’indirizzo del server mostrato qui sotto e salvi.
- 3Scelga Connetti, acceda al suo account e faccia clic su Consenti.
https://preview.bananapro.site/api/mcpChiave API
- 1Usi questo metodo solo con i client che non possono aprire un browser.
- 2Crei una chiave nella pagina delle chiavi API. La invii nell’intestazione del primo campo oppure, in una configurazione JSON, la aggiunga sotto headers come nel secondo campo.
- 3Conservi la chiave nelle impostazioni delle credenziali del client e non la condivida con nessuno.
Authorization: Bearer YOUR_API_KEY{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Cosa può fare l'assistente
Il server mette a disposizione sei strumenti. Quattro si limitano a leggere informazioni e sono gratuiti; due avviano una generazione e consumano crediti.
| Strumento | Cosa fa | Consuma crediti |
|---|---|---|
| list_models | Elenca i modelli di immagini e video disponibili per il tuo account e i tipi di richiesta accettati da ciascuno. | No |
| get_balance | Mostra quanti crediti restano sull'account. | No |
| generate_image | Avvia la generazione o la modifica di un'immagine a partire da un prompt e, facoltativamente, da immagini di riferimento. | Sì |
| generate_video | Avvia la generazione di un video a partire da un prompt, da immagini o da altri contenuti di riferimento. | Sì |
| get_task | Controlla lo stato di una generazione e, a elaborazione conclusa, restituisce i link ai risultati. | No |
| list_tasks | Elenca le generazioni recenti, utile se hai perso l'ID di un'attività. | No |
Strumento da riga di comando
Il comando nanobanana crea immagini e video da un terminale, da script e da app IA in grado di eseguire comandi sul suo computer.
Richiede Node.js 22 o successivo su macOS o Linux.
Installi la CLI
Installi il pacchetto @nanobanana-pro/cli con npm.
npm install -g @nanobanana-pro/cliAcceda
Esegua il comando, poi acceda al suo account nella finestra del browser e faccia clic su Consenti.
nanobanana auth loginVerifichi l’account e i modelli
Questo comando mostra il saldo dei crediti. Il comando nanobanana models elenca i modelli disponibili.
nanobanana accountCrei
Salvi in request.json una richiesta con il modello e il prompt ed esegua il comando. L’opzione --wait lo mantiene in esecuzione fino al termine dell’attività.
nanobanana create --input request.json --waitScarichi il risultato
Sostituisca TASK_ID con l’ID dell’attività restituito dal comando precedente.
nanobanana download TASK_ID --output result.png
Lo veda in azione
Chieda un’immagine in una sola frase. La sua app IA scrive la richiesta, crea l’immagine e salva il file.
$ 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"] }
Modelli
L’assistente può usare i modelli di immagini e di video che il suo account può usare sul sito e nell’API.
- Chieda all’assistente di richiamare list_models per ottenere l’elenco aggiornato dei modelli e i tipi di richiesta accettati da ciascuno.
- Ogni modello offre le stesse opzioni del sito. Un’impostazione non supportata da un modello viene rifiutata con una spiegazione.
- Le immagini e i video di riferimento devono essere link https pubblici. Non è possibile caricare file tramite MCP.
Crediti e fatturazione
- L’accesso e gli strumenti gratuiti (list_models, get_balance, get_task, list_tasks) non costano nulla.
- generate_image e generate_video consumano gli stessi crediti del sito e dell’API, detratti dal saldo del suo account.
- Un’attività non riuscita viene rimborsata automaticamente.
- L’abbonamento all’assistente IA stesso è separato e viene fatturato da quell’assistente.
Esempi di richieste
Dopo la connessione, invii all’assistente una di queste richieste.
- Quali modelli di immagini e di video posso usare? Mostrameli in un breve elenco.
- Crea una foto di prodotto in 16:9 di una tazza in ceramica su un tavolo di legno.
- Trasforma questa foto di paesaggio in un video di cinque secondi: https://example.com/photo.jpg
- Controlla lo stato della mia ultima attività e inviami il link del risultato.
Domande frequenti
Serve una chiave API?
No, con i client che possono aprire un browser: basta accedere e fare clic su Consenti. La chiave serve solo ai client che non possono farlo, come descritto in Chiave API.
Dove vedo o rimuovo una connessione?
Apra la pagina delle chiavi API. Ogni connessione compare lì con il nome del suo client e, rimuovendola, l’accesso di quel client termina.
Quanto costa una generazione?
Gli stessi crediti del sito e dell’API. Un’attività non riuscita viene rimborsata automaticamente.
Posso usare le mie immagini o i miei video come riferimento?
Sì, come link https pubblici. Non è previsto il caricamento di file: collochi il file in un luogo raggiungibile e indichi il suo indirizzo.
La connessione funziona, ma gli strumenti non compaiono. Cosa devo fare?
Verifichi che l’accesso sia stato completato e che il client mostri il server come connesso. Poi avvii una nuova conversazione, perché alcuni client caricano gli strumenti solo all’inizio.
Dove trovo i risultati?
L’assistente restituisce i link del risultato nella conversazione. Le attività precedenti possono essere elencate di nuovo con list_tasks.
Preferisci chiamare l'API direttamente?
Il server MCP si basa sulla API pubblica. La documentazione elenca ogni endpoint, parametro e modello.