Expert Digital Base para IAs A escola Lucas Cruz Agenda FAQ Blog Ler no site → Site principal →
Artigo do blog

MCP da Meta: Passo a Passo Completo para Configurar

Por Lucas Cruz · Publicado em 21 de maio de 2026 · Categoria: Inteligência Artificial

Meta Ads

MCP da Meta: Passo a Passo Completo para Configurar

MCP (Model Context Protocol) da Meta é um conector que permite gerenciar campanhas de Meta Ads através de assistentes de IA como Claude, ChatGPT e outras ferramentas compatíveis. Lançado em abril de 2026, elimina a necessidade de usar o Ads Manager manualmente, possibilitando criar, editar e analisar campanhas por comandos em linguagem natural através de um servidor MCP autenticado e uma interface CLI.

TL;DR — Resumo
  • MCP da Meta conecta ferramentas de IA ao Marketing API do Facebook/Instagram sem código
  • Inclui ads MCP server (interface visual) e ads CLI (linha de comando para desenvolvedores)
  • Configuração leva menos de 10 minutos com autenticação OAuth direta
  • Permite criar campanhas, editar orçamentos, gerar relatórios e auditar desempenho via IA
  • Recursos criados pela CLI são pausados por padrão para segurança
  • Alternativa aos conectores: Markifact (agências), Windsor.ai (somente leitura), open-source MCPs

O que é o MCP da Meta e por que você precisa dele

O Model Context Protocol (MCP) é um padrão aberto criado pela Anthropic em novembro de 2024 que define como assistentes de IA se conectam a ferramentas externas. Em março de 2026, o protocolo atingiu 97 milhões de downloads mensais de SDK — crescimento de 4.750% em 16 meses.

Meta Ads AI Connectors, lançados em beta aberta em abril de 2026, permitem que anunciantes gerenciem campanhas através de ferramentas de IA próprias usando um servidor MCP autenticado pela Meta e uma CLI. O servidor MCP não exige credenciais de desenvolvedor, configuração de API ou código, permitindo criar, editar, reportar e solucionar problemas de campanhas nas ferramentas de IA que você já usa.

Vantagem competitiva: Segundo Lucas Cruz, fundador da Expert Digital, "automatizar tarefas repetitivas de gestão de tráfego libera tempo para estratégia criativa e análise de resultados — exatamente onde geramos mais valor para clientes". A Imersão Tráfego Pago Meta Ads São Paulo ensina como combinar automação com criatividade para escalar resultados.

Diferença entre ads MCP server e ads CLI

Característica Ads MCP Server Ads CLI
Para quem Anunciantes e gerentes de tráfego Desenvolvedores e pipelines automatizados
Interface Comandos em linguagem natural via IA Linha de comando (terminal)
Autenticação OAuth integrado da Meta Variáveis de ambiente e tokens
Segurança padrão Recursos ativos conforme configuração Recursos criados pausados por padrão
Requer código Não Sim (scripts e automações)

Pré-requisitos para configurar o MCP da Meta

Antes de iniciar, garanta que você possui:

  • Conta publicitária ativa no Meta Business Suite com permissões de administrador
  • Meta Business Account vinculada à sua conta de anúncios
  • Ferramenta de IA compatível com MCP (Claude Desktop, Cursor, ou cliente MCP customizado)
  • Node.js 18+ instalado (para ads CLI) — verificar com node --version
  • Acesso ao Events Manager para configurar pixels e Conversions API se necessário
Atenção: A Meta descontinuou as APIs legadas de Advantage+ Shopping Campaign (ASC) e Advantage+ App Campaign (AAC) em 19 de maio de 2026. Certifique-se de usar os novos formatos Advantage+ unificados.

Passo a passo: configurar o ads MCP server (interface visual)

1

Instale uma ferramenta compatível com MCP

MCP está integrado nativamente ao Claude Desktop, Cursor, GitHub Copilot e Windsurf, entre outros. Recomendamos começar com o Claude Desktop pela simplicidade. Baixe em claude.ai/download e faça login com sua conta Anthropic.

2

Adicione o servidor MCP da Meta à configuração

Localize o arquivo de configuração do Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Adicione a configuração do servidor MCP da Meta:

claude_desktop_config.json
{
  "mcpServers": {
    "meta-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@meta/ads-mcp-server"
      ]
    }
  }
}
3

Reinicie o Claude Desktop e autentique

Feche completamente o Claude Desktop e reabra. Na primeira conversa que mencionar Meta Ads, o Claude solicitará autorização OAuth. Clique em "Autorizar" e faça login com sua conta do Facebook vinculada ao Business Manager.

