Per sviluppatori
Server MCP di Nano Banana Pro
Lascia che un assistente AI generi immagini e video per te. Aggiungi un solo server a Claude, Cursor o a qualsiasi altro client compatibile con il Model Context Protocol, poi descrivi ciò che ti serve con parole semplici.
Collegati in tre passaggi
Indirizzo del server
https://www.bananapro.site/api/mcp- 01
Crea una API key
Apri la pagina delle API key e creane una. L'assistente opera con questa chiave, quindi ogni generazione viene pagata con i crediti del tuo account.
Apri le API key - 02
Aggiungi il server al tuo client
Indica al client l'indirizzo del server riportato sopra e invia la chiave come token Bearer. Qui sotto trovi le impostazioni pronte per i client più diffusi.
- 03
Chiedi ciò che ti serve
Ad esempio: "Genera con Nano Banana Pro una foto prodotto 16:9 di una tazza in ceramica." L'assistente sceglie lo strumento, avvia l'attività e restituisce il link al risultato.
Impostazioni dei client
Sostituisci YOUR_API_KEY con la chiave che hai creato. Mantieni la chiave riservata: chiunque la possieda può spendere i tuoi crediti.
Claude Code (da eseguire in un terminale)
claude mcp add --transport http bananapro https://www.bananapro.site/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Cursor e altri client che leggono una configurazione JSON
{
"mcpServers": {
"bananapro": {
"url": "https://www.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Il server riceve le richieste tramite HTTP e risponde direttamente a ogni chiamata. L'accesso tramite browser non è previsto: si accede solo con la 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 |
Domande sul server MCP
Quanto costa una generazione tramite MCP?
Lo stesso che tramite API. Ogni chiamata a uno strumento esegue la richiesta API corrispondente con la tua chiave e i crediti vengono addebitati al tuo account. Un'attività non riuscita viene rimborsata allo stesso modo.
Quali modelli può usare l'assistente?
Tutti i modelli che l'API rende disponibili al tuo account. Lo strumento list_models restituisce l'elenco aggiornato, così l'assistente non dipende da una tabella fissa.
Posso usare immagini o clip personali come riferimento?
Sì, tramite link https pubblici. Il server non accetta il caricamento di file: ospita il file in un luogo raggiungibile e indica il suo indirizzo.
Dove finiscono i risultati?
L'assistente restituisce i link ai risultati nella conversazione. Le stesse attività compaiono in list_tasks e sono disponibili tramite API.
Come impedisco a un assistente di usare il mio account?
Elimina la API key nella pagina delle API key. Da quel momento le chiamate effettuate con quella chiave vengono rifiutate.
Preferisci chiamare l'API direttamente?
Il server MCP si basa sulla API pubblica. La documentazione elenca ogni endpoint, parametro e modello.