Servidor MCP e CLI

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 mcp

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

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

    O seu e-mail, plano, saldo de créditos, modelos ilimitados e quantas imagens ilimitadas restam hoje.

  • nano_list_models

    Modelos de imagem e vídeo com uma breve descrição e preço inicial, filtráveis por tipo.

  • nano_get_model

    Todos os parâmetros de um modelo: tipos, valores permitidos, intervalos e opções compatíveis.

  • nano_estimate_cost

    O custo exato em créditos de uma combinação de parâmetros, ou por que ela é inválida.

  • nano_upload_image

    Envie uma imagem de referência a partir de um link HTTPS, ou um arquivo local com o MCP local.

  • nano_generate_image

    Inicie uma geração de imagem e receba o ID do pedido e os créditos cobrados.

  • nano_generate_video

    Inicie uma geração de vídeo com as mesmas opções do site.

  • nano_get_generation

    Consulte uma geração aguardando até 20 segundos e receba as URLs do resultado quando terminar.

  • nano_list_generations

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

Como 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

Um token só pode gerar, enviar imagens de referência e ler as suas gerações e o saldo. Não pode mudar a sua senha, excluir a conta, comprar planos nem abrir pedidos de suporte. Prompts enviados com um token passam pela mesma moderação de conteúdo do site.

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