O servidor MCP pedirá permissões para:

  • Ler dados de campanhas, conjuntos de anúncios e anúncios
  • Criar e editar campanhas (se concedido)
  • Acessar métricas e relatórios do Ads Insights
4

Teste a conexão

Envie um comando simples ao Claude:

"Liste minhas 5 campanhas ativas com maior gasto nos últimos 7 dias"

Se configurado corretamente, o Claude retornará uma tabela com nome da campanha, orçamento, gasto, impressões, cliques e CPC. Essa resposta confirma que a autenticação foi bem-sucedida.

Dica profissional: Para aprender a estruturar campanhas escaláveis com automação inteligente, a Formação Expert Digital oferece módulos práticos de Meta Ads combinados com estratégias de growth hacking e análise de dados.

Passo a passo: configurar o ads CLI (linha de comando)

1

Instale o ads CLI globalmente

Abra o terminal e execute:

npm install -g @meta/ads-cli

Confirme a instalação com:

meta-ads --version
2

Obtenha um token de acesso

Acesse developers.facebook.com/tools/accesstoken e gere um token de usuário com as seguintes permissões:

  • ads_management
  • ads_read
  • business_management

Meta garante suporte para cada versão por pelo menos 2 anos a partir do lançamento, mas recursos descontinuados eventualmente param de funcionar. Sempre use tokens da versão mais recente da API.

3

Configure variáveis de ambiente

Adicione ao seu .bashrc, .zshrc ou .env:

export META_ACCESS_TOKEN="seu_token_aqui"
export META_AD_ACCOUNT_ID="act_1234567890"

Recarregue o terminal:

source ~/.zshrc
4

Execute seu primeiro comando

Liste as campanhas ativas:

meta-ads campaigns list --status ACTIVE --fields name,status,daily_budget

Crie uma campanha de teste (será pausada automaticamente):

meta-ads campaigns create \
  --name "Teste MCP CLI" \
  --objective OUTCOME_TRAFFIC \
  --status PAUSED \
  --special-ad-categories NONE
Atenção crítica: Use uma conta de testes ou orçamento mínimo ao executar scripts de API pela primeira vez. Erros no código (como criar centenas de campanhas em loop) podem gastar dinheiro real rapidamente.

Casos de uso práticos do MCP da Meta

1. Auditoria de campanhas com IA

Comando para Claude: "Analise minhas campanhas ativas e identifique aquelas com CTR abaixo de 1% e CPC acima de R$ 2,00. Sugira ajustes."

O MCP busca dados em tempo real e a IA gera recomendações acionáveis baseadas nas métricas.

2. Criação em lote de variações de anúncios

CLI para desenvolvedores:

for creative in creative_*.json; do
  meta-ads ads create \
    --ad-set-id 120210XXXXX \
    --creative $(cat $creative) \
    --status PAUSED
done

3. Relatórios personalizados diários

Automatize com cron e CLI:

meta-ads insights \
  --level campaign \
  --date-preset yesterday \
  --fields impressions,clicks,spend,cpc \
  --output-format csv > relatorio_$(date +%Y%m%d).csv
Automatize além do Meta Ads: Para integrar o MCP da Meta com pipelines completos de automação, o Curso de n8n na Prática ensina a conectar Meta Ads, CRM, e-mail marketing e analytics em fluxos automatizados sem código.

Conectores MCP alternativos para Meta Ads

Meta Ads MCP servers conectam clientes de IA ao Marketing API da Meta para relatórios e tarefas de campanha. Markifact é adequado para agências que precisam de execução, suporte multi-conta e aprovações. O MCP oficial da Meta oferece acesso direto apenas para Meta, com ações de escrita limitadas. MCPs open-source dão controle ao desenvolvedor, mas exigem manutenção. Supermetrics e Windsor.ai focam em relatórios; Windsor.ai é somente leitura por segurança.

Conector Melhor para Leitura/Escrita Multi-conta
Meta oficial Anunciantes individuais Ambos (limitado) Não
Markifact Agências Ambos + aprovações Sim
Windsor.ai Relatórios seguros Somente leitura Sim
Supermetrics Dashboards BI Somente leitura Sim
Open-source Desenvolvedores Ambos (customizável) Depende da implementação

