Nano Banana MCP & CLI
Gere imagens e vídeos com Nano Banana Pro, Seedream, GPT Image, Seedance e outros, diretamente no Claude Code, Cursor e Codex. O seu agente usa os créditos e o plano que você já tem.
Configure em um único passo
- Claude Code
- Cursor
- Codex
Cole esta mensagem no seu agente e ele fará a instalação e o login por você.
Prefere configurar você mesmo? Ver opções de configuração
Sem cobrança de API separada. Funciona com a sua conta Nano Banana atual.
Conecte o seu agente
Escolha o seu cliente. O MCP local roda via npx e reaproveita o login da CLI. O MCP remoto precisa de um token de API no cabeçalho Authorization.
Execute no terminal
claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcpAntes de usar uma ferramenta pela primeira vez, entre com npx -y @nanobananana/cli@latest auth login ou defina NANOBANANANA_TOKEN.
Comece em três passos
Instale uma vez, entre pelo navegador e peça ao seu agente o que precisar.
- 01
Adicione o servidor MCP
Um comando adiciona o Nano Banana ao Claude Code. No Cursor e no Codex basta uma curta entrada de configuração.
claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcp - 02
Entre
Abre-se uma janela do navegador. Permita o acesso e a CLI guarda um token no seu computador.
npx -y @nanobananana/cli@latest auth login - 03
Gere
Peça uma imagem ou vídeo ao seu agente, ou execute a CLI você mesmo. Os resultados são baixados para o seu projeto.
nanobanana generate create nano-banana-pro --prompt "a banana astronaut" --wait
Ferramentas para o seu agente
Nove ferramentas cobrem todo o fluxo, da escolha do modelo ao download dos resultados.
nano_account_statusO seu e-mail, plano, saldo de créditos, modelos ilimitados e quantas imagens ilimitadas restam hoje.
nano_list_modelsModelos de imagem e vídeo com uma breve descrição e preço inicial, filtráveis por tipo.
nano_get_modelTodos os parâmetros de um modelo: tipos, valores permitidos, intervalos e opções compatíveis.
nano_estimate_costO custo exato em créditos de uma combinação de parâmetros, ou por que ela é inválida.
nano_upload_imageEnvie uma imagem de referência a partir de um link HTTPS, ou um arquivo local com o MCP local.
nano_generate_imageInicie uma geração de imagem e receba o ID do pedido e os créditos cobrados.
nano_generate_videoInicie uma geração de vídeo com as mesmas opções do site.
nano_get_generationConsulte uma geração aguardando até 20 segundos e receba as URLs do resultado quando terminar.
nano_list_generationsAs suas gerações recentes, página a página.
Prefere o terminal?
Tudo também funciona como comandos simples. Todos os comandos aceitam --json, o que facilita scripts e 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 --jsonComo funciona a cobrança
Os agentes usam a sua conta Nano Banana, não um saldo de API separado.
Os mesmos créditos do site
Cada geração desconta créditos da sua conta ao mesmo preço do nanobananana.com. Gerações com falha são reembolsadas.
Ilimitado continua ilimitado
Nos planos Plus e Ultra, Z Image e FLUX.2 continuam ilimitados. Via token têm um limite de 300 imagens por dia para travar scripts descontrolados.
Veja o preço antes
O seu agente pode chamar nano_estimate_cost antes de gerar e deve escolher a resolução explicitamente, sem escolher uma mais cara por você.
Precisa de mais créditos? Ver planos e pacotes de créditos
Perguntas frequentes
Leve o Nano Banana para o seu agente
Crie um token, cole a configuração e comece a gerar a partir do seu editor.
Criar um token de API