Canvas + Codex + Claude

    Banana Art Lab MCP Server

    Deixe o Codex, Claude Code, Cursor ou qualquer cliente MCP gerar imagens com GPT Image 2, Nano Banana Pro, Seedream e os outros modelos do Banana Art Lab, pagando com seus créditos, e colocar os resultados em um canvas em que vocês trabalham juntos.

    URL do servidor (Streamable HTTP, OAuth)
    https://trynanobanana.net/mcp
    Codex

    › Crie três pôsteres de viagem com o GPT Image 2 Saver e coloque-os em um canvas chamado “Pôsteres”

    ● banana-art-lab · generate_image

    model: gpt-image-2-saver · ratio 3:4 · 3 images

    3 imagens · 6 créditos · adicionadas ao canvas “Pôsteres”

    Pronto. Acesse trynanobanana.net/canvas para compará-las ou me diga qual delas quer refinar.

    trynanobanana.net/canvas · Pôsteres
    Prompt
    Pôsteres de viagem, cores quentes de impressão, tipografia marcante
    Pôster de viagem de Kyoto gerado com GPT Image 2 Saver
    Cena de rua chuvosa gerada com GPT Image 2 Saver
    Interior de livraria gerado com GPT Image 2 Saver

    Configuração

    Conecte seu assistente

    Codex

    Adicione o servidor e faça login: o Codex abre trynanobanana.net no navegador para você aprovar o acesso.

    codex mcp add banana-art-lab --url https://trynanobanana.net/mcp
    codex mcp login banana-art-lab
    Geração de imagens no Codex

    Claude Code

    Adicione o servidor, digite /mcp no Claude Code, escolha banana-art-lab e faça login.

    claude mcp add --transport http banana-art-lab https://trynanobanana.net/mcp
    Geração de imagens no Claude Code

    Cursor

    Adicione ao ~/.cursor/mcp.json (ou ao .cursor/mcp.json do projeto). O Cursor solicitará o login na primeira vez.

    mcp.json
    {
      "mcpServers": {
        "banana-art-lab": {
          "url": "https://trynanobanana.net/mcp"
        }
      }
    }

    Outros clientes ou chave de API

    Adicione https://trynanobanana.net/mcp como um servidor MCP HTTP remoto. Clientes com suporte a OAuth solicitarão o login. Para os demais, crie uma chave de API no canvas em Configurações → Ferramentas de IA e envie-a como um bearer token. No Codex, com a chave na variável de ambiente BANANA_ART_LAB_API_KEY:

    codex mcp add banana-art-lab --url https://trynanobanana.net/mcp --bearer-token-env-var BANANA_ART_LAB_API_KEY

    Ferramentas

    O que seu assistente pode fazer

    FerramentaO que faz
    generate_imageGera de 1 a 4 imagens a partir de um prompt e imagens de referência opcionais, com qualquer modelo do site, proporção e resolução. Opcionalmente, posiciona o prompt e os resultados em um canvas.
    get_generationBusca as imagens de uma geração que demorou mais de cerca de 45 segundos.
    list_modelsLista os modelos, resoluções, níveis de qualidade e créditos por imagem.
    get_accountMostra o saldo de créditos da conta conectada.
    list_canvasesLista seus canvases com seus IDs.
    get_canvasLê um canvas: seus nós (texto, imagens, posições) e conexões.
    create_canvasCria um novo canvas.
    edit_canvasAdiciona, atualiza, conecta e exclui nós em um canvas.

    O que pedir

    • “Gere quatro fotos de produto de uma caneca de cerâmica sobre mármore branco com o GPT Image 2 Saver e coloque-as em um novo canvas chamado "Mug launch".”
    • “Leia meu canvas "Spring campaign" e faça uma versão em 16:9 de cada imagem nele.”
    • “Liste os modelos do Banana Art Lab com seus preços e depois crie um pôster 2K de uma feira noturna com o Nanobanana Pro.”
    • “Transforme esta descrição de produto em três nós de prompt no meu canvas, conecte cada um a uma imagem e gere-as.”

    Acesso

    Você no controle da sua conta

    • Você faz login e aprova cada aplicativo em trynanobanana.net. Os aplicativos nunca veem sua senha.
    • Os tokens de acesso duram uma hora e se renovam sozinhos; desconecte um aplicativo ou revogue uma chave a qualquer momento em Configurações do canvas → Ferramentas de IA.
    • O servidor só gera imagens quando seu assistente solicita, pelos mesmos valores em créditos do site (confira os modelos e preços).
    • Ele funciona apenas com a sua conta do Banana Art Lab e não tem acesso aos arquivos no seu computador.

    Dúvidas

    O que é o servidor MCP do Banana Art Lab?

    O MCP (Model Context Protocol) é como assistentes de IA como Codex, Claude Code e Cursor usam ferramentas externas. O servidor MCP do Banana Art Lab em https://trynanobanana.net/mcp oferece a eles geração de imagens e acesso aos seus canvases, para você pedir imagens no mesmo chat onde trabalha.

    Quais aplicativos podem se conectar?

    Qualquer cliente MCP com suporte a servidores remotos (Streamable HTTP). Codex, Claude Code e Cursor fazem login com OAuth: você só precisa autorizar o app uma vez em trynanobanana.net. Clientes sem suporte a OAuth podem usar uma chave de API obtida em Configurações do canvas → Ferramentas de IA.

    Quanto custa?

    A conexão com as ferramentas é gratuita. Cada imagem gerada consome créditos pelo mesmo valor do site, por exemplo, 2 créditos para o GPT Image 2 Saver em qualquer resolução. Novas contas ganham 10 créditos grátis ao se cadastrar, e você pode comprar mais na página de preços.

    A IA pode ver meus canvases e gastar meus créditos?

    Apenas depois que você autorizar na página de consentimento e somente na conta aprovada. Ela não tem acesso aos arquivos no seu computador. Você pode desconectar um app ou revogar uma chave de API a qualquer momento em Configurações do canvas → Ferramentas de IA.

    Por que uma geração às vezes retorna como um job?

    Por padrão, o Codex aguarda cerca de 60 segundos por uma ferramenta. Se as imagens não ficarem prontas em cerca de 45 segundos, generate_image retorna um job id e seu assistente busca as imagens com get_generation um pouco mais tarde. Nada é cobrado duas vezes.

    Onde as alterações no canvas aparecem?

    No seu canvas em trynanobanana.net/canvas. Se ele estiver aberto, as alterações feitas pelo assistente aparecem em cerca de dez segundos; caso contrário, estarão lá na próxima vez que você abri-lo.