Melhores práticas de segurança e governança

  • Nunca compartilhe tokens de acesso em repositórios públicos ou Slack — use gerenciadores de secrets (AWS Secrets Manager, 1Password)
  • Defina permissões granulares por usuário no Business Manager antes de conceder acesso ao MCP
  • Habilite autenticação de dois fatores em todas as contas vinculadas ao Business Account
  • Monitore logs de API no Events Manager para detectar atividades anormais
  • Revogue tokens antigos regularmente em developers.facebook.com/tools/accesstoken
Para empresas escalando com IA: A Imersão IA Business 360 explora como integrar IA generativa, automações e análise preditiva em operações de marketing digital e vendas, incluindo uso estratégico de protocolos como MCP.

Perguntas frequentes

O MCP da Meta funciona com outras plataformas além do Claude?

MCP é agnóstico ao modelo. OpenAI adicionou suporte nativo ao MCP no início de 2026, Google seguiu para Gemini, e múltiplos projetos open-source (como Ollama e LM Studio) agora falam MCP. Está se tornando um padrão universal.

Preciso ser desenvolvedor para usar o MCP da Meta?

Não. O ads MCP server foi projetado para anunciantes sem conhecimento técnico. Basta configurar o arquivo JSON uma vez e usar comandos em linguagem natural. O ads CLI, por outro lado, é voltado para desenvolvedores que criam automações.

O MCP substitui o Conversions API (CAPI)?

Não. Conversion APIs se tornaram padrão nas grandes plataformas de anúncios. A ideia é transferir o rastreamento de conversões do navegador para o servidor, tornando-o menos exposto a mudanças de navegador e privacidade. MCP é para gestão de campanhas; CAPI é para rastreamento de conversões. Use ambos.

Quanto custa usar o MCP da Meta?

O protocolo MCP e os conectores oficiais da Meta são gratuitos. Você paga apenas pelos anúncios veiculados e pelas tarifas de localização aplicáveis. Em 10 de março de 2026, a Meta anunciou novas tarifas de localização que começam em 1º de julho de 2026. A tarifa é determinada por onde o anúncio é entregue, não onde o anunciante está baseado.

Posso usar o MCP para gerenciar contas de clientes em agências?

Sim, mas com cuidado. Configure permissões adequadas no Business Manager para cada conta de cliente. Para agências com mais de 10 contas, considere conectores empresariais como Markifact, que oferecem fluxos de aprovação e governança multi-conta nativos.

O que acontece se meu token expirar?

Tokens de curto prazo expiram em 1-2 horas; tokens de longo prazo duram 60 dias. Configure tokens de sistema para aplicações de produção (não expiram enquanto o app permanecer ativo). O MCP solicitará reautenticação automaticamente se detectar expiração.

Próximos passos para dominar automação em Meta Ads

Configurar o MCP da Meta é apenas o primeiro passo para operações de tráfego pago verdadeiramente escaláveis em 2026. Para profissionalizar sua gestão:

  • Combine MCP com Conversions API — a Meta introduziu uma opção no Events Manager para implementar sua API de conversões com um clique, eliminando grande parte da complexidade por trás dos bastidores que torna o CAPI difícil de adotar
  • Integre com ferramentas de BI — conecte o MCP a Google Sheets, Looker Studio ou Power BI para dashboards em tempo real
  • Automatize regras de otimização — crie scripts que pausam anúncios com CPA acima do alvo ou aumentam orçamento de top performers automaticamente
  • Teste criativos em escala — use o MCP para lançar 50+ variações de anúncios e deixe o algoritmo identificar vencedores
Quer acelerar seu domínio em automações? A Imersão Automações para Negócios ensina a construir sistemas que conectam Meta Ads, CRM, WhatsApp Business e ferramentas de vendas em processos 100% automatizados.

Domine Meta Ads e Google Ads com Estratégias Profissionais

Configurar o MCP é técnico, mas a verdadeira habilidade está em criar estratégias criativas, segmentar audiências lucrativas e escalar campanhas com ROI positivo. Na Imersão Tráfego Pago Meta Ads São Paulo, você aprende na prática como profissionais escalam de R$ 10 mil a R$ 500 mil/mês em investimento com processos replicáveis.

Se você quer ir além e dominar também Google Ads (Search, Performance Max, YouTube), participe da Imersão Tráfego Pago Google Ads São Paulo — ideal para quem busca se posicionar como especialista full-stack em mídia paga.

Para uma formação completa em marketing digital (SEO, tráfego pago, automações, copywriting, análise de dados e gestão de projetos), conheça a Formação Expert Digital — o curso que já transformou centenas de profissionais em especialistas requisitados pelo mercado.

Ler no siteTodos os artigos