Servidor MCP do Cline: gere imagens direto do seu editor

Um servidor MCP remoto no Cline é um conjunto hospedado de ferramentas que o agente aciona via HTTP: você adiciona um único bloco no JSON de configurações do MCP e o Cline passa a executar ações que nenhum modelo de linguagem faz sozinho. Gerar um arquivo de imagem é o exemplo mais direto. O Cline refatora seus componentes, roda os testes e escreve a migration, mas para completamente na hora de «inserir a foto do produto aqui».

A configuração completa para quem tem pressa. Crie uma chave no seu perfil do BananaBanana, abra as configurações de MCP do Cline e adicione:

{
  "mcpServers": {
    "bananabanana": {
      "type": "streamableHttp",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": ["list_models", "get_account", "get_result"]
    }
  }
}

Dez ferramentas ficam disponíveis. As imagens custam a partir de $0.03 cada, debitadas de um saldo pré-pago, e os vídeos a partir de $0.10. A linha type é obrigatória, e a ausência dela causa um erro silencioso que explicarei adiante.

Por que adicionar um gerador de imagens ao Cline?

O fluxo principal do Cline é «descreva o resultado esperado e deixe o agente fazer as iterações». Isso funciona perfeitamente até o momento em que o resultado exige uma imagem. Aí o fluxo é quebrado e começa o trabalho braçal: abrir o navegador, digitar o prompt, baixar, renomear, mover para public/, voltar ao editor e se situar novamente. Cinco minutos por asset, e a quebra de foco custa muito mais do que esses cinco minutos.

Com uma ferramenta MCP, o agente assume todo o ciclo. Ele redige o prompt, chama generate_image, baixa o arquivo final na pasta indicada e atualiza o markup. Você só precisa revisar o diff.

A estrutura de preços também se alinha perfeitamente ao público do Cline. O Cline funciona no modelo «traga seu próprio modelo», então quem o utiliza já está acostumado a pagar por unidade em vez de planos mensais. Os valores de geração seguem a mesma lógica. Sem mensalidades, sem custos por usuário e sem consumo mínimo. Imagens a partir de $0.03, vídeos a partir de $0.10, descontados de um saldo que você recarrega quando quiser.

A alternativa seria rodar um servidor MCP local de imagens, o que exige um processo Node ou Python em execução na sua máquina, além da sua própria chave de provedor, com gestão de cotas e faturamento em outra plataforma. Um endpoint hospedado elimina essas complexidades. A geração acontece nos nossos servidores pelo mesmo pipeline do gerador web, e a sua única credencial é uma chave revogável.

Como adicionar um servidor MCP remoto no Cline?

Existem três caminhos que levam ao mesmo resultado. As informações abaixo foram validadas com base na documentação oficial do Cline MCP em 20 de agosto de 2026.

Pela interface. Clique no ícone de MCP Servers na barra de ferramentas do painel do Cline, acesse a aba Remote Servers, preencha o nome do servidor, a URL https://bananabanana.pro/api/mcp e selecione Streamable HTTP como transporte. Clique em Add Server. Em seguida, adicione o cabeçalho Authorization: o formulário é a forma mais rápida de cadastrar, mas é no JSON que a credencial fica salva.

Editando o JSON. Mesmo ícone, aba Configure, e clique em Configure MCP Servers para abrir o arquivo de configurações da extensão. Ele fica no armazenamento global do VS Code, dentro da pasta saoudrizwan.claude-dev (o ID da extensão ainda carrega o nome do autor original, o que costuma confundir quem procura por uma pasta chamada «cline»). Na CLI, o caminho é simplesmente ~/.cline/mcp.json, e o comando cline mcp abre um assistente interativo com os mesmos campos.

Pelo terminal. O comando cline config mcp --json exibe a configuração atualmente carregada, sendo a forma mais rápida de conferir se as alterações foram aplicadas.

Qualquer que seja o método escolhido, o endereço do endpoint é https://bananabanana.pro/api/mcp. Não use /mcp, que é a página de documentação para humanos e retorna HTML para requisições POST. Nossa página do servidor MCP mantém o snippet padrão e uma tabela de compatibilidade dos clientes verificados:

Faça um teste gratuito antes de gastar saldo. A função get_account retorna seu saldo, o nome da chave e o limite diário; list_models retorna a lista de modelos com as tarifas atuais. Ambas são gratuitas e validam a autenticação em cerca de um segundo.

Caso de uso: lote de imagens para catálogo no modo Act

É aqui que o Cline mostra todo o seu potencial, indo muito além de criar uma única imagem para a página inicial. Primeiro o modo Plan: descreva o catálogo, doze produtos que precisam de imagens temporárias seguindo uma identidade visual uniforme, e deixe o Cline estruturar o loop antes de tocar no código. Depois, o modo Act executa o plano.

A identidade visual é mantida através de uma cláusula fixa repetida em cada chamada, variando apenas o produto. A consistência do conjunto vem da parte invariável do prompt, e não de uma suposta memória do modelo sobre o que foi feito minutos antes:

