Nano Banana MCP & CLI
Genera imágenes y vídeos con Nano Banana Pro, Seedream, GPT Image, Seedance y más, directamente en Claude Code, Cursor y Codex. Tu agente usa los créditos y el plan que ya tienes.
Configúralo en un solo paso
- Claude Code
- Cursor
- Codex
Pega este mensaje en tu agente y se encargará de instalar e iniciar sesión.
¿Prefieres configurarlo tú mismo? Ver opciones de configuración
Sin facturación de API aparte. Funciona con tu cuenta actual de Nano Banana.
Conecta tu agente
Elige tu cliente. El MCP local se ejecuta con npx y reutiliza tu sesión de la CLI. El MCP remoto necesita un token de API en la cabecera Authorization.
Ejecuta en tu terminal
claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcpAntes de usar una herramienta por primera vez, inicia sesión con npx -y @nanobananana/cli@latest auth login o define NANOBANANANA_TOKEN.
Empieza en tres pasos
Instala una vez, inicia sesión en el navegador y pídele a tu agente lo que necesites.
- 01
Añade el servidor MCP
Un comando añade Nano Banana a Claude Code. En Cursor y Codex basta con una breve entrada de configuración.
claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcp - 02
Inicia sesión
Se abre una ventana del navegador. Permite el acceso y la CLI guarda un token en tu equipo.
npx -y @nanobananana/cli@latest auth login - 03
Genera
Pide una imagen o un vídeo a tu agente, o ejecuta la CLI tú mismo. Los resultados se descargan en tu proyecto.
nanobanana generate create nano-banana-pro --prompt "a banana astronaut" --wait
Herramientas para tu agente
Nueve herramientas cubren todo el flujo, desde elegir modelo hasta descargar resultados.
nano_account_statusTu correo, plan, saldo de créditos, modelos ilimitados y cuántas imágenes ilimitadas te quedan hoy.
nano_list_modelsModelos de imagen y vídeo con una breve descripción y precio inicial, filtrables por tipo.
nano_get_modelTodos los parámetros de un modelo: tipos, valores permitidos, rangos y qué opciones son compatibles.
nano_estimate_costEl coste exacto en créditos de una combinación de parámetros, o por qué no es válida.
nano_upload_imageSube una imagen de referencia desde un enlace HTTPS, o un archivo local con el MCP local.
nano_generate_imageInicia una generación de imagen y devuelve el ID de la solicitud y los créditos cobrados.
nano_generate_videoInicia una generación de vídeo con las mismas opciones que la web.
nano_get_generationConsulta una generación esperando hasta 20 segundos y obtén las URL del resultado al terminar.
nano_list_generationsTus generaciones recientes, página a página.
¿Prefieres la terminal?
Todo funciona también con comandos normales. Todos admiten --json, así que encajan en scripts y 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 --jsonCómo funciona la facturación
Los agentes usan tu cuenta de Nano Banana, no un saldo de API aparte.
Los mismos créditos que en la web
Cada generación descuenta créditos al mismo precio que en nanobananana.com. Las generaciones fallidas se reembolsan.
Lo ilimitado sigue siéndolo
Con Plus y Ultra, Z Image y FLUX.2 siguen siendo ilimitados. Mediante un token tienen un tope de 300 imágenes al día para frenar scripts descontrolados.
Consulta el precio antes
Tu agente puede llamar a nano_estimate_cost antes de generar y debe elegir la resolución de forma explícita, sin escoger una más cara por ti.
¿Necesitas más créditos? Ver planes y paquetes de créditos
Preguntas frecuentes
Lleva Nano Banana a tu agente
Crea un token, pega la configuración y empieza a generar desde tu editor.
Crear un token de API