Nano Banana MCP para Claude Code: configuración, skill y precios

Tu agente de programación puede crear la base de una landing page en un minuto y luego quedarse parado porque la imagen principal aún no existe. Un servidor Nano Banana MCP cierra esa brecha. Lo registras una vez en Claude Code, pides una imagen en lenguaje natural y el archivo aparece en la carpeta de tu proyecto mientras tú sigues trabajando. A continuación tienes los comandos exactos de configuración, un archivo de skill reutilizable, una lista de verificación de seguridad y los precios por imagen publicados en octubre de 2026, para que decidas en diez minutos si merece un sitio en tu conjunto de herramientas.

Qué es realmente Nano Banana

«Nano Banana» empezó como el apodo del modelo Gemini 2.5 Flash Image de Google y se quedó como la marca de toda la línea. Estos son los cuatro nombres que verás en las listas de precios:

Por qué integrarlo en Claude Code

Claude Code ya lee tu repositorio, edita archivos y ejecuta comandos. Lo que no puede hacer es pintar. Un servidor de imágenes le da una herramienta de generate_image, así que la sesión que escribe el componente también produce la imagen principal, la tarjeta para redes sociales y la ilustración de estado vacío, y luego las conecta por ruta de archivo. Sin cambiar de pestaña, sin carpeta de descargas, sin renombrar image (3).png.

Tareas típicas que encajan:

• Imágenes de portada y de blog generadas junto a la página que las usa
• Maquetas de producto colocadas en distintos espacios, temporadas e iluminaciones
• Ediciones de fotos existentes: cambiar un fondo, corregir la luz, quitar una distracción
• Arte provisional para prototipos que se reemplaza después

Lo que hace bien y lo que hace mal

Sigue de cerca los prompts largos y descriptivos, mantiene un sujeto estable a lo largo de varias ediciones y renderiza con legibilidad textos cortos. Nano Banana 2 también puede basar un prompt en búsquedas web en tiempo real, lo que resulta útil cuando una imagen debe coincidir con algo que ocurrió esta semana.

Es más débil en tipografía densa, en colores exactos de marca y en mantener el mismo rostro idéntico en cincuenta imágenes. Trata el primer resultado como un borrador y reserva tiempo para una segunda pasada.

Cómo funciona la conexión MCP

El Model Context Protocol es un estándar abierto que permite a un cliente de IA llamar a herramientas externas. Intervienen tres piezas:

1. Claude Code, el cliente que decide cuándo hace falta una herramienta.
2. El servidor MCP, un pequeño proceso de Node o Python en tu equipo que Claude Code lanza cuando lo necesita.
3. La API de Gemini de Google, donde se genera realmente la imagen.

Pides una imagen. Claude Code llama a una herramienta con un nombre como mcp__nanobanana__generate_image. El servidor envía tu prompt a un modelo de imagen de Gemini, guarda el resultado en disco y responde con una ruta de archivo. Ese último paso importa más de lo que parece.

💡 Por qué las rutas son mejores que los datos sin procesar: Claude Code limita cuánta salida puede devolver una herramienta MCP (puedes subir el límite con la variable de entorno MAX_MCP_OUTPUT_TOKENS). Una imagen en base64 consumiría el contexto muy rápido. El listado de @nanobanana/mcp indica que devuelve rutas de archivo, lo que mantiene tu sesión ligera.

Qué servidor elegir

Existen varios servidores de la comunidad. Ninguno proviene de Anthropic ni de Google.

Los ejemplos siguientes usan @nanobanana/mcp porque es el más sencillo: tres herramientas y una variable. Los demás funcionan igual, con otro nombre de paquete y otra variable.

Configuración en cinco minutos

Obtén un token de Gemini

Abre la página de API en Google AI Studio (aistudio.google.com/apikey) y crea un token. Existe un nivel gratuito, pero los resúmenes de precios señalan que Google puede usar las generaciones del nivel gratuito para mejorar sus productos. Usa un proyecto de pago para trabajos de clientes o imágenes privadas.

Registra el servidor

En macOS, Linux o WSL, ejecuta:

claude mcp add nanobanana -e GEMINI_API_KEY=your_token_here -- npx -y @nanobanana/mcp

Copiar prompt

En Windows nativo necesitas el envoltorio cmd /c para que Claude Code pueda lanzar npx:

claude mcp add nanobanana -e GEMINI_API_KEY=your_token_here -- cmd /c npx -y @nanobanana/mcp

Copiar prompt

