Meta Ads no Claude Code com um comando
Claude Code
Conecte o Meta Ads ao Claude Code: rode claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, digite /mcp e entre com seu login do PaidSync.ai.
O Claude Code acessa suas contas Meta com 92 ferramentas: desempenho por posicionamento, idade, país e dispositivo, públicos e criativos. Ele pergunta antes de cada uma; a maioria das gravações tem simulação.
Um comando. Login OAuth, sem chave. Grátis, 100 tarefas por mês, vale $50, sem cartão.
O comando
O Claude Code conversa com servidores MCP remotos por Streamable HTTP. O PaidSync é um deles. Adicione uma vez e o mesmo terminal que edita seu código poderá ler e alterar suas contas de anúncios do Meta.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor padrão, isso registra o servidor só para o projeto atual. Adicione --scope user para disponibilizá-lo em todos os projetos da sua máquina.
Execute claude mcp list para confirmar que ele está lá, depois inicie uma sessão e digite /mcp para entrar.
Configuração em 5 passos
1Cadastre-se em paidsync.ai/signup
Leva 10 segundos. Login com Google ou e-mail. O plano gratuito é de 100 tarefas por mês a $0, sem cartão.
2Conecte o Meta Ads no painel do PaidSync
Clique em Conectar no Meta Ads e entre com a conta do Facebook que gerencia seu Business Manager. O Meta Ads é autorizado via OAuth do Facebook com as permissões ads_read e ads_management. O PaidSync armazena os tokens criptografados em repouso com AES-256-GCM.
Já está dentro do Claude Code? Peça que ele execute connect_facebook_ads. A ferramenta retorna um link OAuth para abrir no navegador.
3Escolha a conta de anúncios em que o Claude Code deve trabalhar
Depois do login, o PaidSync lista as contas de anúncios do Meta que esse login alcança. Marque as que pertencem a este workspace. Dentro de uma sessão, list_fb_ad_accounts as mostra e set_fb_ad_account escolhe a ativa.
4Adicione o PaidSync ao Claude Code
No seu terminal, rode:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicie uma sessão, digite /mcp, escolha paidsync e entre com o seu login do PaidSync na janela do navegador que abrir. O Claude Code guarda o token OAuth para você. Nenhuma chave é colada em lugar nenhum.
Configurando para uma equipe? Faça commit de um .mcp.json na raiz do repositório para que todo engenheiro receba o mesmo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Prefere uma chave de API, por exemplo para execuções sem interface? Envie-a em um cabeçalho, nunca na URL, onde ela iria parar nos logs:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Em um .mcp.json commitado, adicione "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que a chave fique no ambiente de cada engenheiro e nunca entre no git. Aplicar uma alteração no Google Ads ainda exige o login OAuth. Em outras plataformas, uma chave também pode aplicar alterações, então trate-a como uma senha e prefira OAuth.
5Teste a conexão
Em uma sessão do Claude Code, peça: “Mostre o desempenho do Meta nos últimos 7 dias por campanha”
O Claude Code retorna gasto, impressões, cliques, CTR, CPC e ROAS de cada campanha na conta de anúncios ativa. A conexão está ativa.
O plano gratuito inclui 100 tarefas por mês. Pro a partir de $99 por mês, Team a partir de $249.
Prompts de Meta Ads para o Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo Meta Ads do PaidSync. O Claude Code escolhe a ferramenta. A última coluna diz se a chamada pode alterar algo na conta de anúncios.
| Pedido | Ferramentas que chama | Altera sua conta? |
|---|---|---|
| “Mostre o desempenho das campanhas nos últimos 7 dias com gasto, CTR, CPC e ROAS” | get_fb_performance | Não |
| “Quais posicionamentos geraram as conversões mais baratas neste mês?” | get_fb_performance_by_placement | Não |
| “Classifique todos os anúncios por CTR nos últimos 14 dias” | get_fb_ad_performance | Não |
| “Como está o ritmo de orçamento deste mês na conta ativa?” | get_fb_budget_pacing | Não |
| “Pause os três conjuntos de anúncios com o maior custo por resultado” | get_fb_adset_performance, pause_fb_adset | Sim, depois que você confirma |
| “Duplique o melhor conjunto de anúncios na campanha de Prospecção com seus anúncios” | duplicate_fb_adset | Sim, depois que você confirma |
| “Crie um público semelhante de 1 por cento do público Compradores nos EUA” | create_fb_lookalike_audience | Sim, depois que você confirma |
| “Monte um rascunho de campanha de Vendas com orçamento diário de $50 e mostre a prévia” | create_fb_campaign | Sim, depois que você confirma |
Execute em modo headless com claude -p
A flag -p executa o Claude Code sem a sessão interativa. Entre uma vez por /mcp e o token OAuth guardado continua valendo. Um relatório que cai em um arquivo fica assim:
claude -p "Pull last 7 days Meta performance by placement and list the placements with the highest cost per result." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/meta-ads-$(date +%F).jsonAs leituras rodam direto, e as escritas também. --allowedTools "mcp__paidsync" permite todas as ferramentas do PaidSync, escritas incluídas, sem prompt.
Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa, cada uma pelo nome como mcp__paidsync__tool_name.
O que lê e o que grava
Das 92 ferramentas do Meta Ads, 53 apenas leem e 36 podem escrever.
As leituras cobrem desempenho no nível de campanha, conjunto de anúncios e anúncio, detalhamento por idade e gênero, país, dispositivo, posicionamento e período, ritmo de orçamento, pixels, catálogos e o registro de atividade da conta.
Ler mais
As escritas cobrem campanhas, conjuntos de anúncios, anúncios, criativos, públicos, formulários de leads, regras automáticas e agendamentos de orçamento. Cada uma mostra prévia por padrão com dry_run, exceto upload_fb_ad_image e upload_fb_ad_video, que são aplicadas na primeira chamada.
Via MCP, a etapa de aprovação é o próprio prompt do Claude Code. Ele pergunta antes de executar uma ferramenta, a menos que você a tenha permitido com --allowedTools ou nas suas configurações. O PaidSync acrescenta verificações do seu lado. Exclusões, pausas e alterações de orçamento exigem confirm_destructive, e uma verificação de regras antes da gravação bloqueia argumentos inseguros. O cartão de aprovação, e o Undo em um cartão aplicado cuja alteração tem inverso seguro, valem apenas no workspace do PaidSync.
Adicionar ao ChatGPT: abra o PaidSync.ai no diretório de plugins do ChatGPT, instale e faça login.
Adicionar ao Claude: abra o PaidSync.ai no diretório de conectores do Claude, clique em Conectar e faça login.
Limites que vale conhecer
delete_fb_campaignedelete_fb_audiencesão permanentes. Pause em vez de excluir quando quiser manter o histórico.- Um conjunto de anúncios duplicado fica pausado e, por padrão, sem seus anúncios. Passe
deep_copypara copiar os anúncios também. get_fb_leadsretorna nomes, e-mails e telefones. Se você gravar a saída em um arquivo em um repositório, mantenha esse arquivo fora do controle de versão.- Onde o orçamento fica define o resto. Um orçamento na campanha significa que o Meta o divide entre os conjuntos de anúncios. Deixe-o de fora e cada conjunto de anúncios terá o seu próprio.
Perguntas frequentes
Como conecto o Meta Ads ao Claude Code?
Cadastre-se em paidsync.ai, conecte o Meta Ads via OAuth do Facebook no painel e execute claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp no terminal. Digite /mcp dentro de uma sessão, escolha paidsync e entre com seu login do PaidSync.
O Claude Code pode criar campanhas do Meta?
Sim. O Meta Ads é uma plataforma de nível de criação no PaidSync. O Claude Code pode criar campanhas, conjuntos de anúncios, anúncios e públicos. A maioria das escritas mostra antes uma prévia de simulação, e o Claude Code pergunta antes de executar cada ferramenta. Uploads de imagens e vídeos são aplicados na primeira chamada.
Quais permissões da Meta o PaidSync solicita?
O PaidSync solicita ads_read e ads_management por meio do OAuth do Facebook. Isso cobre leituras e escritas em campanhas, conjuntos de anúncios, anúncios, públicos e dados de desempenho das contas de anúncios que você conectar.
Funciona em modo headless com claude -p?
Sim. Depois de entrar por /mcp, o claude -p reutiliza o token OAuth guardado. As leituras rodam direto. As escritas exigem cuidado. Ninguém está lá para responder ao prompt do Claude Code, então qualquer ferramenta de escrita que você permitiu com --allowedTools roda direto. Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa.
É grátis?
Sim. O plano gratuito custa $0 para 100 tarefas por mês, sem cartão. O Pro começa em $99 por mês e o Team em $249 por mês.
92 ferramentas Meta Ads. Um comando no Claude Code.