Para desenvolvedores
Servidor MCP do Nano Banana Pro
Deixe o seu assistente de IA criar imagens e vídeos em seu nome. Adicione um endereço de servidor a um cliente compatível com o Model Context Protocol, entre na sua conta pelo navegador e descreva o que precisa em linguagem natural.
Como funciona
Adicione o endereço do servidor
Cole o endereço abaixo no cliente, usando o comando dele, o arquivo de configuração ou o campo de conector personalizado.
Endereço do servidor MCP
https://preview.bananapro.site/api/mcpEntre e autorize o acesso
O cliente abre uma janela do navegador. Entre na sua conta do Nano Banana Pro e clique em Permitir. Não é preciso digitar nenhuma chave de API.
Descreva o que precisa
Peça uma imagem ou um vídeo na conversa. O assistente escolhe uma ferramenta, inicia a tarefa e devolve os links do resultado.
Configuração por cliente
Escolha o seu cliente. Os nomes dos menus podem variar um pouco entre versões.
Claude Code
- 1Execute o comando abaixo em um terminal para adicionar o servidor.
- 2No Claude Code, abra /mcp, selecione nanobanana e conclua o login no navegador.
claude mcp add --transport http nanobanana https://preview.bananapro.site/api/mcpCodex
- 1Execute o primeiro comando em um terminal para adicionar o servidor.
- 2Execute o segundo comando. Uma janela do navegador será aberta.
- 3Entre na sua conta e clique em Permitir.
codex mcp add nanobanana --url https://preview.bananapro.site/api/mcpcodex mcp login nanobananaCursor e clientes com JSON
- 1Adicione o trecho a seguir ao arquivo de configuração MCP do cliente, como o mcp.json no Cursor.
- 2Reinicie o cliente, se necessário. No primeiro uso, uma janela do navegador é aberta: entre e clique em Permitir.
{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp"
}
}
}Conector personalizado
- 1Abra as configurações do cliente e localize o campo de conector personalizado ou de servidor MCP remoto.
- 2Cole o endereço do servidor exibido abaixo e salve.
- 3Escolha Conectar, entre na sua conta e clique em Permitir.
https://preview.bananapro.site/api/mcpChave de API
- 1Use este método apenas com clientes que não conseguem abrir um navegador.
- 2Crie uma chave na página de chaves de API. Envie-a no cabeçalho do primeiro campo ou, em uma configuração JSON, adicione-a em headers, como no segundo campo.
- 3Guarde a chave nas configurações de credenciais do cliente e não a compartilhe com ninguém.
Authorization: Bearer YOUR_API_KEY{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}O que o assistente pode fazer
O servidor disponibiliza seis ferramentas. Quatro apenas leem informações e não têm custo; duas iniciam uma geração e usam créditos.
| Ferramenta | O que faz | Usa créditos |
|---|---|---|
| list_models | Lista os modelos de imagem e vídeo disponíveis para sua conta e os tipos de solicitação que cada um aceita. | Não |
| get_balance | Mostra quantos créditos ainda restam na conta. | Não |
| generate_image | Inicia a geração ou a edição de uma imagem a partir de um prompt e de imagens de referência opcionais. | Sim |
| generate_video | Inicia a geração de um vídeo a partir de um prompt, de imagens ou de outras mídias de referência. | Sim |
| get_task | Verifica uma geração e devolve os links do resultado quando ela termina. | Não |
| list_tasks | Lista as gerações recentes, o que ajuda quando o ID de uma tarefa foi perdido. | Não |
Ferramenta de linha de comando
O comando nanobanana cria imagens e vídeos a partir de um terminal, de scripts e de aplicativos de IA que executam comandos no seu computador.
Requer Node.js 22 ou posterior no macOS ou no Linux.
Instale a CLI
Instale o pacote @nanobanana-pro/cli com o npm.
npm install -g @nanobanana-pro/cliEntre na conta
Execute o comando, entre na sua conta na janela do navegador e clique em Permitir.
nanobanana auth loginVerifique a conta e os modelos
Este comando mostra seu saldo de créditos. O comando nanobanana models lista os modelos disponíveis.
nanobanana accountCrie
Salve em request.json uma solicitação com o modelo e o prompt e execute o comando. A opção --wait o mantém em execução até a tarefa terminar.
nanobanana create --input request.json --waitBaixe o resultado
Substitua TASK_ID pelo ID da tarefa devolvido pelo comando anterior.
nanobanana download TASK_ID --output result.png
Veja em ação
Peça uma imagem em uma única frase. O seu aplicativo de IA escreve a solicitação, cria a imagem e salva o arquivo.
$ 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
O assistente pode usar os modelos de imagem e de vídeo que a sua conta pode usar no site e na API.
- Peça ao assistente que chame list_models para obter a lista atual de modelos e os tipos de solicitação que cada um aceita.
- Cada modelo oferece as mesmas opções do site. Uma configuração que o modelo não aceita é recusada com uma explicação.
- As imagens e os vídeos de referência devem ser links https públicos. Não é possível enviar arquivos pelo MCP.
Créditos e cobrança
- O login e as ferramentas gratuitas (list_models, get_balance, get_task, list_tasks) não custam nada.
- generate_image e generate_video consomem os mesmos créditos do site e da API, descontados do saldo da sua conta.
- Uma tarefa que falha é reembolsada automaticamente.
- A assinatura do próprio assistente de IA é independente e cobrada por esse assistente.
Exemplos de pedidos
Depois de conectar, envie um destes pedidos ao seu assistente.
- Quais modelos de imagem e de vídeo posso usar? Mostre em uma lista curta.
- Crie uma foto de produto em 16:9 de uma caneca de cerâmica sobre uma mesa de madeira.
- Transforme esta foto de paisagem em um vídeo de cinco segundos: https://example.com/photo.jpg
- Verifique o status da minha última tarefa e envie o link do resultado.
Perguntas frequentes
Preciso de uma chave de API?
Não, com clientes que conseguem abrir um navegador: basta entrar e clicar em Permitir. A chave só é necessária para clientes que não conseguem, conforme descrito em Chave de API.
Onde vejo ou removo uma conexão?
Abra a página de chaves de API. Cada conexão aparece ali com o nome do seu cliente, e removê-la encerra o acesso desse cliente.
Quanto custa uma geração?
Os mesmos créditos do site e da API. Uma tarefa que falha é reembolsada automaticamente.
Posso usar minhas próprias imagens ou vídeos como referência?
Sim, como links https públicos. Não há envio de arquivos: coloque o arquivo em um local acessível e informe o endereço dele.
A conexão funciona, mas as ferramentas não aparecem. O que fazer?
Verifique se o login foi concluído e se o cliente mostra o servidor como conectado. Em seguida, inicie uma nova conversa, pois alguns clientes carregam as ferramentas apenas no início.
Onde encontro os resultados?
O assistente devolve os links do resultado na conversa. As tarefas anteriores podem ser listadas de novo com list_tasks.
Prefere chamar a API por conta própria?
O servidor MCP é construído sobre a API pública. A documentação lista todos os endpoints, parâmetros e modelos.