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.
- 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.
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
Passo a passo: configurar o ads MCP server (interface visual)
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.
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:
{
"mcpServers": {
"meta-ads": {
"command": "npx",
"args": [
"-y",
"@meta/ads-mcp-server"
]
}
}
}
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
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.
Passo a passo: configurar o ads CLI (linha de comando)
Instale o ads CLI globalmente
Abra o terminal e execute:
npm install -g @meta/ads-cli
Confirme a instalação com:
meta-ads --version
Obtenha um token de acesso
Acesse developers.facebook.com/tools/accesstoken e gere um token de usuário com as seguintes permissões:
ads_managementads_readbusiness_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.
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
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
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
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
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
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.