Servidor MCP y CLI

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 mcp

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

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

    Tu correo, plan, saldo de créditos, modelos ilimitados y cuántas imágenes ilimitadas te quedan hoy.

  • nano_list_models

    Modelos de imagen y vídeo con una breve descripción y precio inicial, filtrables por tipo.

  • nano_get_model

    Todos los parámetros de un modelo: tipos, valores permitidos, rangos y qué opciones son compatibles.

  • nano_estimate_cost

    El coste exacto en créditos de una combinación de parámetros, o por qué no es válida.

  • nano_upload_image

    Sube una imagen de referencia desde un enlace HTTPS, o un archivo local con el MCP local.

  • nano_generate_image

    Inicia una generación de imagen y devuelve el ID de la solicitud y los créditos cobrados.

  • nano_generate_video

    Inicia una generación de vídeo con las mismas opciones que la web.

  • nano_get_generation

    Consulta una generación esperando hasta 20 segundos y obtén las URL del resultado al terminar.

  • nano_list_generations

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

Có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

Un token solo puede generar, subir imágenes de referencia y consultar tus generaciones y tu saldo. No puede cambiar tu contraseña, eliminar tu cuenta, comprar planes ni abrir tickets de soporte. Los prompts enviados con un token pasan por la misma moderación de contenido que en la web.

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
Compartir esta página