→ generate_image {"prompt": "A photorealistic overhead product shot of a
   small monstera in a matte terracotta pot on a pale linen backdrop, soft
   diffused window light from the left, 50mm lens, subtle natural shadow,
   generous empty space around the subject, no text",
   "model": "nano-banana-pro", "aspect_ratio": "4:5"}
← {"job_id": "…", "status": "processing", "cost_charged_usd": 0.11,
   "balance_remaining_usd": 1110.65}

Segundo produto, com a mesma estrutura de estilo, mas outra planta e outro ângulo:

Doze imagens dessas no Nano Banana Pro totalizam $1.32. No modelo padrão nano-banana-2-lite, o total fica em $0.36 — e para imagens provisórias que um designer substituirá mais tarde, essa seria a minha escolha; nosso guia do Lite explica onde o modelo econômico encontra seus limites. Usei o Pro neste artigo porque ambos os exemplos são exibidos na página em tamanho real.

A geração em lote é exatamente o cenário onde você precisa de travas de segurança. Existem duas disponíveis. Cada chave MCP aceita um limite diário opcional em dólares em Perfil → Chaves de API MCP, garantindo que um loop descontrolado pare no valor definido e não esvazie seu saldo. Além disso, pedidos com múltiplas imagens (number_of_images maior que 1) funcionam como o vídeo: a primeira chamada retorna uma estimativa de preço e não debita nada até que o agente confirme o envio com confirm_cost.

A geração de vídeo ocorre na mesma conversa, com a mesma regra de confirmação. Um clipe mudo de 4 segundos em 720p no Veo 3.1 Lite começa em $0.10, e o Omni Flash custa $0.10 por segundo sempre com áudio, totalizando $0.30 por 3 segundos. A renderização leva de um a dez minutos; como generate_video retorna o ID da tarefa imediatamente, o Cline continua trabalhando no seu código e consulta get_result em segundo plano quando estiver pronto.

Detalhes práticos do Cline que você deve conhecer

Cinco pontos importantes, organizados pelo tempo que podem poupar no seu dia a dia.

