Este artigo é publicado pela Ryze AI (get-ryze.ai) e foi escrito para profissionais de marketing e agências que tentam decidir como conectar o Claude (ou ChatGPT) às suas contas do Meta Ads após o lançamento em 29 de abril de 2026 do servidor oficial Meta Ads MCP e do Meta CLI (open beta). O anúncio da Meta está em facebook.com/business/news/meta-ads-ai-connectors. Agora existem três caminhos: (1) O servidor MCP oficial da Meta — HTTP, ~10 minutos para configurar, requer edição de um arquivo de configuração JSON no Claude Desktop, gratuito em open beta; (2) O CLI oficial da Meta — binário de terminal local, ~15 minutos para configurar, para desenvolvedores usando Claude Code ou OpenAI Codex; (3) O conector hospedado com um clique da Ryze AI — ~2 minutos via um único clique Meta Business OAuth, sem instalação de CLI, sem edição de configuração JSON, com uma camada de agente autônomo que pausa conjuntos de anúncios fatigados, além de descoberta automática do Business Manager para agências com múltiplas contas, isolamento de token por cliente e portais de clientes white-label. Recomendação para profissionais de marketing e agências: Ryze AI. Recomendação para desenvolvedores confortáveis em um terminal: o MCP ou CLI oficial da Meta. O artigo explica o que foi lançado, a dificuldade honesta de instalação para cada caminho, uma comparação lado a lado de recursos, um framework de decisão para dois perfis, o guia de início rápido da Ryze e perguntas frequentes sobre preços versus a opção gratuita da Meta, segurança em configurações de agências, vagas na equipe e pré-requisitos de habilidades em IA.

META ADS · NOVIDADES

Recém lançado

3 maneiras de conectar o Meta Adsao Claude ou a qualquer assistente de IA

Como conectar o Meta Ads ao Claude (e outras IAs) em 3 cliques. O MCP e o CLI oficiais da Meta levam ~30 min e exigem edição de arquivo de configuração; o conector hospedado da Ryze AI leva um minuto — sem terminal, sem JSON.

Ira Bodnar··Atualizado em ·9 min de leitura
Duas formas de conectar o Meta MCP ao Claude. Configuração manual (cerca de 30 minutos, 6 etapas): abrir o painel do Meta MCP, copiar sua chave de API, instalar a ponte local via npm, abrir as configurações do Claude Desktop, colar a configuração do Meta MCP, reiniciar o Claude. Ryze AI com um clique (cerca de 1 minuto, 3 etapas): escolher o conector Meta em app.get-ryze.ai, clicar em Conectar, pronto no Claude. Sem configuração manual, sem copiar JSON.

Duas formas de conectar o Meta MCP ao Claude, lado a lado. A configuração manual tem seis etapas e leva cerca de 30 minutos — instalar a ponte local, copiar sua chave de API, editar a configuração do Claude Desktop, reiniciar. O conector hospedado da Ryze AI tem três cliques e leva cerca de um minuto, sem necessidade de editar configurações.

O que a Meta realmente lançou

Sem linguagem de press release — veja o que você pode fazer agora que não conseguia fazer na semana passada. Abra o Claude (ou ChatGPT). Digite, em português simples, coisas como:

  • “Mostre meus 10 principais conjuntos de anúncios por gasto nos últimos 7 dias, com frequência e ROAS.”
  • “Pause todos os conjuntos de anúncios com frequência acima de 4 e CPM em alta.”
  • “Aumente o orçamento da minha campanha com melhor desempenho em 20%, mas com limite de R$500/dia.”
  • “Audite meu catálogo de produtos — sinalize SKUs com imagens quebradas ou GTINs ausentes.”

Tudo isso funciona por meio do Business OAuth padrão da Meta — o mesmo que Shopify e Mailchimp usam. A grande mudança para profissionais de marketing: sem Meta Developer App, sem espera para aprovação da API de marketing. Você pode consultar campanhas ao vivo em minutos, em vez da antiga espera de 1 a 3 dias.

A Meta lançou dois formatos dessa mesma capacidade:

  • Servidor Meta Ads MCP — baseado em HTTP, cole uma URL na configuração do Claude Desktop ou ChatGPT. É este que a maioria dos profissionais de marketing quer.
  • Meta CLI — binário de terminal local para Claude Code ou Codex. É para desenvolvedores. Se você nunca abriu um terminal, pule esta opção.