También eliges un ámbito. Local es el predeterminado y se aplica a ti en este proyecto. Añade --scope project para escribir un .mcp.json compartido que use todo el equipo, o --scope user para que el servidor esté disponible en todos los proyectos.

💡 Pon todas las opciones antes del doble guion. Lo que va después se envía a npx, no a Claude Code, y es el motivo más común por el que un servidor nuevo no se conecta.

Comprueba la conexión

Ejecuta claude mcp list, luego abre Claude Code y escribe /mcp. La entrada nanobanana debería aparecer como connected. Ahora pruébalo con una solicitud real:

Genera una foto de 16:9 de un plátano maduro sobre una mesa de madera con luz de ventana por la mañana, y guárdala en public/images/test.jpg

Si devuelve una ruta de archivo y la imagen se abre, la conexión funciona. La primera llamada puede tardar más porque npx descarga el paquete; las siguientes arrancan más rápido.

Mantén los secretos fuera del chat

Tu token debe estar en una variable de entorno y en ningún otro lugar. Nunca lo pegues en un prompt, en un archivo de skill ni en una configuración subida al repositorio. Para un .mcp.json compartido, referencia la variable en lugar del valor:

{
  "mcpServers": {
    "nanobanana": {
      "command": "npx",
      "args": ["-y", "@nanobanana/mcp"],
      "env": { "GEMINI_API_KEY": "${GEMINI_API_KEY}" }
    }
  }
}

Copiar prompt

Claude Code expande la variable desde tu shell cuando inicia el servidor, así que cada compañero usa su propio token y el repositorio queda limpio.

💡 Estos servidores son proyectos de la comunidad. npx -y descarga y ejecuta código con tu token en su entorno. Abre el repositorio, revisa al mantenedor y los commits recientes, y fija una versión concreta (@nanobanana/mcp@<version>) antes de confiar en él.

Crea un skill alrededor de él

El servidor le da a Claude Code la capacidad de dibujar. Un skill le indica cómo quieres que dibuje las cosas. Un skill es una carpeta que contiene un archivo SKILL.md, guardada en .claude/skills/nano-banana/ para un proyecto o en ~/.claude/skills/nano-banana/ para todos. El archivo empieza con un breve encabezado YAML con dos campos, name y description. Claude lee la descripción para decidir cuándo se aplica el skill y carga el cuerpo solo entonces, así que el skill apenas cuesta nada hasta que hace falta.

Qué va dentro de SKILL.md

Escribe la description como un disparador: «Genera o edita imágenes con el servidor MCP de Nano Banana. Úsalo cuando el usuario pida una imagen principal, miniatura, maqueta o ilustración.» Después pon tus reglas en el cuerpo:

# Nano Banana image rules

1. Write one prompt before calling the tool: subject, action, setting, camera and lens, lighting, mood.
2. Describe what should be in the frame. Do not list things to avoid.
3. Use 16:9 for hero images and 1:1 for thumbnails.
4. Save files in public/images/ with a kebab-case name that matches the page slug.
5. Generate one image, check it, then ask before making variations.
6. Never request more than 4 images in one turn without confirmation.
7. Add descriptive alt text wherever an image is used.
8. Never print, log, or commit the API token.

Copiar prompt

Las reglas 5 y 6 son las más importantes. Son tus frenos de costo, y la siguiente sección muestra por qué.

Una sesión real se ve así: dices «añade una imagen principal a la página de precios». Claude Code lee la página, carga el skill, escribe un único prompt detallado, llama a generate_image, recibe una ruta y edita la etiqueta <img> con texto alternativo. Revisas una imagen en lugar de ocho.

Una fórmula de prompt que funciona

Usa este orden: sujeto, acción, escenario, iluminación, cámara, textura. Por ejemplo:

Un panadero sacando una bandeja de pan de masa madre de un horno de piedra, con harina en los antebrazos, cocina rústica con cacerolas de cobre, luz de ventana cálida desde la izquierda, lente de 50 mm a f/2, profundidad de campo poco profunda, textura visible de la corteza, color natural.

Limita el texto dentro de la imagen a una o dos palabras. En las ediciones, pide un solo cambio por instrucción («haz el cielo nublado»), revisa el resultado y luego pide el siguiente.

Lo que realmente cuesta

El modelo de imagen es solo una línea de tu factura. El uso de Claude Code se factura aparte a través de tu plan de Anthropic o del uso de la API, y Google factura el lado de Gemini.

Precios por imagen según el modelo

Los rastreadores públicos de precios muestran estas cifras a octubre de 2026:

