Meta CLI e MCP: guia prático para anúncios com IA

A Meta Marketing API continua poderosa, mas a distância entre uma ideia de campanha e um anúncio criado ainda passa por tokens, IDs de página, encoding de vídeo, segmentação e validação de orçamento. Este guia mostra como usar Meta CLI e Meta MCP para transformar esse fluxo em uma esteira auditável, segura e operável por agentes como Claude Code, Codex, Antigravity e agentes terminal-first como DeepSeek TUI.

O ponto central é simples: Meta CLI não deve ser tratado como “atalho para clicar menos”, mas como uma camada de Campaign as Code para preparar campanhas pausadas, versionar decisões e reduzir erro humano antes de qualquer gasto real.

1. O que são Meta CLI e Meta MCP na prática

Meta CLI é uma ferramenta de terminal para operar a Meta Marketing API com comandos como meta campaigns create, meta adsets create, meta creatives create e meta ads create. A versão analisada também inclui um servidor MCP via meta serve, que expõe as mesmas operações como ferramentas tipadas para agentes de IA.

O recorte que muda a decisão é que o valor não está apenas em criar anúncios mais rápido. Na Techify, tratamos esse tipo de ferramenta como uma fronteira de controle: o humano define estratégia, limites e revisão; o agente executa tarefas repetitivas e retorna IDs, erros e validações em JSON.

Esse modelo combina com a evolução de integrações via MCP, em que LLMs deixam de depender de texto colado no prompt e passam a consultar ou executar ações em sistemas reais. Para Meta Ads, isso significa sair de “gerar copy” e chegar a “preparar campanha pausada com targeting, criativo e relatório”.

2. Por que MCP é melhor que pedir ao agente para digitar comandos

MCP transforma operações externas em ferramentas com nome, schema e descrição, reduzindo a chance de o agente inventar flags ou misturar IDs. Em vez de escrever um comando shell frágil, o agente chama algo como meta_create_campaign com campos explícitos: account_id, objective, daily_budget e status.

A vantagem prática é governança operacional. Um comando de terminal pode esconder efeitos colaterais em uma string longa; uma ferramenta MCP expõe argumentos de forma estruturada, permite desabilitar tools específicas e facilita auditoria. 11 ferramentas MCP cobrem autenticação, contas, páginas, assets, targeting, campanhas, adsets, criativos e anúncios no fluxo principal identificado.

Para times que já usam Claude Code ou Codex em desenvolvimento, essa diferença é decisiva: o agente não fica só revisando código, ele passa a operar APIs de negócio com contratos mais claros. A regra de segurança, porém, deve ser explícita: tools que criam ou ativam recursos precisam de escopo, orçamento e status controlado.

3. Instalação e configuração segura do Meta CLI

A instalação padrão usa um script que baixa o binário meta ou, alternativamente, go install. Depois, o fluxo mínimo é configurar o token, verificar autenticação, listar contas de anúncio e listar páginas gerenciadas antes de tentar criar qualquer campanha.

O erro mais comum é começar pelo comando de criação sem mapear pré-requisitos. Uma campanha real precisa de pelo menos quatro peças: conta de anúncios, página, objetivo e orçamento; criativos de vídeo ainda exigem upload do asset e espera do encoding. A Techify recomenda criar um checklist antes de liberar qualquer agente para operar o MCP.

meta config set access_token <SEU_TOKEN>
meta auth status
meta accounts list
meta pages list
meta targeting search --query "e-commerce" --type interests

Tokens devem ficar em variáveis de ambiente ou arquivo de configuração local, nunca no repositório. Em ambientes de agência, cada cliente deveria ter conta, orçamento e permissões isoladas para impedir que um prompt mal especificado crie recursos no ad account errado.

4. Fluxo completo: campanha, adset, creative e ad

O pipeline real segue uma ordem rígida: autenticar, escolher conta, escolher página, pesquisar targeting, criar campanha, criar adset, subir asset, verificar vídeo, criar creative e criar ad. Pular essa ordem aumenta erros porque a Meta Marketing API depende de IDs retornados nas etapas anteriores.

O dado importante para decisão é que 4 objetos concentram o fluxo de veiculação: campanha, conjunto de anúncios, criativo e anúncio. A campanha define objetivo e orçamento macro; o adset define público e otimização; o creative define mídia e copy; o ad liga tudo e controla o status final.

Para PMEs, o padrão seguro é “preparar tudo pausado”. Isso permite que o agente gere variações, mas mantém a decisão de gasto com o operador. Em vez de pedir “publique uma campanha”, o prompt certo é “crie uma estrutura pausada, retorne IDs e explique o que precisa ser revisado antes de ativar”.

5. Como usar com Claude Code

Claude Code pode registrar o servidor Meta MCP com claude mcp add, tornando as tools disponíveis dentro da sessão. O uso mais seguro é adicionar o servidor em escopo local ou de usuário e restringir permissões para que criação de recursos exija intenção explícita.