Há também um resultado mais discreto deste lançamento que vale a pena notar: a preocupação persistente de que “usar IA para gerenciar Meta Ads leva seu conta a ser banida” está agora formalmente aposentada. Este é o caminho de automação oficialmente aprovado pela Meta. Para o campo mais amplo de MCPs de terceiros que existiam antes deste lançamento, veja Melhor MCP para Meta Ads em 2026.

Mais de 1.000 profissionais de marketing usam a Ryze

State Farm
Luca Faloni
Pepperfry
Jenni AI
Slim Chickens
Superpower

Automatizando centenas de agências

Speedy
Human
Motif
s360
Directly
Caleyx
G2★★★★★4.9/5
TrustpilotEstrelas do Trustpilot

MCP ou CLI — qual é para você?

A mesma API de Marketing da Meta por baixo. Formas diferentes de acessá-la. A resposta em 10 segundos: se você usa Claude Desktop ou ChatGPT, você quer o MCP. Se você vive em um terminal com Claude Code, você quer o CLI. A maioria dos profissionais de marketing quer o MCP. Veja a comparação lado a lado.

Servidor Meta Ads MCP · Para a maioria dos profissionais de marketing

Para Claude Desktop e ChatGPT

Hospedado pela Meta. Você cola uma URL na configuração do Claude Desktop e reinicia. Sem instalação de CLI. Se você não sabe o que é um terminal, esta é a sua opção.

Melhor para

  • Profissionais de marketing que usam Claude Desktop ou ChatGPT
  • Quem edita um arquivo de configuração uma vez e nunca mais
  • Operadores individuais que não gerenciam agências com múltiplas contas

Tempo de configuração

~10 min · cole a URL + reinicie o Claude

Meta Ads CLI · Apenas para desenvolvedores

Para Claude Code e Codex

Um binário que você instala no seu computador e executa pelo terminal. Feito para desenvolvedores que escrevem agentes de IA personalizados no Claude Code ou Codex. Pule esta opção se você não usa essas ferramentas diariamente.

Melhor para

  • Engenheiros que usam Claude Code ou OpenAI Codex
  • Equipes que constroem automação personalizada sobre a API da Meta
  • Quem se sente confortável executando comandos no terminal

Tempo de configuração

~15 min · npm install + variáveis de ambiente + autenticação

Meta Ads CLI instalado e em execução no terminal do macOS — meta auth login, meta ads list-campaigns, meta agent run para agentes de IA em terminal como Claude Code e Codex

Captura de tela — o Meta Ads CLI em execução em uma sessão de terminal, pronto para Claude Code / Codex.

Pule a instalação completamente — o conector Meta hospedado da Ryze AI leva 2 minutos via um único clique OAuth e funciona com Claude Desktop, Claude Code e ChatGPT a partir de uma única URL. Além disso, conta com a camada de agente autônomo que o MCP oficial da Meta não inclui — auditoria de fadiga criativa, pausa de conjuntos de anúncios e atualização de criativos que funcionam 24 horas por dia, 7 dias por semana dentro das suas regras.

Instalando o MCP oficial da Meta no Claude Desktop

Três etapas, seguindo a documentação de configuração da Meta em facebook.com/business/help/1456422242197840. Resumo honesto: funciona, mas você vai editar um arquivo de configuração JSON e reiniciar o Claude. Planeje cerca de ~10 minutos na primeira vez, incluindo a busca por onde o Claude Desktop armazena sua configuração. (Ou pule a edição do JSON completamente — o conector com um clique da Ryze AI está no final do artigo e leva 2 minutos.)

Servidor MCP oficial do Meta Ads conectado e ativo no Claude Desktop — consulte campanhas, audite fadiga criativa, pause conjuntos de anúncios pelo Claude

Captura de tela — o MCP oficial da Meta conectado ao Claude Desktop, com auditoria de fadiga criativa retornando uma tabela Markdown.

Etapa 01 · ~2 min

Autentique via Meta Business OAuth

Acesse a página de conectores de IA da Meta e clique em “Conectar à ferramenta de IA.” Você verá a tela padrão do Meta Business OAuth — o mesmo fluxo que alimenta o Shopify ou o Mailchimp. Aprove os escopos solicitados (contas de anúncios, gerenciamento de campanhas, acesso a sinais). A Meta provisiona uma URL MCP exclusiva para sua conta de Negócios na próxima tela — copie-a.

