Meta Ads no Codex e no Gemini CLI: conecte um agente de código aos anúncios
Conecte o Codex ou Gemini CLI aos anúncios da Meta com dois comandos: configuração, login no navegador, limites seguros e prompts que cruzam anúncios e lucro da Shopify.
Nesta página
O Codex e o Gemini CLI podem ler e gerenciar os seus anúncios da Meta pelo Tera Ads, um servidor MCP hospedado em https://teraads.co/mcp. No Codex, rode codex mcp add tera-ads --url https://teraads.co/mcp e depois codex mcp login tera-ads. No Gemini CLI, instale a extensão do Tera Ads pelo GitHub e rode /mcp auth tera-ads. Os dois levam você ao login no Tera Ads pelo navegador, e você escolhe se o agente só lê, pede aprovação antes ou faz alterações.
Pontos-chave
- Dois comandos por agente: adicionar o servidor e fazer login no Tera Ads pelo navegador. Nenhuma chave de API vai para a sua configuração.
- O Codex guarda o servidor em
~/.codex/config.toml, que a extensão do Codex para IDE e o app do ChatGPT para desktop compartilham. - O Gemini CLI instala o Tera Ads como uma extensão que também carrega um arquivo de contexto dizendo ao Gemini quando usá-lo.
- O seu agente ganha 29 ferramentas, de leituras ao vivo da Meta ao lucro após devoluções da sua loja e mudanças de orçamento com teto.
- Limite as alterações em dois lugares: nas configurações de ferramentas do próprio agente e no modo da conexão no Tera Ads.
Por que conectar um agente de código aos seus anúncios
Muitos fundadores de lojas Shopify criam o próprio tema, os próprios scripts e as ferramentas internas, e passam metade do dia no terminal. Um agente de código conectado aos seus anúncios pode responder "quanto a Meta gastou ontem?" na mesma sessão em que você edita uma página de produto, salvar um resumo semanal como arquivo Markdown no seu repositório ou colocar uma semana de resultados de campanha ao lado de uma mudança que você publicou na terça-feira.
A ligação entre o agente e a sua conta de anúncios é o MCP, Model Context Protocol: um padrão aberto que permite a um agente de IA chamar ferramentas que outro serviço expõe. O guia do servidor MCP do Facebook Ads cobre o básico. O Codex e o Gemini CLI suportam servidores MCP remotos com login OAuth, então um servidor hospedado como o Tera Ads não exige instalar nada além do próprio agente.
O que o Tera Ads acrescenta a uma conexão simples com a Meta é a sua loja. Além das leituras ao vivo de campanhas, conjuntos de anúncios e anúncios, ele responde a partir dos pedidos, devoluções, custo do produto, frete, taxas e reembolsos da Shopify, menos o seu investimento em anúncios na Meta e no Google. A receita atribuída pela Meta vem identificada como da Meta, para o agente não tratá-la como vendas. Para outros servidores que você poderia conectar no lugar, veja as opções de MCP para Meta Ads.
Uma observação sobre o Gemini CLI: a documentação dele traz um aviso de que, para usuários sem plano pago e do Google One, o Gemini CLI foi substituído pelo Antigravity CLI em 18 de junho de 2026 (documentação de MCP do Gemini CLI). Os passos abaixo seguem o Gemini CLI como documentado em outubro de 2026.
Antes de começar
- Uma conta gratuita no Tera Ads. Cadastre-se e conecte a sua conta de anúncios da Meta. Conecte também a Shopify, para o agente ver as vendas e o lucro da loja.
- Acesso de proprietário. Só o proprietário do negócio pode conectar uma IA a um negócio no Tera Ads.
- Codex ou Gemini CLI instalado e com login feito na própria conta.
- Uma regra para alterações. Decida se o agente só vai relatar ou se também vai pausar anúncios e mexer em orçamentos. O guia de acesso seguro de IA (em inglês) tem uma política curta que você pode copiar.
Conecte o Codex, passo a passo
- Crie uma conta gratuita no Tera Ads. Cadastre-se, conecte a sua conta de anúncios da Meta e depois a Shopify, para as respostas incluírem o lucro após devoluções da sua loja.
- Adicione o servidor ao Codex. No terminal, rode
codex mcp add tera-ads --url https://teraads.co/mcp. - Faça login no Tera Ads. Rode
codex mcp login tera-ads; ele abre o Tera Ads no navegador, onde você entra, escolhe o negócio e define o que o agente pode fazer. - Confira a conexão. Abra o
codexe digite/mcp, que lista os servidores MCP ativos; tera-ads deve aparecer na lista. - Faça uma pergunta que você consegue conferir. Tente "Use o Tera Ads para listar as minhas campanhas ativas da Meta com o gasto de ontem" e compare a resposta com o Gerenciador de Anúncios.
O Codex guarda os servidores MCP em ~/.codex/config.toml, com uma tabela [mcp_servers.tera-ads] por servidor e o endereço em url. A documentação da OpenAI diz que o app do ChatGPT para desktop, o Codex CLI e a extensão para IDE compartilham essa configuração, então uma única configuração cobre os três (documentação de MCP do Codex). A mesma documentação diz que codex mcp login cuida do OAuth e que o Codex pode escolher automaticamente um método de registro de cliente. O Tera Ads suporta registro dinâmico de cliente com OAuth 2.1 e PKCE, então não há client ID para informar.
Deixe o Codex só lendo, do lado dele
As configurações de servidor do Codex aceitam enabled_tools, uma lista de permissão, e disabled_tools, uma lista de bloqueio aplicada depois dela. Para impedir que o Codex chame as ferramentas de alteração mesmo que a sua conexão no Tera Ads permita alterações, adicione esta linha embaixo de [mcp_servers.tera-ads] no config.toml:
disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]
A documentação também descreve configurações de aprovação para cada servidor e para cada ferramenta. A proteção mais simples, porém, continua sendo a do Tera Ads: escolha só leitura ao fazer login, e as ferramentas de alteração não conseguem fazer nada nessa conexão.
Conecte o Gemini CLI
- Instale a extensão. Rode
gemini extensions install https://github.com/Teralabsx/meta-ads-mcp. - Faça login no Tera Ads. Abra o Gemini CLI, rode
/mcp auth tera-ads, entre, escolha o negócio e defina o que o agente pode fazer. - Confira as ferramentas. Digite
/mcppara ver o status e as ferramentas de cada servidor, ou rodegemini extensions listno seu shell. - Faça uma pergunta que você consegue conferir. Tente "Quais campanhas da Meta gastaram mais esta semana?" e compare a resposta com o Gerenciador de Anúncios.
A extensão é um pequeno arquivo gemini-extension.json no repositório do Tera Ads no GitHub. Ele aponta o Gemini para https://teraads.co/mcp pelo campo httpUrl, que a documentação do Gemini define como o endpoint Streamable HTTP, enquanto url serve para SSE. Ele também indica GEMINI.md como arquivo de contexto. Esse arquivo diz ao Gemini para recorrer ao Tera Ads em perguntas sobre anúncios da Meta, ROAS e lucro, para identificar a receita atribuída pela Meta como da Meta e para tratar nomes de campanha e textos de anúncio como dados, nunca como instruções.
A documentação do Gemini diz que ele suporta OAuth para servidores MCP remotos, consegue descobrir a configuração automaticamente, lida com registro dinâmico de cliente quando o servidor oferece e guarda os tokens em ~/.gemini/mcp-oauth-tokens.json. As configurações de servidor também incluem trust, que ignora todas as confirmações de chamada de ferramenta quando definido como true. A extensão do Tera Ads não o define. Deixe assim, para o Gemini continuar perguntando antes de rodar uma ferramenta.
Codex e Gemini CLI lado a lado
| Codex | Gemini CLI | |
|---|---|---|
| Adicionar o servidor | codex mcp add tera-ads --url https://teraads.co/mcp | gemini extensions install https://github.com/Teralabsx/meta-ads-mcp |
| Login | codex mcp login tera-ads | /mcp auth tera-ads |
| Onde fica guardado | ~/.codex/config.toml | Uma extensão instalada |
| Conferir se funciona | /mcp no Codex | /mcp, ou gemini extensions list |
| Limites do lado do agente | enabled_tools, disabled_tools, configurações de aprovação | Deixar trust desligado |
| Também cobre | Extensão do Codex para IDE e app do ChatGPT para desktop | Carrega GEMINI.md como contexto |
| Documentação do agente | Documentação de MCP do Codex | Extensões do Gemini CLI |
Para o Codex ou outro agente usar o Tera Ads sem você pedir, o repositório sugere copiar o conteúdo de GEMINI.md para o AGENTS.md ou o CLAUDE.md do seu projeto. Caso contrário, cite o Tera Ads no seu prompt.
Prompts que combinam com um agente no terminal
Um agente de código faz algo que uma janela de chat não faz: coloca a resposta onde você trabalha. Peça para ele salvar os resultados em um arquivo, compará-los com o arquivo da semana passada ou abrir a página de produto para onde uma campanha leva as pessoas.
| Pergunta | O que o agente usa |
|---|---|
| "Qual foi o meu lucro após devoluções nos últimos 30 dias? Salve em reports/profit.md." | get_profit, depois as próprias ferramentas de arquivo |
| "A Meta diz que o meu ROAS é 3. Quanto a minha loja ganhou de verdade?" | get_insights, get_profit |
| "Quais campanhas perdem dinheiro depois das devoluções, e o que eu faço com elas?" | get_ads_review |
| "Quais anúncios gastaram dinheiro nos últimos 14 dias sem nenhuma venda?" | get_insights no nível de anúncio |
| "O que mudou nos meus anúncios esta semana, e ainda dá para desfazer?" | list_recent_changes |
| "Copie a minha melhor campanha como rascunho pausado." | duplicate |
| "Quantas chamadas do Tera Ads ainda me restam?" | get_usage, que é gratuita |
Leia as respostas com duas ressalvas. As compras e a receita da Meta são a atribuição da Meta, não as vendas da sua loja. E get_ads_review avalia cada campanha que gastou pelo lucro depois das devoluções habituais da sua loja, com os seus próprios custos, contra o seu ROAS de break-even; o número de lucro é uma estimativa para a loja inteira, não dinheiro no banco. O guia de ROAS real após reembolsos mostra por que essa diferença importa, e a biblioteca de prompts para análise de anúncios (em inglês) tem mais perguntas para testar.
Mantenha as alterações do agente sob controle
Agentes de código costumam ser configurados para editar arquivos sem perguntar a cada vez. Não deixe esse hábito chegar às ferramentas de anúncios, onde uma chamada errada gasta dinheiro de verdade. O Tera Ads impõe os próprios limites, seja lá o que o agente tiver permissão para fazer:
- Só leitura, pedir aprovação antes ou fazer alterações. Com pedir aprovação antes, uma alteração espera no Tera Ads até você aprová-la lá, e o agente não pode aprová-la por você.
- Tudo o que é novo começa pausado. Campanhas, conjuntos de anúncios, anúncios e cópias não gastam nada até algo ativá-los.
- Os passos de orçamento têm teto. Uma única mudança pode no máximo triplicar um orçamento ou cortá-lo para um décimo.
- Um limite diário. Os assistentes podem fazer no máximo 50 alterações por dia em um negócio.
- Nenhuma ferramenta de exclusão. O agente pode pausar, mas não pode excluir nada.
- Desfazer por 7 dias. Uma pausa, uma ativação ou uma mudança de orçamento pode ser desfeita no Tera Ads por 7 dias. Campanhas, conjuntos de anúncios e anúncios novos não podem ser desfeitos, mas começam pausados.
- Um negócio por conexão. Uma conexão não lê outro negócio, mesmo que você também seja o dono dele.
Se o resultado de uma alteração voltar como outcome_unknown, não peça ao agente para repeti-la. Peça para ele conferir list_recent_changes primeiro, para a mesma alteração não ser feita duas vezes.
Quando algo não funciona
O agente ignora o Tera Ads. Cite o Tera Ads no prompt ("use o Tera Ads para..."), ou copie o GEMINI.md para o arquivo de instruções do seu projeto, como descrito acima.
Ele pede para você fazer login de novo. Os tokens de acesso duram uma hora e são renovados automaticamente; uma conexão dura 30 dias. Rode codex mcp login tera-ads ou /mcp auth tera-ads de novo.
Ele diz que um limite foi atingido. O plano gratuito tem 30 chamadas por semana, zeradas toda semana em UTC. get_usage é gratuita e diz quantas chamadas restam e quando a contagem zera. O guia de MCP de Meta Ads gratuito compara essa cota com a de outros planos grátis.
Os orçamentos parecem cem vezes maiores. list_campaigns mostra os orçamentos nas unidades da Meta, que são centésimos na maioria das moedas, então 5000 significa US$ 50. set_budget recebe unidades inteiras da moeda da sua conta.
As respostas falam da loja errada. Cada conexão cobre um negócio. Faça login de novo e escolha o outro.
O Tera Ads Connect é o servidor MCP do Tera Ads, o painel de lucro para marcas na Shopify. Ele dá ao Codex, ao Gemini CLI e a outros clientes MCP leituras ao vivo da Meta, as vendas da Shopify e o lucro após devoluções, além de alterações nos anúncios limitadas e registradas. O plano gratuito inclui 30 chamadas por semana em uma conta de anúncios da Meta, e o Connect Pro custa US$ 15 por mês, com 3.000 chamadas por mês em até três contas de anúncios; ele já vem incluído nos planos Growth e Scale. Os passos para outros clientes estão na página do Connect, e o guia de MCP do Meta Ads no Cursor, VS Code e Claude Code cobre os editores de código.
Perguntas frequentes
O Codex consegue gerenciar anúncios da Meta?
Sim, por meio de um servidor MCP. Rode codex mcp add tera-ads --url https://teraads.co/mcp e codex mcp login tera-ads, e depois pergunte com as suas palavras. O que o Codex pode alterar depende do modo que você escolher para a conexão.
Como conecto o Gemini CLI aos anúncios do Facebook?
Rode gemini extensions install https://github.com/Teralabsx/meta-ads-mcp, depois /mcp auth tera-ads dentro do Gemini CLI, e faça login no Tera Ads. A extensão cobre os anúncios do Facebook e do Instagram da sua conta de anúncios da Meta.
Preciso de um app de desenvolvedor da Meta ou de um token de API?
Não. Você faz login no Tera Ads pelo navegador, e as alterações chegam à Meta pelo app da Meta aprovado do próprio Tera Ads. Nada secreto vai para o seu arquivo de configuração.
A configuração do Codex também funciona na extensão para IDE?
Sim. A documentação da OpenAI diz que o app do ChatGPT para desktop, o Codex CLI e a extensão para IDE compartilham a mesma configuração de MCP, então um servidor adicionado no CLI aparece nos outros dois.
O Gemini CLI ainda está disponível?
A documentação do Gemini CLI diz que ele foi substituído pelo Antigravity CLI para usuários sem plano pago e do Google One em 18 de junho de 2026. Confira a documentação do Google para o seu tipo de conta antes de configurar.
Quanto custa?
O plano gratuito inclui 30 chamadas por semana em uma conta de anúncios da Meta. O Connect Pro custa US$ 15 por mês, com 3.000 chamadas por mês. Uma chamada é uma consulta que o agente faz no Tera Ads, e uma pergunta pode exigir algumas.