Para desarrolladores
Servidor MCP de Nano Banana Pro
Permita que su asistente de IA cree imágenes y vídeos en su nombre. Añada una dirección de servidor a un cliente compatible con Model Context Protocol, inicie sesión en su cuenta desde el navegador y describa lo que necesita con sus propias palabras.
Cómo funciona
Añada la dirección del servidor
Pegue la dirección siguiente en su cliente mediante su comando, su archivo de configuración o su campo de conector personalizado.
Dirección del servidor MCP
https://preview.bananapro.site/api/mcpInicie sesión y autorice el acceso
El cliente abre una ventana del navegador. Inicie sesión en su cuenta de Nano Banana Pro y pulse Permitir. No es necesario escribir ninguna clave de API.
Describa lo que necesita
Solicite una imagen o un vídeo en la conversación. El asistente elige una herramienta, inicia la tarea y devuelve los enlaces del resultado.
Configuración por cliente
Elija su cliente. Los nombres de los menús pueden variar ligeramente entre versiones.
Claude Code
- 1Ejecute el comando siguiente en un terminal para añadir el servidor.
- 2En Claude Code, abra /mcp, seleccione nanobanana y complete el inicio de sesión en el navegador.
claude mcp add --transport http nanobanana https://preview.bananapro.site/api/mcpCodex
- 1Ejecute el primer comando en un terminal para añadir el servidor.
- 2Ejecute el segundo comando. Se abrirá una ventana del navegador.
- 3Inicie sesión en su cuenta y pulse Permitir.
codex mcp add nanobanana --url https://preview.bananapro.site/api/mcpcodex mcp login nanobananaCursor y clientes con JSON
- 1Añada lo siguiente al archivo de configuración MCP del cliente, por ejemplo mcp.json en Cursor.
- 2Reinicie el cliente si es necesario. En el primer uso se abre una ventana del navegador: inicie sesión y pulse Permitir.
{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp"
}
}
}Conector personalizado
- 1Abra los ajustes del cliente y busque el campo para un conector personalizado o un servidor MCP remoto.
- 2Pegue la dirección del servidor que se muestra abajo y guarde.
- 3Elija Conectar, inicie sesión en su cuenta y pulse Permitir.
https://preview.bananapro.site/api/mcpClave de API
- 1Utilice este método solo con clientes que no pueden abrir un navegador.
- 2Cree una clave en la página de claves de API. Envíela en la cabecera del primer campo o, en una configuración JSON, añádala en headers como en el segundo campo.
- 3Guarde la clave en los ajustes de credenciales del cliente y no la comparta con nadie.
Authorization: Bearer YOUR_API_KEY{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Qué puede hacer el asistente
El servidor ofrece seis herramientas. Cuatro solo consultan información y no tienen coste; dos inician una generación y consumen créditos.
| Herramienta | Qué hace | Consume créditos |
|---|---|---|
| list_models | Enumera los modelos de imagen y video disponibles para tu cuenta y los tipos de solicitud que admite cada uno. | No |
| get_balance | Muestra cuántos créditos le quedan a la cuenta. | No |
| generate_image | Inicia la generación o la edición de una imagen a partir de un prompt y, opcionalmente, imágenes de referencia. | Sí |
| generate_video | Inicia la generación de un video a partir de un prompt, imágenes u otros materiales de referencia. | Sí |
| get_task | Consulta el estado de una generación y devuelve los enlaces del resultado cuando ha terminado. | No |
| list_tasks | Enumera las generaciones recientes, lo que resulta útil si has perdido el ID de una tarea. | No |
Herramienta de línea de comandos
El comando nanobanana crea imágenes y vídeos desde un terminal, desde scripts y desde aplicaciones de IA que pueden ejecutar comandos en su ordenador.
Requiere Node.js 22 o posterior en macOS o Linux.
Instale la CLI
Instale el paquete @nanobanana-pro/cli con npm.
npm install -g @nanobanana-pro/cliInicie sesión
Ejecute el comando, inicie sesión en su cuenta en la ventana del navegador y pulse Permitir.
nanobanana auth loginCompruebe la cuenta y los modelos
Este comando muestra tu saldo de créditos. El comando nanobanana models muestra los modelos disponibles.
nanobanana accountCree
Guarde en request.json una solicitud con el modelo y el prompt y ejecute el comando. La opción --wait lo mantiene en ejecución hasta que la tarea termina.
nanobanana create --input request.json --waitDescargue el resultado
Sustituya TASK_ID por el identificador de tarea que devolvió el comando anterior.
nanobanana download TASK_ID --output result.png
Véalo en acción
Pida una imagen en una sola frase. Su aplicación de IA redacta la solicitud, crea la imagen y guarda el archivo.
$ 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"] }
Modelos
El asistente puede usar los modelos de imagen y de vídeo que su cuenta puede usar en el sitio web y en la API.
- Pida al asistente que llame a list_models para obtener la lista actual de modelos y los tipos de solicitud que acepta cada uno.
- Cada modelo ofrece las mismas opciones que el sitio web. Un ajuste que un modelo no admite se rechaza con una explicación.
- Las imágenes y los vídeos de referencia deben ser enlaces https públicos. No se pueden subir archivos a través de MCP.
Créditos y facturación
- Iniciar sesión y las herramientas gratuitas (list_models, get_balance, get_task, list_tasks) no cuestan nada.
- generate_image y generate_video consumen los mismos créditos que el sitio web y la API, descontados del saldo de su cuenta.
- Una tarea que falla se reembolsa automáticamente.
- La suscripción al propio asistente de IA es independiente y la factura ese asistente.
Ejemplos de solicitudes
Tras conectar, envíe a su asistente una de estas solicitudes.
- ¿Qué modelos de imagen y de vídeo puedo usar? Muéstralos en una lista breve.
- Crea una foto de producto en 16:9 de una taza de cerámica sobre una mesa de madera.
- Convierte esta foto de paisaje en un vídeo de cinco segundos: https://example.com/photo.jpg
- Consulta el estado de mi última tarea y envíame el enlace del resultado.
Preguntas frecuentes
¿Necesito una clave de API?
No, si el cliente puede abrir un navegador: basta con iniciar sesión y pulsar Permitir. Solo hace falta una clave con los clientes que no pueden, como se explica en Clave de API.
¿Dónde veo o elimino una conexión?
Abra la página de claves de API. Cada conexión aparece allí con el nombre de su cliente, y al eliminarla se termina el acceso de ese cliente.
¿Cuánto cuesta una generación?
Los mismos créditos que en el sitio web y en la API. Una tarea que falla se reembolsa automáticamente.
¿Puedo usar mis propias imágenes o vídeos como referencia?
Sí, como enlaces https públicos. No hay subida de archivos: coloque el archivo en un lugar accesible e indique su dirección.
La conexión funciona, pero las herramientas no aparecen. ¿Qué hago?
Compruebe que el inicio de sesión se completó y que el cliente muestra el servidor como conectado. Después inicie una conversación nueva, ya que algunos clientes cargan las herramientas solo al comenzar.
¿Dónde encuentro los resultados?
El asistente devuelve los enlaces del resultado en la conversación. Las tareas anteriores pueden volver a listarse con list_tasks.
¿Prefieres llamar tú mismo a la API?
El servidor MCP se basa en la API pública. La documentación recoge todos los endpoints, parámetros y modelos.