O que a maioria das implementações ignora é que Claude Code é excelente para transformar briefing em plano, mas não deveria ativar mídia sozinho. O melhor prompt separa fases: primeiro auditar token e listar recursos, depois montar plano, depois executar criação pausada, e por fim retornar IDs para conferência.

claude mcp add -s user meta -- meta serve

Um prompt efetivo seria: “Use o MCP da Meta para preparar uma campanha PAUSED com objetivo OUTCOME_SALES, orçamento diário máximo de R$ 100, três adsets por cluster de interesse e dois criativos. Antes de criar, mostre o plano e valide os campos obrigatórios.” Esse padrão combina bem com fluxos que combinam design, backend e automação com agentes.

6. Como usar com Codex

Codex é especialmente útil quando o objetivo é criar automações reaproveitáveis em um repositório: scripts, CLIs internas, templates YAML e validações antes de chamar meta. Em vez de pedir ao Codex para operar a campanha diretamente, vale pedir para ele construir uma camada de Campaign as Code.

Na Techify, esse desenho é preferível para times que precisam repetir lançamentos. Um arquivo YAML com produto, orçamento, país, criativos e URLs é mais auditável que um prompt solto; o Codex pode gerar o parser, validar variáveis obrigatórias e chamar meta --format json em sequência.

codex exec --full-auto 'Crie scripts/create_meta_campaign.sh usando meta-cli, com --dry-run, status PAUSED por padrão, leitura de PAGE_ID, PIXEL_ID, VIDEO_PATH e DESTINATION_URL via env, e saída campaign-output.json.'

O risco é deixar o script permissivo demais. Boas automações devem falhar se orçamento passar de um limite, se o status não for PAUSED, se o link de destino não responder ou se o token não tiver as permissões esperadas.

7. Como usar com Google Antigravity

Antigravity suporta MCP por um arquivo de configuração em ~/.gemini/antigravity/mcp_config.json ou pelo MCP Store. Para Meta CLI, a configuração customizada usa transporte stdio, apontando command para meta e args para serve.

O diferencial do Antigravity é operar dentro do workspace com visão de arquivos, planos e artefatos. Isso favorece fluxos em que o briefing, a landing page, os vídeos e o relatório final vivem no mesmo projeto. Em uma campanha madura, o agente cria um plano, executa tools MCP e salva um resumo em Markdown ou JSON para revisão.

{
  "mcpServers": {
    "meta": {
      "command": "meta",
      "args": ["serve"],
      "env": {
        "META_AD_ACCOUNT": "act_123456789",
        "META_OUTPUT_FORMAT": "json"
      }
    }
  }
}

Ao comparar com outros agentes, Antigravity tende a fazer sentido quando o trabalho mistura campanha, assets e documentação visual. Para decisão entre ferramentas, use o critério de fluxo: Claude Code para execução agentic técnica, Codex para gerar automação versionada e Antigravity para orquestrar workspace e revisão visual.

8. Tabela: CLI, MCP e agente no mesmo fluxo

A escolha entre CLI puro, MCP e agente depende do grau de repetição e risco. Quanto maior o efeito financeiro, mais estruturado deve ser o caminho de execução.

Essa tabela também explica por que o tema não é apenas “Meta Ads com IA”. A decisão correta é desenhar um sistema operacional de campanha: limites, validação, criação pausada, relatório, revisão e só então ativação manual.

9. Checklist de segurança antes de deixar um agente criar campanhas

Campanhas automatizadas precisam de travas porque o erro sai do editor e vira gasto de mídia. O checklist mínimo inclui token com escopo correto, conta explícita, orçamento máximo, status pausado, validação de URL de destino, checagem de assets e relatório com IDs.

O risco minimizado por muitos tutoriais é ativação acidental. Um agente pode interpretar “publique” como “deixe ativo”, enquanto o operador queria “prepare”. A Techify recomenda usar palavras invariáveis no prompt e no script: PAUSED, dry-run, budget_cap, review_required.

• Defina META_AD_ACCOUNT por ambiente, não no prompt.
• Bloqueie status ACTIVE por padrão.
• Use --dry-run ou validação antes do POST real.
• Registre IDs criados em JSON para auditoria.
• Separe criação de ativação em etapas humanas diferentes.

Cada campanha criada sem trilha de auditoria aumenta o risco de gastar orçamento em público, página ou URL errados enquanto concorrentes validam ofertas com ciclos mais controlados.

10. Conclusão: use agentes para preparar, não para gastar sem revisão

Meta CLI e Meta MCP são valiosos quando viram uma camada de operação controlada sobre a Meta Marketing API, não quando substituem julgamento estratégico. O ganho real está em reduzir trabalho repetitivo, padronizar campanhas e criar uma trilha auditável antes de qualquer ativação.

Se sua empresa quer conectar IA, automação e mídia paga com segurança, a Techify pode ajudar a desenhar o fluxo: briefing estruturado, agentes com MCP, validações, logs e revisão humana. Fale com a equipe em Techify para transformar campanhas em processos confiáveis.