
Você opera mídia paga com um agente de IA conectando ele a uma camada de dados governada via MCP, para que leia o desempenho em SQL e opere Google, Meta e LinkedIn por um gateway MCP, com aprovação humana e zero credencial de plataforma de anúncio no código. A mesma camada governada que mede a atribuição é a que age, e é por isso que o agente consegue criar, pausar e ajustar campanhas sem um único token guardado. Este guia percorre a arquitetura, a fundação de dados e as lições embutidas num starter open-source.
Você conecta o agente a uma camada de dados governada via MCP, deixa ele ler o desempenho em SQL, e deixa ele operar as plataformas de anúncio por um gateway MCP, com cada escrita travada por aprovação humana, e zero credencial de plataforma de anúncio no código. Essa última parte é a virada. O jeito clássico de automatizar anúncios guardava um token de Google, Meta e LinkedIn num arquivo .env, cada um com a própria aprovação, expiração e rate limit para cuidar. O jeito MCP-first não guarda nenhum: a autenticação é OAuth, tratada pelo protocolo, e a credencial nunca toca o repositório. A mesma camada governada que mede a atribuição é a que age, então o agente que te diz que um canal está indo mal é o agente que consegue pausá-lo.
O agente gerencia campanhas em Google, Meta e LinkedIn com zero token de API no repositório. A autenticação é OAuth via MCP, então não há credencial de plataforma para guardar, expirar ou vazar.
Isso não é um exercício teórico. É o design de um starter open-source, workshop-ads-agent-starter-mcp (MIT, nektcom), que qualquer pessoa pode clonar e apontar para o próprio produto. O resto deste guia é como ele é construído e por que cada escolha é feita.
Porque a credencial é o verdadeiro custo de manutenção, e o MCP-first a elimina. Um setup de script de API consome dado por exports de CSV ou um SDK por plataforma, opera anúncios por scripts que leem tokens de um .env, e mantém várias credenciais de plataforma no repositório. Cada token é um pequeno passivo: expira, a plataforma muda uma regra de aprovação, uma versão de API é descontinuada, e a automação que funcionava mês passado quebra esse mês. A abordagem MCP-first lê o dado em SQL pelo MCP de uma plataforma de dados e opera anúncios por um gateway MCP com OAuth, então o número de credenciais no código é zero.
| Aspecto | Clássico (scripts de API) | MCP-first |
|---|---|---|
| Consumo de dados | Exports de CSV ou um SDK por plataforma | SQL pelo MCP da plataforma de dados |
| Operação de anúncios | Scripts com tokens no .env | Gateway MCP com OAuth |
| Credenciais no repositório | Vários tokens de plataforma | Nenhuma |
| Trocar de produto | Reconfigurar tudo | Trocar uma pasta de knowledge |
O benefício paralelo é portabilidade. Como o contexto específico do produto vive numa pasta só e as credenciais não vivem em lugar nenhum, o mesmo agente serve qualquer empresa trocando essa pasta. O trabalho difícil e recorrente de integração é carregado uma vez, por baixo, pela plataforma de dados.
Ele lê e entende o desempenho, depois opera as plataformas, e cada mudança espera um sim humano. No lado da leitura, ele responde as perguntas que uma pessoa de Growth ou RevOps realmente faz: quanto cada canal custou por cliente, qual criativo está fatigando, quais termos de busca estão desperdiçando investimento. No lado da escrita, ele cria campanhas, pausa o que não converte, move budget para o que ganha, adiciona palavras-chave negativas, e sobe criativo e copy. Hoje ele opera Google, Meta e LinkedIn pelo gateway.
Duas regras de segurança enquadram cada escrita. O agente propõe uma mudança e espera aprovação explícita antes de executar, e sobe testes em estado pausado, para uma pessoa revisar o criativo e a copy antes de qualquer coisa ir ao ar. Ele está operando dinheiro de verdade, e a responsabilidade pelo que sobe fica com o humano. A copy respeita os limites de cada plataforma, que o agente conhece (hoje, cerca de 30 caracteres para um título do Google, 40 para o Meta, 70 para o LinkedIn, embora as plataformas mudem isso), para um rascunho não ser cortado na publicação.
Três camadas: quem o agente é, o que ele sabe fazer, e o que ele sabe sobre o seu produto. No starter, essas são arquivos concretos.
Separar isso é o que torna o agente portátil e honesto. As skills são ofício geral; o knowledge é específico seu; o agente une os dois. Escrever uma regra do produto no knowledge, em vez de num prompt, é a mesma disciplina de context engineering para agentes de IA: a regra vive num lugar só e vale em todo lugar.
Com um loop semanal e um registro escrito dos experimentos, para ele não reaprender a mesma lição duas vezes. Mídia paga é uma sequência de testes, e o erro caro é rodar um experimento que já falhou porque ninguém anotou que falhou. O agente mantém um registro do que foi testado, do que custou, e do que aconteceu, e lê isso antes de propor o próximo teste. Esse registro é memória no sentido mais literal: a diferença entre um time que acumula o que aprende e um que recomeça toda segunda.
O loop espelha como um operador disciplinado trabalha: revisar o que subiu e o que rendeu, decidir o próximo teste por evidência em vez de instinto, subir pausado para aprovação, e registrar o resultado de volta. Cada volta fica um pouco mais afiada que a anterior porque a camada por baixo lembra.
Dois modos de dado, um modelo consolidado, e uma camada semântica em cima. O agente precisa tanto de um histórico durável quanto de uma visão ao vivo, e eles vêm de lugares diferentes.
Sem essa fundação, o agente reinventa a conta a cada pergunta, e os números variam entre execuções, a falha descrita em por que agentes de IA dão respostas diferentes para o mesmo dado.
As skills codificam regras que são baratas de ler e foram caras de aprender. Cinco carregam a maior parte do peso.
A Nekt é uma plataforma de dados que dá contexto governado para agentes de IA, e operar anúncios é o caso em que esse contexto também age.
O ganho é um loop em vez de um relatório: a camada que mede um canal com honestidade é a camada que age sobre ele, e nada disso exige um token num arquivo.
Não. No design MCP-first, a autenticação é OAuth tratada pelo protocolo, então não há tokens de Google, Meta ou LinkedIn guardados no repositório. Isso tira a manutenção usual de aprovações, tokens que expiram e rate limits, e tira o risco de uma credencial vazar do código.
Ele opera. Pelo gateway MCP o agente consegue criar campanhas, pausar o que não converte, mover budget, gerenciar palavras-chave negativas, e subir criativo e copy, em Google, Meta e LinkedIn. Ler o desempenho é a outra metade; o ponto do design é que a mesma camada faz as duas coisas.
Cada escrita espera aprovação humana explícita, e os testes sobem em estado pausado para uma pessoa revisar o criativo e a copy antes de ir ao ar. O agente propõe; o humano decide o que sobe. Ele está operando budget de verdade, e essa fronteira é proposital.