24 de agosto de 2026
Gerar imagens e vídeos com IA a partir do Claude ou do Cursor: o manual completo do MCP
O seu assistente de IA sabe redigir, programar, planejar. Há pouco tempo, ele também sabe criar imagens e vídeos, sem sair da conversa, graças ao protocolo MCP. Veja como conectá-lo a um verdadeiro motor de geração em dois minutos, o que isso custa ao centavo, e os reflexos que separam um agente eficiente de um agente que desperdiça créditos.
o seu assistente agora sabe criar imagens, não apenas falar delas
Graças ao protocolo MCP, um assistente como o Claude ou o Cursor pode chamar um verdadeiro gerador de imagens e vídeos em plena conversa, e devolver a você a URL de um arquivo pronto em vez de uma descrição.
Peça ao Claude para escrever um artigo de blog, ele escreve. Peça para ilustrar esse artigo, e até há pouco tempo ele respondia educadamente que não gera imagens, antes de propor um prompt para copiar e colar em outro lugar. Você conhece a sequência: abrir outra ferramenta, colar o prompt, baixar a imagem, voltar. O assistente que devia fazer você ganhar tempo acabava de adicionar três idas e voltas ao seu dia.
Esse muro está caindo. Os assistentes de IA modernos sabem usar ferramentas externas: pesquisar na web, ler arquivos, chamar serviços. E desde que existe um padrão comum para conectar essas ferramentas, qualquer assistente compatível pode pilotar um verdadeiro motor de geração de imagens e vídeos. Você diz "ilustre esta seção com uma foto de raposa numa floresta enevoada", e trinta segundos depois a URL da imagem está na conversa.
Este guia mostra como conectar o Claude, o Cursor ou qualquer cliente compatível ao Imaginode, o canvas de criação com IA que dá acesso a 48 modelos (Flux 2, Nano Banana 2, Seedream 5, Kling V3, Seedance 2.5, Veo 3.1…) com um contador de créditos transparente. Dois minutos de configuração, nenhuma instalação, e o seu assistente vira um estúdio de criação.
MCP, a porta USB dos assistentes de IA
O Model Context Protocol é um padrão aberto que descreve como um assistente descobre e chama ferramentas externas: um servidor MCP expõe funções, o cliente as usa, não importa quem escreveu o quê.
MCP significa Model Context Protocol. É um padrão aberto, lançado no fim de 2024 e adotado desde então por todo o ecossistema: Claude, Cursor e dezenas de outros clientes falam esse protocolo nativamente. A ideia é simples: em vez de cada assistente inventar a própria maneira de se conectar a cada serviço, um servidor MCP descreve suas ferramentas num formato comum, e qualquer cliente compatível pode descobri-las e chamá-las. A comparação clássica é com uma porta USB: uma tomada única, milhares de aparelhos.
Na prática, um servidor MCP expõe ferramentas nomeadas, com seus parâmetros e sua descrição. O do Imaginode expõe quatro: listar os modelos disponíveis com seus preços, gerar uma imagem, lançar um vídeo, e acompanhar uma geração até o resultado. Quando você pede uma imagem ao seu assistente, ele mesmo escolhe a ferramenta, preenche o prompt, faz a chamada e traz a URL de volta. Você não vê o encanamento, e é essa a ideia.
Detalhe que importa: o servidor do Imaginode é hospedado, no endereço https://imaginode.ai/api/mcp. Nada para instalar na sua máquina, nenhum repositório para clonar, nenhum Node ou Python para configurar. É a diferença entre um servidor MCP remoto e os servidores locais que exigem instalação: aqui, a única coisa de que você precisa é uma chave API.
conectar o Imaginode ao Claude em dois minutos, cronômetro na mão
Crie uma chave API no seu perfil Imaginode (email verificado obrigatório, segredo exibido uma única vez), depois entregue-a ao seu cliente MCP: um comando no Claude Code, um conector personalizado no Claude.ai, um bloco JSON no Cursor.
Primeira etapa: a chave. Crie uma conta no Imaginode se ainda não tiver (créditos de teste são oferecidos no cadastro, email verificado obrigatório), depois abra o seu perfil, seção "Chaves API". Dê um nome à sua chave, "Claude Code" por exemplo, e crie-a. O segredo, que começa por imk_, será exibido uma única vez: copie-o imediatamente. Se você o perder, revogue a chave e crie outra, leva dez segundos.
Segunda etapa: a conexão. No Claude Code, uma única linha de terminal basta: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer sua-chave". No Claude.ai ou no aplicativo de desktop, adicione um conector personalizado com a URL do servidor e o mesmo cabeçalho. No Cursor, declare o servidor no arquivo mcp.json com a URL e o cabeçalho Authorization. Todos os outros clientes compatíveis com MCP seguem a mesma lógica: uma URL, um cabeçalho.
Terceira etapa: não existe. Abra uma conversa e peça: "gere uma imagem de um farol bretão sob tempestade, estilo foto analógica". O assistente chama a ferramenta, a imagem é gerada, a URL chega no fio da conversa. O custo exato em créditos e o seu saldo restante são anunciados a cada chamada, antes mesmo de o resultado chegar.
o que o seu assistente sabe fazer depois de conectado
Ilustrar um conteúdo que ele redige, declinar visuais em série, lançar um clipe de vídeo e acompanhá-lo até o arquivo final: o assistente encadeia as gerações no mesmo fio que o resto do seu trabalho.
O caso de uso mais imediato é a ilustração durante a redação. O seu assistente escreve uma página de vendas, um artigo, uma newsletter: agora ele pode gerar os visuais correspondentes, no mesmo fio, mantendo o contexto. O prompt de imagem aproveita tudo o que a conversa já contém, a sua marca, o seu tom, o assunto exato da seção. É muito diferente de um gerador aberto em outra aba que não sabe nada do seu projeto.
Segunda família: a série. "Gere a mesma garrafa em fundo de estúdio branco, depois em madeira clara, depois em ambiente noturno": o assistente encadeia as chamadas, nomeia os arquivos, lista as URLs para você. Para fotos de produto declinadas em volume ou miniaturas do YouTube para testar em variantes, o ciclo de trabalho se reduz a uma frase. E como cada chamada devolve o seu custo, você sabe exatamente quanto a série custou.
O vídeo funciona pelo mesmo princípio, com uma nuance: uma geração de vídeo leva de um a cinco minutos, às vezes mais nos formatos grandes. A ferramenta devolve então imediatamente um identificador de acompanhamento e o custo, depois o assistente consulta o status regularmente e entrega a URL quando estiver pronto. Enquanto isso, ele pode continuar trabalhando em outra coisa: é um agente, não uma ampulheta.
quanto custa, e por que um agente não pode descontrolar
Cada chamada é debitada em créditos na mesma tarifa do canvas (uma imagem de 1 a 7 créditos, um vídeo de 30 a 170 aproximadamente), as falhas são reembolsadas automaticamente, e uma cota de 10 gerações por minuto e por chave limita qualquer descontrole.
A pergunta incômoda primeiro: deixar um agente gastar dinheiro, isso é mesmo razoável? No Imaginode, as proteções estão na infraestrutura, não nas promessas. Cada geração é debitada antes de partir, a um preço conhecido: de 1 a 7 créditos para uma imagem, de aproximadamente 30 a 170 para um vídeo conforme o modelo, a duração e a resolução, sabendo que um crédito vale um centavo de euro. O detalhe por modelo é público, e a ferramenta list_models fornece os preços ao próprio assistente.
Se uma geração falha no fornecedor, os créditos são reembolsados automaticamente, sem ticket nem reclamação: você só paga o que dá certo. E principalmente, um agente nunca pode gastar além do seu saldo: sem cheque especial, sem fatura surpresa no fim do mês. O pior cenário possível é um saldo zerado e uma mensagem convidando você a recarregar.
Resta o caso do agente que entra em loop, aquele que relança a mesma geração em rajada porque um script se descontrolou. Cada chave API é limitada a 10 gerações por minuto: o bastante para qualquer uso real, pouco demais para esvaziar um saldo na sua ausência. E se uma chave vazar ou preocupar você, um clique no seu perfil a revoga, com efeito imediato. Cinco chaves ativas no máximo, uma por uso, é uma boa higiene.
os reflexos que separam um bom agente de um agente gastador
Iterar num modelo a 1 crédito antes de pagar o premium, escrever os prompts em inglês, consultar o status do vídeo a cada 30 segundos sem nunca relançar, e reutilizar as URLs de saída como entradas: quatro hábitos que mudam a fatura.
Primeiro reflexo, o mais rentável: validar no econômico, finalizar no premium. O Flux Schnell custa 1 crédito e basta de sobra para testar um enquadramento, uma atmosfera, uma composição. Com o prompt no ponto, relance a mesma ideia no Nano Banana 2 ou no Flux 2 Pro para o resultado final. Um assistente bem instruído aplica essa regra sozinho: diga simplesmente "itere no econômico, eu aviso quando passar para a qualidade". É a mesma lógica de escolher o seu modelo no canvas.
Segundo reflexo: os prompts em inglês. Os modelos de geração entendem todas as línguas, mas o treinamento deles é massivamente anglófono e os resultados ganham em precisão. Boa notícia: o seu assistente é um excelente tradutor. Fale com ele em português, deixe-o formular o prompt em inglês, e peça para ele mostrar o que enviou, é a melhor maneira de aprender a escrever prompts que funcionam.
Terceiro e quarto reflexos, para o vídeo e as cadeias: nunca relançar um vídeo "porque parece lento", o acompanhamento de status existe para isso e uma relançada custa o preço de uma geração completa. E reutilizar as URLs de saída como entradas: a imagem gerada na etapa anterior pode servir de primeiro frame para o vídeo seguinte, exatamente como se conectam dois nós no canvas. O seu assistente constrói então verdadeiros workflows, em plena conversa.
para os desenvolvedores: a mesma coisa em três endpoints REST
GET /api/models para o catálogo, POST /api/generate para lançar (modelo, prompt, opções, chave em Bearer), GET /api/generate/status para acompanhar: o servidor MCP é apenas uma fachada sobre uma API REST pública.
Se você prefere criar scripts diretamente, tudo o que o servidor MCP faz passa por três endpoints públicos. GET https://imaginode.ai/api/models devolve o catálogo completo, opções e preços em créditos, sem autenticação. POST https://imaginode.ai/api/generate lança uma geração: um JSON com o modelo, o prompt e as opções (duração, resolução, formato, áudio, imagens de entrada), a sua chave no cabeçalho Authorization, e a resposta contém o identificador da requisição, o custo debitado e o seu novo saldo.
GET https://imaginode.ai/api/generate/status acompanha então a geração: running enquanto roda, depois completed com as URLs de saída, ou failed com o reembolso já efetuado. É o mesmo pipeline, as mesmas validações e a mesma cobrança do canvas e do MCP: uma única mecânica, três portas de entrada.
As imagens de entrada devem estar hospedadas na sua conta Imaginode, seja importadas na sua midiateca, seja resultantes de uma geração anterior cuja URL você reutiliza. O guia API e MCP da documentação detalha cada campo, os limites e as boas práticas, em cinco línguas.
chat, canvas, agente: três portas para o mesmo motor
O canvas continua sendo o lugar onde se concebe e onde se guardam os workflows; o MCP e a API são as portas pelas quais um assistente ou um script acionam o mesmo motor, com o mesmo saldo de créditos.
Ainda vale a pena abrir o canvas se o assistente sabe gerar tudo? Sim, e por uma razão simples: a conversa continua linear. Para conceber um pipeline visual, comparar variantes lado a lado, guardar as suas referências de personagens e reencontrar o seu trabalho semanas depois, o canvas de nós continua sendo o ateliê. O agente, por sua vez, brilha na execução: produzir, declinar, integrar a geração num fluxo de trabalho mais amplo que inclui texto, código, arquivos.
Os dois se completam ainda melhor porque compartilham tudo: a mesma conta, os mesmos créditos, a mesma midiateca. Uma imagem gerada pelo Claude hoje de manhã está nas suas mídias Imaginode hoje à noite, pronta para ser conectada a um nó de vídeo. Um personagem de referência construído no canvas pode inspirar os prompts que o seu assistente enviará amanhã.
Se você está descobrindo o Imaginode por este artigo, o caminho mais curto continua sendo criar a sua conta, fazer as suas primeiras gerações no canvas para entender os modelos e os custos, depois criar a sua chave API e conectar o seu assistente. A partir daí, você tem um estúdio de criação que responde tão bem ao mouse quanto à conversa, e que sempre diz, ao centavo, quanto cada imagem custou.