Você montou um agente que escreve briefings de campanha, faz a triagem de tickets de suporte ou redige os textos de um lançamento. A próxima coisa que alguém pede são visuais: "ele também consegue fazer o vídeo?". O jeito limpo de adicionar isso não é ligar o seu agente a uma dúzia de APIs de modelos avulsas. É dar a ele um único servidor de ferramentas que fale MCP e deixar esse servidor cuidar de gerar e editar imagens, remover fundo, fazer upscale de imagens, vídeo e música. Este guia mostra por que essa é uma camada de integração sensata, um padrão de arquitetura para começar e como manter uma pessoa no circuito onde isso importa.
No fim, você vai entender como um agente de IA pode ir de "escreva o briefing" a "gere os materiais" sem que você mantenha uma pilha de código cliente por modelo, e como é um fluxo de aprovação sensato em volta disso.
O que você está adicionando de fato
Um agente gera vídeo chamando uma ferramenta. A questão é o que fica atrás dessa ferramenta. Duas opções:
- APIs diretas de cada modelo. Você integra cada provedor separadamente: um cliente para um endpoint do Veo, outro para o Kling, outro para um modelo de imagem, outro para um upscaler. Cada um tem sua autenticação, seu formato de requisição, seu tratamento de erros e seus limites de uso.
- Um servidor MCP. Você aponta o agente para um único servidor que já expõe geração de imagens, edição, upscale e vídeo de vários modelos atrás de uma só interface.
O servidor MCP do 8frame é a segunda opção. URL do servidor https://mcp.8frame.co/mcp, com 8 ferramentas de geração de imagem, 9 ferramentas de vídeo e 2 de música (uma por família de modelos, várias delas com mais de um modelo ou nível dentro), além de edição de imagens, remoção de fundo e upscale de imagens (em 2026-10-01). Seu agente ganha a geração criativa como capacidade; você não mantém o encanamento.
Por que aqui o MCP vence as APIs diretas
Uma integração, não N. O MCP é um padrão aberto para conectar aplicativos de IA a ferramentas e dados, apresentado pela Anthropic em novembro de 2024. O próprio site do protocolo informa que ele é suportado por assistentes de IA como Claude e ChatGPT e por ferramentas de desenvolvimento como VS Code e Cursor. Se o seu framework de agentes ou o seu cliente fala MCP, você adiciona um servidor em vez de escrever e manter um cliente por modelo.
As mudanças de modelo ficam, quase sempre, atrás do servidor. Quando chega um modelo de vídeo novo ou um provedor muda a API, esse trabalho acontece atrás do servidor MCP, e as chamadas do seu agente não precisam ser reescritas. As ferramentas mudam de vez em quando, sim: quando um provedor encerrou um modelo de vídeo em setembro de 2026, o conector retirou essa ferramenta. Faça o agente ler a lista de ferramentas ao se conectar, em vez de deixar os nomes fixos no código. Com integrações diretas, cada mudança de provedor é problema seu.
A escolha do modelo continua explícita. Cada família de modelos é uma ferramenta própria, e duas ferramentas de "escolher um modelo" mostram as opções com o custo em créditos, nos clientes que suportam esse tipo de pergunta. Escolhe-se um modelo por geração, pelo usuário ou pelas regras do seu agente (modelo barato para variações, Veo para a peça principal). Seu agente não precisa de um cliente por provedor para fazer essa escolha.
Um só modelo de custo. Tudo é cobrado em créditos do 8frame, de um único saldo. Nos preços do conector: Kling v3 Standard, 86 créditos por 5 segundos com som; Veo 3.1, 448 por 8 segundos com som no Standard (o padrão), 168 no Fast e 54 no Lite; Pruna p-video Draft, 4 por 5 segundos; Nano Banana, 6 por imagem. Um crédito custa US$ 0,01 no pacote. O conector tem menos ajustes que o canvas: não há opção sem som no Kling nem no Veo, nem ajuste de duração em nenhum dos dois. Seu agente faz o orçamento numa só unidade, em vez de um mapa de preços por provedor.
A contrapartida, com honestidade: as APIs diretas dão o controle de mais baixo nível e, no preço de tabela, uma API direta pode sair mais barata por clipe. A API do Gemini, do Google, cobra o Veo 3.1 Standard a US$ 0,40 por segundo com áudio, US$ 3,20 por 8 segundos, contra 448 créditos (cerca de US$ 4,48) no 8frame. Se o seu produto é só geração de vídeo em alto volume com um único modelo, integre esse modelo diretamente. Para um agente que precisa da geração criativa como uma capacidade entre muitas, o MCP costuma ser a escolha mais adequada.
Como conectar
O servidor é um endpoint MCP remoto padrão, então qualquer cliente ou framework compatível com MCP se conecta do mesmo jeito. No Claude Code, por exemplo:
claude mcp add --transport http 8frame https://mcp.8frame.co/mcp
Depois rode /mcp dentro do Claude Code e entre na sua conta do 8frame pelo navegador (o servidor usa OAuth). Num framework de agentes compatível com MCP, registre https://mcp.8frame.co/mcp como servidor de ferramentas remoto na configuração e faça o mesmo login; cada framework lida com OAuth de um jeito, então confira a documentação dele. A partir daí, as ferramentas de gerar, editar, fazer upscale e vídeo ficam disponíveis para o planejador do agente, e as gerações são cobradas dos créditos da conta em que você entrou. As notas de configuração estão em 8frame.co/mcp. Se o seu agente roda dentro do claude.ai e não na sua própria stack, a configuração pelos Connectors é o caminho equivalente.
Padrão de arquitetura: o agente redige, o MCP gera, uma pessoa aprova
Um padrão que vale a pena usar como ponto de partida é um ciclo de três etapas, não um totalmente autônomo:
Etapa 1: o agente redige o briefing. O agente faz o que faz bem: transformar um objetivo ("criativos de lançamento para o novo SKU, três variações de gancho") em prompts estruturados. Sujeito, ação, câmera, iluminação, proporção, um prompt por variação. É texto, então é barato e fácil de revisar.
Etapa 2: o MCP gera. O agente chama a ferramenta correspondente do 8frame com cada prompt e o modelo escolhido, e os resultados voltam como links de arquivo (não como quadros do canvas). Para um conjunto de variações, o agente se abre em leque: três ou quatro prompts, três ou quatro clipes, de 258 a 344 créditos no Kling v3 Standard (86 por clipe).
Etapa 3: uma pessoa aprova. O conjunto gerado chega a uma pessoa, que aprova, sinaliza ou pede uma revisão. Só os materiais aprovados seguem para publicação. É essa a barreira que impede uma etapa de geração probabilística de publicar algo errado.
Esse ciclo reflete como o padrão de agente funciona em geral: entra um objetivo, há chamadas de ferramentas, uma avaliação e uma condição de parada que passa a vez para uma pessoa quando é preciso julgamento. A geração de vídeo é exatamente o tipo de etapa que não se automatiza por inteiro, porque a falha (um produto deformado, um visual fora da marca) é visual e subjetiva.
Duas decisões de design que importam
Coloque a pessoa antes da publicação, não antes de cada geração. Um clipe que ninguém usa custa só os créditos dele, e o limite de leque logo abaixo controla isso. Então deixe o agente gerar, junte os arquivos que voltam para revisão e coloque a aprovação entre "gerado" e "entregue ao cliente ou à conta de anúncios", onde um erro custa mais que créditos. Se quiser uma checagem antes, aprove os prompts redigidos: são texto e se revisam rápido.
Limite o leque. Um agente que pode chamar uma ferramenta de geração em loop também pode gastar créditos em loop. Defina um limite de gerações por execução: um briefing que deveria produzir quatro variações não deveria conseguir disparar quarenta por um erro de planejamento. Fixe também o nível do modelo, porque uma chamada ao Veo que não diz o nível roda o Standard, a 448 créditos. O 8frame também limita, por usuário e por dia, os créditos gastos pelo conector, como trava de segurança; trate isso como rede de proteção, não como o seu orçamento.
Um exemplo completo
Um agente que cuida dos criativos de social pago de uma marca DTC (venda direta ao consumidor):
- Entrada: "Novo teste de ganchos para o suplemento do sono, quatro ângulos, vertical."
- O agente redige quatro prompts, cada um com um ângulo diferente de gancho UGC (primeiro o problema, primeiro o produto, depoimento, antes e depois), todos verticais.
- Ele chama quatro vezes a ferramenta Kling do 8frame (Kling v3 Standard), com uma foto de produto vertical 9:16 como imagem inicial. Com imagem inicial, a chamada ao Kling não envia proporção ao modelo, então é a foto que define o formato. Quatro clipes de 5 segundos com som custam 344 créditos, cerca de US$ 3,44.
- O conjunto chega a quem cuida de performance, que aprova dois, descarta um e pede para refazer o quarto com um prompt ajustado que o agente sugere. Refazer é mais um clipe de 86 créditos, então a execução fecha em 430 créditos, cerca de US$ 4,30.
- Os clipes aprovados vão para a conta de anúncios.
O agente fez a parte chata (redigir e gerar variações); a pessoa fez a parte de julgamento (quais ganchos merecem verba). Essa divisão é justamente a ideia.
Limites para levar em conta no desenho
A latência é real. Uma geração de vídeo leva de cerca de um minuto (um clipe de 5 segundos do Kling v3 Standard, mediana no 8frame) a cerca de cinco minutos (Seedance 2.5 em 720p, a versão que o conector roda, mediana no 8frame). O conector espera até 10 minutos e depois devolve um ID de tarefa que a ferramenta de consulta acompanha. Trate essas chamadas como assíncronas e informe o progresso em vez de ficar travado.
A revisão não pode ser pulada. O ciclo de três etapas existe porque a geração é probabilística. Um agente que publica sozinho, mais cedo ou mais tarde, vai publicar um quadro ruim. Mantenha a aprovação humana.
O controle fino continua no canvas. O conector expõe menos ajustes que o canvas: duração do clipe e modo sem som no Kling e no Veo, quadros finais, Kling v3 Pro e Nano Banana Pro ficam só no canvas. Para as tomadas que precisam disso, ou de uma composição precisa a partir de muitas imagens de referência, alguém abre o canvas diretamente. O agente cuida do volume e dos rascunhos; o canvas, das tomadas que pedem direção à mão.
Perguntas frequentes
Como conecto um agente ao 8frame?
Registre https://mcp.8frame.co/mcp como servidor MCP remoto no seu cliente ou framework e entre na sua conta do 8frame. No Claude Code: claude mcp add --transport http 8frame https://mcp.8frame.co/mcp, e depois /mcp para fazer login.
O servidor MCP escolhe o modelo?
Não. Cada ferramenta roda uma família de modelos, e as ferramentas de "escolher um modelo" mostram as opções com o custo em créditos; as regras do seu agente também podem escolher. Quando uma chamada não diz o nível, vale o padrão da ferramenta: no Veo, é o Veo 3.1 Standard, 448 créditos.
Quanto custa um conjunto de quatro clipes de variação?
Pelo conector, quatro clipes de 5 segundos do Kling v3 Standard saem por 344 créditos, cerca de US$ 3,44 no pacote; o Kling do conector roda com som e precisa de uma imagem inicial. No canvas, os mesmos quatro clipes sem som saem por 228.
Fontes
- Configuração e login do MCP do 8frame: 8frame.co/mcp, acessada em 2026-10-01
- Ferramentas, modelos, padrões, preços, seletor de modelo, tempo máximo de espera e limite diário do conector: código do servidor MCP do 8frame, lido em 2026-10-01
- Chamada ao Kling v3 sem proporção quando há imagem inicial: código de geração de vídeo do back-end do 8frame, lido em 2026-10-01
- Preços do canvas (clipe do Kling sem som): registro de ferramentas do 8frame, 2026-09-30
- Tempos de geração: dados de produção do 8frame, somente leitura, medianas de 120 dias até 2026-09-30
- MCP apresentado pela Anthropic em 25 de novembro de 2024: Introducing the Model Context Protocol, acessada em 2026-10-01
- Suporte a MCP no Claude, ChatGPT, VS Code e Cursor: What is the Model Context Protocol (MCP)?, acessada em 2026-10-01
- Comando do Claude Code e login com
/mcp: Claude Code docs, MCP, acessada em 2026-10-01 - Preço do Veo 3.1 Standard na API (US$ 0,40 por segundo com áudio, 720p e 1080p): Gemini API pricing, acessada em 2026-10-01
Leia também
Para entender o protocolo que o seu agente fala, comece por o que é MCP. Para a versão desta configuração em que você escreve os prompts à mão, veja como gerar vídeo com IA no Claude ou, para desenvolvedores, vídeo com IA no Cursor e no Claude Code.
Dê ao seu agente geração criativa por um único servidor. A configuração MCP do 8frame já está no ar, ou explore a biblioteca de canvas e fluxos de trabalho para as tomadas que você dirige à mão.
Experimente sem cadastro: você cai direto num quadro real. O canvas do 8frame é gratuito e ilimitado; a geração é paga a partir de US$ 19 por mês.