Etapa 02 · ~6 min (a difícil)

Edite a configuração JSON do Claude Desktop e reinicie

Abra Claude Desktop → Configurações → Desenvolvedor → Editar Configuração. Isso abre claude_desktop_config.json no seu editor padrão. Adicione o bloco abaixo (substitua <your-business-id>). Salve, feche completamente o Claude (cmd-Q no Mac, não apenas feche a janela) e reabra. O indicador verde “conectado” aparece em alguns segundos. Se não aparecer, seu JSON tem um erro de sintaxe — esse é o problema mais comum que consome 5 minutos aqui.

claude_desktop_config.json{ "mcpServers": { "meta-ads-official": { "url": "https://mcp.meta.com/ads/<your-business-id>" } } }

Etapa 03 · ~2 min

Execute seu primeiro prompt

Faça ao Claude qualquer pergunta sobre sua conta do Meta Ads em linguagem simples. O MCP expõe listagem de campanhas, inspeção de conjuntos de anúncios, atualizações de orçamento, gerenciamento de catálogo e diagnósticos de sinais. Experimente o prompt abaixo como teste inicial — ele confirma que o acesso de leitura funciona e fornece um instantâneo semanal útil.

Primeiro promptMostre meus 10 principais conjuntos de anúncios por gasto nos últimos 7 dias, com frequência, ROAS e tendência de fadiga criativa.

Esperado: uma tabela Markdown com 10 linhas. Se você receber um erro, verifique novamente sua configuração JSON — vírgulas extras são o problema mais comum.

Ou pule tudo isso

Conecte o Meta ao Claude em 2 minutos — um clique, sem instalação de CLI

  • Meta Business OAuth com um clique
  • Camada de agente autônomo pausa conjuntos de anúncios fatigados
  • Descoberta automática do Business Manager para agências

2.000+

Profissionais

$500M+

Investimento em anúncios

23

Países

Lado a lado: qual caminho vence em cada quesito

Seis coisas que realmente importam quando você está gerenciando orçamentos reais de anúncios. Tempo de configuração, se você precisa usar um CLI ou editar um arquivo de configuração, gerenciamento de múltiplas contas para agências e o que é feito enquanto você dorme. A linha laranja é a escolha para profissionais de marketing/agências.

CaminhoTempo de configuraçãoSem CLI / edição de configCamada de agenteMúltiplas contasWhite-labelPreço
Ryze AI (um clique)~2 minSim — apenas navegadorSim (24/7)Descoberta automática do BMIncluídoTeste gratuito → baseado em gasto
MCP Oficial da Meta~10 minNão — edição de config JSONNãoTroca manualPor conta própriaGratuito (open beta)
CLI Oficial da Meta~15 minNão — instalação de CLI + autenticaçãoNãoTroca manualPor conta própriaGratuito (open beta)
Pivix mads-mcp (legado)25-45 min + App MetaNão — hospedagem própria + configNãoConfig por contaPor conta própriaGratuito + tempo de desenvolvimento

A comparação reflete o lançamento do open beta da Meta em 29 de abril de 2026. Os tempos de configuração são estimativas reais a partir de um computador novo — incluindo a busca pelo caminho de configuração do Claude Desktop na primeira instalação.

Qual é a melhor opção para você?

Dois perfis claros cobrem ~95% dos leitores. Se você está em um terceiro grupo (cientista, hobbyista, caso especial), a comparação lado a lado acima tem o que você precisa.

✓ Onde o oficial da Meta ganha

  • Gratuito durante o open beta — sem assinatura
  • Oficialmente suportado pela Meta — sem risco de limite de taxa ou banimento
  • Maior superfície bruta da API de Marketing (é da própria Meta)
  • Sem espera pela aprovação de um App de Desenvolvedor

× Onde o oficial da Meta fica aquém

  • ×Você edita um arquivo de configuração JSON ou instala um CLI — sem caminho apenas pelo navegador
  • ×Sem agente autônomo — informa que os conjuntos de anúncios estão fatigados, mas não os pausa
  • ×Sem descoberta automática de múltiplas contas — agências trocam manualmente
  • ×Sem isolamento de token por cliente — uma falha grave para agências em setores regulados

