Conecte um servidor MCP do Nano Banana ao Claude Code em poucos comandos, proteja seu token do Gemini, escreva um SKILL.md que mantenha os prompts consistentes e compare os preços reais por imagem do Nano Banana, Nano Banana 2 Lite, 2 e Pro para um mês de 120 imagens.
Seu agente de código pode montar uma landing page em um minuto e depois travar porque a imagem principal ainda não existe. Um servidor Nano Banana MCP resolve essa lacuna. Você o registra uma vez no Claude Code, pede uma imagem em linguagem simples, e o arquivo aparece na pasta do projeto enquanto você continua trabalhando. A seguir você encontra os comandos exatos de configuração, um arquivo de skill reutilizável, uma lista de verificação de segurança e os preços por imagem publicados em outubro de 2026, para decidir em dez minutos se ele merece um lugar no seu conjunto de ferramentas.
"Nano Banana" começou como o apelido do modelo Gemini 2.5 Flash Image, do Google, e acabou virando a marca de toda a linha. Estes são os quatro nomes que você vai encontrar nas tabelas de preços:
| Apelido | Modelo oficial | Melhor para |
|---|---|---|
| Nano Banana | Gemini 2.5 Flash Image | Rascunhos e edições rápidas e baratas |
| Nano Banana 2 Lite | Gemini 3.1 Flash-Lite Image | Menor custo, somente saída em 1K |
| Nano Banana 2 | Gemini 3.1 Flash Image | Padrão do dia a dia, até 4K |
| Nano Banana Pro | Gemini 3 Pro Image | Máxima fidelidade, até 4K |
O Claude Code já lê seu repositório, edita arquivos e executa comandos. Ele não consegue pintar. Um servidor de imagens lhe dá uma ferramenta generate_image, então a sessão que escreve o componente também produz a imagem principal, o card para redes sociais e a ilustração da tela vazia, e depois as conecta pelo caminho do arquivo. Sem trocar de aba, sem pasta de downloads, sem renomear image (3).png.
Tarefas típicas que se encaixam:
Ele segue prompts longos e descritivos com precisão, mantém um sujeito estável ao longo de várias edições e renderiza textos curtos de forma legível. O Nano Banana 2 também pode basear um prompt em pesquisa na web em tempo real, o que ajuda quando a imagem deve refletir algo que aconteceu nesta semana.
Ele é mais fraco em tipografia densa, cores exatas de marca e em manter o mesmo rosto idêntico em cinquenta imagens. Trate o primeiro resultado como rascunho e reserve tempo para uma segunda passada.
O Model Context Protocol é um padrão aberto que permite a um cliente de IA chamar ferramentas externas. Três peças estão envolvidas:
Você pede uma imagem. O Claude Code chama uma ferramenta com um nome como mcp__nanobanana__generate_image. O servidor envia seu prompt a um modelo de imagem do Gemini, salva o resultado no disco e responde com um caminho de arquivo. Essa última etapa importa mais do que parece.
💡 Por que caminhos vencem dados brutos: o Claude Code limita quanto de saída uma ferramenta MCP pode devolver (você pode aumentar o limite com a variável de ambiente
MAX_MCP_OUTPUT_TOKENS). Uma imagem em base64 consumiria o contexto rapidamente. A listagem do@nanobanana/mcpdiz que ela devolve caminhos de arquivo, o que mantém sua sessão enxuta.
Existem vários servidores da comunidade. Nenhum deles vem da Anthropic ou do Google.
| Servidor | Autenticação | Ferramentas | Vale saber |
|---|---|---|---|
@nanobanana/mcp | Token do Gemini | generate_image, edit_image, list_models | Usa o Nano Banana 2 por padrão, devolve caminhos de arquivo |
@ycse/nanobanana-mcp | Token do Google AI | gemini_generate_image, gemini_edit_image, gemini_chat, set_model, além de ferramentas de histórico | Licença MIT, alterna entre Flash e Pro |
nano_banana via OpenRouter | Token do OpenRouter | Geração de imagens | Usa google/gemini-3-pro-image-preview por padrão |
Os exemplos abaixo usam @nanobanana/mcp porque é o mais simples: três ferramentas e uma variável. Os outros funcionam do mesmo jeito, com outro nome de pacote e outra variável.
Abra a página de API no Google AI Studio (aistudio.google.com/apikey) e crie um token. Existe um plano gratuito, mas levantamentos de preços observam que as gerações do plano gratuito podem ser usadas pelo Google para melhorar seus produtos. Use um projeto pago para trabalhos de clientes ou imagens privadas.
No macOS, Linux ou WSL, execute:
claude mcp add nanobanana -e GEMINI_API_KEY=your_token_here -- npx -y @nanobanana/mcp
No Windows nativo, é preciso do invólucro cmd /c para que o Claude Code possa iniciar npx:
claude mcp add nanobanana -e GEMINI_API_KEY=your_token_here -- cmd /c npx -y @nanobanana/mcp
Você também escolhe um escopo. Local é o padrão e vale para você neste projeto. Adicione --scope project para gravar um .mcp.json compartilhado que toda a equipe usa, ou --scope user para deixar o servidor disponível em todos os projetos.
💡 Coloque todas as flags antes do duplo hífen. Tudo o que vier depois dele vai para
npx, não para o Claude Code, e esse é o motivo mais comum de um servidor novo nunca conectar.
Execute claude mcp list, depois abra o Claude Code e digite /mcp. A entrada nanobanana deve mostrar connected. Agora teste com um pedido real:
Gere uma foto 16:9 de uma banana madura sobre uma mesa de madeira, com luz da manhã vinda da janela, e salve em public/images/test.jpg
Se um caminho de arquivo voltar e a imagem abrir, a ligação funciona. A primeira chamada pode demorar mais porque npx baixa o pacote; as seguintes começam mais rápido.
Seu token deve ficar em uma variável de ambiente e em nenhum outro lugar. Nunca o cole em um prompt, em um arquivo de skill ou em uma configuração versionada. Para um .mcp.json compartilhado, referencie a variável em vez do valor:
{
"mcpServers": {
"nanobanana": {
"command": "npx",
"args": ["-y", "@nanobanana/mcp"],
"env": { "GEMINI_API_KEY": "${GEMINI_API_KEY}" }
}
}
}
O Claude Code expande a variável a partir do seu shell quando inicia o servidor, então cada membro da equipe usa o próprio token e o repositório continua limpo.
💡 Esses servidores são projetos da comunidade.
npx -ybaixa e executa código com seu token no ambiente. Abra o repositório, verifique o mantenedor e os commits recentes e fixe uma versão (@nanobanana/mcp@<version>) antes de confiar nele.
O servidor dá ao Claude Code a capacidade de desenhar. Uma skill diz a ele como você quer que as coisas sejam desenhadas. Uma skill é uma pasta que contém um arquivo SKILL.md, mantido em .claude/skills/nano-banana/ para um projeto ou em ~/.claude/skills/nano-banana/ para todos. O arquivo começa com um cabeçalho YAML curto com dois campos, name e description. O Claude lê a descrição para decidir quando a skill se aplica e carrega o corpo apenas nesse momento, então a skill não custa quase nada até ser necessária.
Escreva a description como um gatilho: "Gere ou edite imagens com o servidor Nano Banana MCP. Use quando o usuário pedir uma imagem de destaque, miniatura, mockup ou ilustração." Depois coloque suas regras no corpo:
# 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.
As regras 5 e 6 são as mais importantes. Elas são seus freios de custo, e a próxima seção mostra por quê.
Uma sessão real fica assim: você diz "adicione uma imagem de destaque à página de preços". O Claude Code lê a página, carrega a skill, escreve um único prompt detalhado, chama generate_image, recebe um caminho e edita a tag <img> com texto alternativo. Você revisa uma imagem em vez de oito.
Use esta ordem: sujeito, ação, cenário, iluminação, câmera, textura. Por exemplo:
Uma padeira tirando uma assadeira de pão de fermentação natural de um forno de pedra, farinha polvilhando os antebraços, cozinha rústica com panelas de cobre, luz de janela quente vinda da esquerda, lente de 50mm em f/2, profundidade de campo rasa, textura visível da crosta, cor natural.
Mantenha qualquer texto dentro da imagem em uma ou duas palavras. Para edições, peça uma única mudança por instrução ("deixe o céu nublado"), confira o resultado e só então peça a próxima.
O modelo de imagem é apenas uma linha da sua conta. O uso do Claude Code é cobrado à parte, pelo seu plano Anthropic ou pelo uso da API, e o Google cobra o lado do Gemini.
Os levantamentos públicos de preços listam estes valores até outubro de 2026:
| Modelo | Padrão | Lote | Observações |
|---|---|---|---|
| Nano Banana | US$ 0,039 | US$ 0,0195 | Gemini 2.5 Flash Image |
| Nano Banana 2 Lite | US$ 0,0336 | US$ 0,0168 | Somente saída em 1K |
| Nano Banana 2 | Cerca de metade do Pro | Não informado | Aceita de 0,5K a 4K |
| Nano Banana Pro | US$ 0,134 em 1K ou 2K, US$ 0,24 em 4K | Não informado | Maior fidelidade |
Os preços mudam, então confirme-os na página de preços do Google antes de comprometer um orçamento. Alguns levantamentos também cobram por imagem de referência enviada, o que significa que trabalhos de edição pesada custam mais do que sugere o preço de saída.
Imagine um blog que publica 20 artigos por mês, com 6 imagens cada:
| Modelo | Padrão | Lote |
|---|---|---|
| Nano Banana | US$ 4,68 | US$ 2,34 |
| Nano Banana 2 Lite | US$ 4,03 | US$ 2,02 |
| Nano Banana Pro em 1K ou 2K | US$ 16,08 | Não informado |
| Nano Banana Pro em 4K | US$ 28,80 | Não informado |
Esses totais partem do princípio de que você mantém todas as imagens. Se rejeitar metade, dobre-os. Três hábitos mantêm esse número baixo:
Siga estes passos em ordem:
claude mcp get nanobanana para ver o comando e o ambiente que o Claude Code armazenou.node --version. O servidor precisa do Node instalado para que npx funcione.cmd /c npx.-e antes do duplo hífen.Prompts vagos geram cara de foto de banco de imagens, então acrescente uma lente, uma direção de luz e um detalhe de textura. Texto embaralhado significa palavras demais: reduza para uma ou duas. Uma forma errada geralmente significa que a proporção nunca chegou à ferramenta, então declare-a no pedido. Quando uma edição sai do rumo, mude uma coisa por vez e guarde a versão boa antes da próxima passada.
Se preferir pular o token e o terminal, o Nano Banana 2 roda no seu navegador no Picasso IA. A página do modelo lista gerações ilimitadas sem créditos por geração, o que a torna um bom lugar para testar prompts antes de pagar por chamadas de API. Os exemplos executados nessa página terminaram em cerca de 20 a 28 segundos cada, então iterar é barato em tempo e em dinheiro.
match_input_image, e 15 opções estão disponíveis, incluindo 16:9, 9:16, 4:5 e 21:9.O Nano Banana Pro também aceita 14 imagens de referência, gera saídas em 1K, 2K (o padrão) ou 4K, e acrescenta uma configuração safety_filter_level. A página dele informa que é gratuito para usar, e seus exemplos levaram de 18 a 113 segundos, então espere que seja mais lento. Recorra a ele quando uma imagem de destaque final precisar de máximo detalhe, e use o Nano Banana para edições rápidas.
A escrita de prompts também pode ser delegada. Um modelo de chat como o Claude Sonnet 5 pode transformar uma ideia bruta no sujeito, na ação e na fórmula de iluminação, enquanto o Claude Opus 4.7 é mais indicado para briefings mais longos. Quando uma cena deve se mover, descreva o movimento de um clipe curto no Veo 3.1 Fast ou no Gemini Omni 1.1.
Agora você tem o ciclo completo: um token, um comando claude mcp add, uma skill que mantém os prompts consistentes e um orçamento que você consegue defender. A forma mais rápida de sentir a diferença entre os modelos é rodar o mesmo prompt em cada um deles.
Abra o Picasso IA, escolha o Nano Banana 2 e cole o prompt da padeira de cima. Depois mude um detalhe, a lente ou a luz, e gere de novo. Dez minutos disso vão ensinar ao seu arquivo de skill mais do que qualquer manual. Comece com uma única cena que você realmente precisa esta semana e construa a partir daí.
Escolha seu idioma