Los precios cambian, así que confírmalos en la página de precios de Google antes de fijar un presupuesto. Algunos rastreadores también cobran un cargo por cada imagen de referencia subida, lo que significa que los trabajos de edición intensiva cuestan más de lo que sugiere el precio de salida.

Un presupuesto mensual de 120 imágenes

Imagina un blog que publica 20 artículos al mes con 6 imágenes cada uno:

Estos totales asumen que conservas todas las imágenes. Si descartas la mitad, duplícalos. Tres hábitos mantienen el número bajo:

• Borrador barato, acabado premium. Itera con el modelo original o Lite y renderiza solo la ganadora en Pro.
• Agrupa lo que pueda esperar. El precio por lote es la mitad de la tarifa estándar en los rastreadores de arriba.
• Limita el bucle. Las reglas 5 y 6 de tu skill evitan que Claude genere una docena de variaciones no solicitadas.

Cómo solucionar problemas comunes

El servidor muestra failed o no aparece

Revisa estos puntos en orden:

1. Ejecuta claude mcp get nanobanana para ver el comando y el entorno que Claude Code guardó.
2. Ejecuta node --version. El servidor necesita Node instalado para que npx funcione.
3. En Windows nativo, asegúrate de que el comando sea cmd /c npx.
4. Vuelve a añadir el servidor con la opción -e antes del doble guion.
5. Reinicia tu sesión de Claude Code. Los servidores se cargan al arrancar.

Las imágenes llegan, pero se ven mal

Los prompts vagos dan resultados de banco de imágenes, así que añade un lente, una dirección de luz y un detalle de textura. El texto deformado significa demasiadas palabras: recórtalo a una o dos. Una forma incorrecta suele indicar que la relación de aspecto nunca llegó a la herramienta, así que indícala en la solicitud. Cuando una edición se desvía, cambia una cosa a la vez y guarda la versión buena antes de la siguiente pasada.

Cómo usar Nano Banana en PicassoIA

Si prefieres evitar el token y la terminal, Nano Banana 2 funciona en tu navegador en PicassoIA. La página del modelo indica generaciones ilimitadas sin créditos por generación, lo que la convierte en un lugar práctico para probar prompts antes de pagar llamadas a la API. Los ejemplos ejecutados en esa página tardaron entre 20 y 28 segundos cada uno, así que iterar es barato en tiempo tanto como en dinero.

Nano Banana 2 paso a paso

1. Abre la página del modelo y haz clic en el cuadro de prompt.
2. Escribe la escena en oraciones completas: sujeto, escenario, luz, lente.
3. Opcionalmente, sube hasta 14 imágenes de referencia para combinar estilos o mantener un personaje coherente.
4. Elige una relación de aspecto. La predeterminada es match_input_image, y hay 15 opciones disponibles, entre ellas 16:9, 9:16, 4:5 y 21:9.
5. Elige una resolución: 1K por defecto, con 2K y 4K disponibles. Los ajustes más altos tardan más.
6. Selecciona salida jpg o png.
7. Activa Google Search o Image Search cuando la imagen deba reflejar hechos actuales o lugares reales.
8. Genera y luego refina escribiendo una instrucción de seguimiento como «haz el fondo nublado» en lugar de reescribir todo el prompt.

Cuándo elegir Pro

Nano Banana Pro también acepta 14 imágenes de referencia, genera en 1K, 2K (el valor predeterminado) o 4K, y añade un ajuste safety_filter_level. Su página lo presenta como de uso gratuito, y sus ejemplos tardaron entre 18 y 113 segundos, así que espera que sea más lento. Recurre a él cuando una imagen principal final necesite máximo detalle, y usa Nano Banana para ediciones rápidas.

También puedes delegar la escritura de prompts. Un modelo de chat como Claude Sonnet 5 puede convertir una idea aproximada en sujeto, acción y fórmula de iluminación, mientras que Claude Opus 4.7 va mejor con encargos más largos. Cuando una escena deba moverse, describe el movimiento para un clip corto en Veo 3.1 Fast o Gemini Omni 1.1.

Prueba tu primera imagen hoy

Ya tienes el ciclo completo: un token, un comando claude mcp add, un skill que mantiene los prompts coherentes y un presupuesto que puedes defender. La forma más rápida de notar la diferencia entre modelos es pasar el mismo prompt por cada uno.

Abre PicassoIA, elige Nano Banana 2 y pega el prompt del panadero de arriba. Luego cambia un detalle, el lente o la luz, y genera de nuevo. Diez minutos de eso enseñarán a tu archivo de skill más que cualquier manual. Empieza con una sola escena que realmente necesites esta semana y construye desde ahí.