→ Se você é desenvolvedor — escolha o oficial da Meta

  • Você se sente confortável editando JSON e reiniciando o Claude
  • Você quer acesso bruto à API de Marketing para ferramentas ou scripts personalizados
  • Você vai criar sua própria automação (cron jobs, alertas, lógica de pausa)
  • Você gerencia 1-2 contas — multi-tenancy não é o seu problema

★ Se você é profissional de marketing ou agência — escolha a Ryze

  • Você quer fazer consultas no Claude em 2 minutos, não em 10
  • Você quer que conjuntos de anúncios fatigados sejam pausados durante a noite, não apenas sinalizados em um relatório
  • Você gerencia 5+ contas da Meta e precisa de descoberta automática do BM + isolamento de token
  • Você quer portais de clientes white-label para enviar relatórios sem precisar de engenharia

Para a versão voltada a agências, veja Melhor MCP para Meta Ads — Top 5 Escolhas para Agências.

O caminho de 2 minutos: o conector Meta com um clique da Ryze AI

Três etapas. Cada uma tem um resultado concreto para que você saiba quando funcionou. Genuinamente um clique na tela OAuth. Sem instalação do Meta CLI. Sem configuração JSON para editar além de colar uma URL no Claude Desktop.

Conector Meta com um clique da Ryze AI — gerenciamento autônomo de campanhas do Facebook e Instagram dentro do Claude com auditoria de fadiga criativa e pausa de conjuntos de anúncios dentro das regras definidas

Captura de tela — o conector Meta com um clique da Ryze AI executando auditoria de fadiga criativa + pausa pelo agente dentro do Claude.

Etapa 01 · ~30 seg

Cadastre-se + Meta OAuth com um clique

Acesse get-ryze.ai, clique em Começar gratuitamente (sem cartão). Clique em Conectar Meta Ads. A tela padrão do Meta Business OAuth aparece — a mesma que o Shopify usa. Um clique em Continuar. Se você tem várias contas de anúncios no seu Business Manager, a Ryze as descobre automaticamente; escolha as que deseja conectar.

Resultado: você chega ao painel da Ryze com suas contas de anúncios listadas e uma URL MCP exclusiva pronta para copiar.

Etapa 02 · ~1 min

Cole a URL MCP no Claude Desktop

No seu painel da Ryze, clique em Copiar URL MCP. No Claude Desktop → Configurações → Desenvolvedor → Editar Configuração, adicione o bloco abaixo em mcpServers. Salve, feche completamente o Claude (cmd-Q), reabra. As ferramentas da Ryze se registram automaticamente — incluindo as do Google Ads, GA4 e quaisquer outros conectores que você habilitou.

claude_desktop_config.json{ "mcpServers": { "ryze-meta-ads": { "url": "https://mcp.get-ryze.ai/meta-ads/<your-id>" } } }

Resultado: o Claude exibe um indicador verde “ryze-meta-ads”. Agora você pode perguntar ao Claude qualquer coisa sobre seu Meta Ads em linguagem simples.

Etapa 03 · ~30 seg

Experimente a camada de agente que o oficial da Meta não tem

Digite o prompt abaixo no Claude. O agente da Ryze identifica conjuntos de anúncios fatigados em suas contas, elabora recomendações de pausa e — com sua aprovação — as aplica dentro das regras por conta. Esta é a camada de automação ativa; o MCP oficial da Meta apenas descreveria o problema em uma tabela.

Primeiro promptAudite a fadiga criativa em minhas contas do Meta Ads. Pause conjuntos de anúncios com frequência > 4 e CPM crescente, dentro do meu limite de alteração de R$500/dia. Mostre o que você pausaria antes de aplicar qualquer coisa.

Resultado: uma tabela Markdown de conjuntos de anúncios fatigados com pausas propostas, impacto total no gasto e um prompt de aprovação. Clique em aprovar e a Ryze executa as pausas na Meta. (Você também pode ativar o modo agendado para que isso seja executado todas as noites sem você.)

Yael S.

Yael S.

Chefe de Performance

Moda DTC, R$180K/mês em Meta Ads

★★★★★