1. "type": "streamableHttp" deve ser digitado exatamente assim, e omiti-lo gera falha silenciosa. A documentação oficial é clara: se o campo não for preenchido, o cliente assume o transporte legado sse por compatibilidade. O SSE legado faz o cliente abrir uma requisição GET aguardando um fluxo de eventos. Como nosso endpoint opera em Streamable HTTP sem estado, a requisição GET recebe um 405 Method Not Allowed (verificado durante a redação deste artigo: curl -i https://bananabanana.pro/api/mcp retorna 405). No Cline, isso aparece como um servidor que não conecta, com uma mensagem de erro genérica. Escrever streamable-http com hífen falha do mesmo jeito.

2. A chave fica salva em texto puro no arquivo de configurações. A documentação do Cline sugere o uso de variáveis de ambiente, mas a interpolação dentro do objeto headers em servidores remotos não é documentada (diferente do ${env:…} no Cursor ou ${file:…} no Windsurf). O lado positivo é a localização: as configurações ficam no armazenamento global do VS Code e não no repositório do projeto, evitando commits acidentais no git. Ainda assim, trate a chave como credencial em disco: defina um limite diário e revogue-a pelo painel do perfil caso repasse o computador.

3. O Auto Approve é menos seletivo do que aparenta. No painel de Auto Approve do Cline, «Use MCP servers» é um botão único para toda a categoria de ferramentas MCP: ao ativá-lo, você aprova tanto as chamadas gratuitas quanto as pagas. O controle individual por ferramenta é configurado no JSON através do array autoApprove. Minha recomendação é incluir apenas as três chamadas gratuitas (list_models, get_account, get_result), eliminando interrupções desnecessárias enquanto cada geração paga continua exigindo sua confirmação.

4. O modo YOLO combinado com ferramentas pagas exige muita cautela. O modo YOLO do Cline aprova tudo automaticamente: alterações de arquivos, comandos no terminal, navegação e ferramentas MCP. A documentação o classifica como perigoso por bons motivos. Nossa etapa de confirmação de custo não protege nesse modo, pois um agente autônomo aprovará as duas etapas do fluxo. A única trava efetiva é o limite diário por chave. Defina esse teto antes de ligar o modo YOLO.

5. Não há instalação por marketplace e contas empresariais têm fluxo próprio. A extensão do VS Code baseada no SDK oficial não possui mais uma interface de catálogo do MCP Marketplace, tornando a edição manual do JSON o padrão. Administradores contam com outro recurso: o parâmetro remoteMCPServers na configuração remota da organização distribui o servidor para todos os membros, e blockPersonalRemoteMCPServers impede a adição de servidores individuais. Em equipes, faça a distribuição centralizada e atribua uma chave individual para cada desenvolvedor.

Uma ressalva honesta sobre o nosso serviço: a função generate_speech retorna um link assinado para um arquivo WAV em vez de um player embutido no painel do Cline, exigindo abrir o arquivo para ouvir. Já as imagens são entregues com uma miniatura ao lado do link. Como o Cline adicionou suporte a imagens em retornos de ferramentas em 2025, a visualização funciona perfeitamente em versões recentes.

O Cline suporta autenticação OAuth para servidores MCP?

De forma documentada não, e é importante destacar isso porque o comportamento muda de acordo com o cliente. A documentação do Cline cobre stdio, SSE e Streamable HTTP, detalhando a autenticação por cabeçalhos manuais. Não há suporte a OAuth. Uma discussão sobre suporte a OAuth segue aberta no repositório do Cline desde agosto de 2025, permanecendo ativa em 20 de agosto de 2026.

Na prática, isso não traz nenhum problema. Nosso servidor aceita tanto tokens OAuth 2.1 quanto chaves de API Bearer convencionais, que é exatamente o formato para o qual o Cline foi construído. É inclusive a opção que recomendo: criar chaves é gratuito, você pode ter várias ativas e cada uma possui seu próprio registro de uso (ferramenta, modelo, custo, trecho do prompt) e limite diário. Quando um prestador de serviço conclui o trabalho, você revoga uma única chave sem afetar o restante da equipe.

Para isolar despesas entre projetos, crie uma chave para cada um. O log de consumo mostrará com precisão o que foi gasto no painel interno versus a landing page, facilitando muito o controle financeiro.

Quanto custaram as imagens de demonstração deste artigo?

Valores padrão por geração, exatamente as tarifas informadas pelo comando list_models:

Dica importante para quem vai recarregar saldo: depósitos a partir de $50 ganham +5% de saldo extra, a partir de $100 ganham +10%, e um cupom promocional ativo adiciona mais +10% sobre o depósito. Ambos os bônus incidem sobre o valor base, de modo que $100 com cupom creditam $120.

A mesma chave funciona em outros ambientes: se você também usa Cursor ou VS Code, não precisa configurar nada do zero — mesmo saldo, mesmo histórico e um único endpoint. O guia do Cursor e a configuração do VS Code trazem os detalhes para essas ferramentas. Crie uma chave e peça ao Cline para gerar seu primeiro lote.

FAQ

O Cline suporta servidores MCP remotos via Streamable HTTP?

Sim, e esse é o transporte recomendado na própria documentação do Cline. Um servidor remoto é configurado com uma url, o type definido como streamableHttp e um objeto headers para autenticação, mantendo o SSE apenas para compatibilidade com servidores antigos. Informe sempre o type explicitamente: se omitido, o sistema usará SSE por padrão, o que falhará em endpoints modernos sem estado. Validado com base na documentação oficial em 20 de agosto de 2026.

Onde fica o arquivo de configurações MCP do Cline?

Em dois locais dependendo de como você o executa. A extensão do VS Code armazena o arquivo no armazenamento global do editor, na pasta com o ID saoudrizwan.claude-dev; a forma mais prática de acessá-lo é pelo botão Configure MCP Servers na aba Configure do painel MCP. Pela CLI, o arquivo fica em ~/.cline/mcp.json. Ambos utilizam o mesmo formato de objeto mcpServers.

Preciso de uma conta de nuvem própria para gerar imagens no Cline?

Não. Um servidor MCP local exige chaves de provedores externos com cotas e cobranças na sua conta pessoal. O servidor remoto executa tudo na nossa infraestrutura gerenciada, de modo que a única credencial necessária é a chave bb_live_ gerada no seu perfil. Novas contas recebem $0.20 de saldo inicial, permitindo gerar até seis imagens no modelo mais econômico antes de qualquer recarga.

Como evitar que o agente gaste saldo além do esperado?

Adote as três camadas de proteção. Mantenha o autoApprove restrito apenas às ferramentas gratuitas para que cada geração peça sua autorização. Defina um limite diário em dólares em Perfil → Chaves de API MCP, que continuará funcionando mesmo com o modo YOLO ativado. E aproveite a confirmação de custos: chamadas de vídeo e de múltiplas imagens retornam uma cotação prévia e só debitam o saldo se o agente repetir a requisição com o parâmetro confirm_cost.

Por que meu servidor MCP do Cline não conecta?

Verifique os itens nesta ordem. Confira se "type": "streamableHttp" está presente e em camelCase, pois sem ele o Cline tenta o transporte SSE e nosso endpoint retorna 405 na requisição GET. Confirme se a URL termina em /api/mcp e não em /mcp. Certifique-se de que o cabeçalho de autorização está exatamente como Bearer bb_live_... sem espaços extras (uma chave inválida ou revogada retorna 401). Se conectar mas as ferramentas não aparecerem, reinicie o servidor pelo painel MCP. Em ambientes corporativos, verifique se a inclusão de servidores pessoais não foi bloqueada pelas políticas da organização.