No dia em que o MCP oficial da Meta foi lançado, testei os dois em menos de uma hora. O oficial funciona — parabéns à Meta. Mas voltei direto para a Ryze por dois motivos: o OAuth com um clique (a configuração deles são seis cliques e uma edição de config) e o agente que pausou 11 conjuntos de anúncios fatigados durante a noite enquanto eu dormia. O MCP da Meta teria apenas me informado sobre eles.”

2 min

Configuração da Ryze

11

Conjuntos pausados na noite

R$2.800

/mês em gasto desperdiçado evitado

Perguntas frequentes

P: O MCP oficial da Meta é gratuito?

Sim, durante o open beta. O MCP e o CLI são instalados gratuitamente; você ainda paga seu gasto normal em Meta Ads. Em 30 de abril de 2026, a Meta não se comprometeu com preços de longo prazo — a tag “gratuito” é específica do open beta e pode mudar.

P: Se o MCP da Meta é gratuito, por que pagar pela Ryze?

Porque o MCP da Meta apenas descreve problemas — não os resolve. A Ryze adiciona a camada de agente autônomo que pausa conjuntos de anúncios fatigados enquanto você dorme, além de descoberta automática de múltiplas contas, isolamento de token por cliente e relatórios white-label que as agências precisam. Se você é um operador solo gerenciando uma conta e não quer automação, o MCP gratuito da Meta é suficiente. Se você quer recuperar horas a cada semana, a Ryze se paga com o primeiro conjunto de anúncios que ela pausa.

P: Os dados dos meus clientes de agência vão vazar entre contas na Ryze?

Não. Cada conta de cliente na Ryze recebe seu próprio token OAuth isolado; a camada de agente só pode ver e agir nas contas que você conectou explicitamente a esse espaço de trabalho. Não há infraestrutura compartilhada que toque dados de anúncios de mais de um cliente ao mesmo tempo. O MCP oficial da Meta não inclui isolamento por cliente — você teria que construir isso por conta própria se seguisse essa rota para uma agência.

P: Toda a minha equipe pode usar a Ryze em uma conta?

Sim. Os espaços de trabalho da Ryze suportam vagas ilimitadas para equipes por padrão — cada pessoa tem seu próprio login, permissões baseadas em função e trilha de auditoria. A camada de agente respeita os limites de gasto por usuário, para que um comprador de mídia júnior não mova acidentalmente um orçamento de R$50 mil. Portais de clientes white-label também estão incluídos se você quiser que clientes vejam painéis somente leitura sem a marca Ryze.

P: Nunca usei Claude ou IA — isso é difícil demais de aprender?

Não. Você digita perguntas em linguagem simples (“mostre os principais conjuntos de anúncios de ontem”) e o Claude responde com tabelas, gráficos ou ações propostas. Não há sintaxe para memorizar, sem fórmulas, sem scripts. Se você consegue escrever uma mensagem no Slack para um colega, você consegue usar isso. A Ryze vem com uma biblioteca de prompts iniciais para que você seja produtivo desde o primeiro dia.

P: Posso usar o MCP oficial da Meta e a Ryze ao mesmo tempo?

Tecnicamente sim, mas não é recomendado. A precisão de seleção de ferramentas do Claude diminui quando MCPs sobrepostos expõem nomes de ferramentas similares — ele não saberá se deve chamar o list_campaigns nativo da Meta ou o da Ryze. Escolha um principal. A maioria das equipes escolhe a Ryze pela configuração com um clique + camada de agente, e só adiciona o MCP da Meta se precisar de acesso bruto à API de Marketing para um caso específico.

Pule o CLI

Conecte o Meta ao Claude com um clique via Ryze AI

  • Pule a instalação — OAuth com um clique
  • O agente pausa conjuntos de anúncios fatigados enquanto você dorme
  • Descoberta automática do Business Manager para agências

2.000+

Profissionais

$500M+

Investimento em anúncios

23

Países

Live results across
2,000+ clients

Paid Ads

Avg. client
ROAS
0x
Revenue
driven
$0M

SEO

Organic
visits driven
0M
Keywords
on page 1
48k+

Websites

Conversion
rate lift
+0%
Time
on site
+0%
Last updated: May 3, 2026
All systems ok

Let AI
Run Your Ads

Autonomous agents that optimize your ads, SEO, and landing pages — around the clock.

Claude AIConnect Claude with
Google & Meta Ads in 1 click
>