Meta Ads MCP Server (Facebook & Instagram, 1-click connect)

Meta Ads MCP Server: rode seus anúncios do Facebook e Instagram pelo Claude ou ChatGPT

Cole um link no Claude ou ChatGPT, faça login com o Facebook, e sua IA pode ler e gerenciar seus anúncios do Facebook e Instagram. Sem conta de desenvolvedor, nada para instalar, cerca de um minuto de configuração. Tudo abaixo do link é a referência completa para você e seu agente de IA.

Seu link MCP

https://connector.get-ryze.ai/mcp

Guia de configuração completo ↓

Configure em 3 passoscerca de 1 minuto

1. 01Copie seu link MCP:https://connector.get-ryze.ai/mcp
2. 02No Claude, vá em Configurações → Conectores → Adicionar conector personalizado. Nomeie como Ryze AI, cole o link e clique em Adicionar. No ChatGPT, é Configurações → Apps → Criar app.
3. 03Clique em Conectar, faça login com o Facebook e escolha seu espaço de trabalho. Abra um novo chat e pergunte: "Qual dos meus anúncios desperdiçou mais dinheiro este mês?"

Funciona no Claude, ChatGPT, Cursor e Claude Code · Incluído em todos os planos · Guia de configuração completo

Uma URL entre seu cliente de IA e o Meta Ads

01 — Visão geral

O que este servidor Meta Ads MCP faz

A versão resumida

1. Uma URL, https://connector.get-ryze.ai/mcp, funciona no Claude, ChatGPT, Claude Code, Cursor e qualquer cliente MCP.
2. Login com o Facebook. Sem app de desenvolvedor Meta, sem token de acesso, sem revisão de app, sem servidor para rodar.
3. 12 ferramentas Meta Ads: 9 de leitura (Insights, leituras Graph, criativos, leads, Biblioteca de Anúncios) e 3 de escrita, cada uma com aprovação.
4. O mesmo endpoint carrega Google Ads, TikTok, GA4, Search Console e Shopify — mais de 150 ferramentas no total.
5. Incluído em todos os planos Ryze AI. Paid Ads custa US$ 89/mês fixos com teste grátis de 7 dias.

meta_ads · especificação do servidorOAuth2

Nome do servidor

Ryze AI (Meta Ads MCP)

Endpoint

https://connector.get-ryze.ai/mcp

Transporte

MCP remoto via HTTP Streamable

Autenticação

OAuth 2.0 (login com Facebook, um espaço de trabalho Ryze por conexão)

Hospedagem

Hospedado pela Ryze AI — nada para instalar ou rodar

Ferramentas Meta Ads

12 (9 de leitura · 3 de escrita, com aprovação)

Também neste endpoint

Google Ads, TikTok, GA4, Search Console, Shopify — mais de 150 ferramentas

App de desenvolvedor / token

Não necessário

Preço

Incluído em todos os planos · Paid Ads US$ 89/mês fixos

Atualizado

3 de setembro de 2026

MCP (Model Context Protocol) é o padrão aberto que assistentes de IA usam para chamar ferramentas externas. Um servidor Meta Ads MCP transforma suas contas de anúncios do Facebook e Instagram em um conjunto dessas ferramentas, para que um assistente possa diagnosticar um pico de CPM, classificar criativos em fadiga, exportar leads ou mover um orçamento a partir de um chat em vez do Gerenciador de Anúncios. A maioria dos servidores Meta Ads MCP no GitHub são processos Python locais que você configura com seu próprio app Meta e token de acesso; este é hospedado, então toda a configuração é uma URL e um login com Facebook. A comparação mais abaixo cobre quando o self-hosting é a melhor opção.

/01

OAuth gerenciado do Facebook

Login no navegador com Facebook, tokens trocados e renovados no servidor. Sem app de desenvolvedor Meta, sem token da Marketing API, sem revisão de app.

/02

API Insights bruta

runRawInsights relata no nível de conta, campanha, conjunto de anúncios ou anúncio com detalhamentos por idade, gênero, país, região, dispositivo, plataforma e posicionamento, além de janelas de atribuição.

/03

Leituras completas da Graph API

runGraphRead busca qualquer nó ou aresta — campanhas, conjuntos de anúncios, anúncios, criativos, públicos, pesquisa de segmentação — e segue cursores de paginação.

/04

Escritas com aprovação

Crie e atualize campanhas, conjuntos de anúncios, anúncios, criativos e orçamentos com aprovação por ferramenta. Exclusões e arquivamentos usam uma ferramenta separada e explícita.

/05

Formulários de leads e leads

Liste os formulários de leads em uma Página do Facebook e exporte os leads que um formulário coletou, direto no chat.

/06

Pesquisa na Biblioteca de Anúncios

Pesquise a Biblioteca de Anúncios pública da Meta por palavra-chave ou ID da Página, filtrada por país e status ativo, com um link de snapshot por anúncio.

/07

Ferramentas de criativos

Inspecione o texto, a mídia e os links de qualquer criativo e envie imagens por URL para obter o image_hash que um novo anúncio precisa.

/08

Seis plataformas, uma URL

O mesmo endpoint carrega os conjuntos de ferramentas do Google Ads, TikTok, GA4, Search Console e Shopify — um login em vez de seis servidores.

Seis plataformas, um endpoint

02 — Referência de ferramentas

As 12 ferramentas Meta Ads

Ferramentas de conta usam adAccountId no formato act_1234567890. Leituras com escopo de página e ferramentas de leads usam pageId, e o servidor troca o token de acesso da Página que a Meta exige. Ferramentas de escrita são aprovadas individualmente.

Ferramenta	Acesso	O que faz	Parâmetros principais
getAccountSummary	leitura	Gasto, impressões, CPM, CTR, conversões e ROAS para um intervalo de datas na janela de atribuição padrão da Meta.	adAccountId · period { startDate, endDate }
listAdAccounts	leitura	Toda conta de anúncios Meta que o usuário conectado pode acessar, com id (act_…), nome e moeda. Chame esta primeiro.	nenhum
getCreative	leitura	Um criativo por id: texto, mídia, links, object_story_spec e status.	creativeId
listCreatives	leitura	Criativos em uma conta, paginados para evitar flags de limite de taxa em contas grandes.	adAccountId · limit (padrão 100, máximo 1.000)
listLeadForms	leitura	Formulários de geração de leads em uma Página do Facebook, com status e perguntas.	pageId
listLeads	leitura	Leads coletados por um formulário. O servidor troca um token de acesso da Página a partir de pageId.	formId · pageId
runRawInsights	leitura	Qualquer consulta da API Insights: nível, intervalo de datas, campos, detalhamentos, filtros, janelas de atribuição e incrementos de tempo.	adAccountId · request { level, timeRange, fields, breakdowns, filtering, actionAttributionWindows, timeIncrement, limit }
runGraphRead	leitura	GET de qualquer nó ou aresta da Graph API, incluindo pesquisa de segmentação e leituras com escopo de página. Segue paging.next até que esteja ausente.	path · fields · adAccountId · pageId
runGraphWrite	escrita	POST para criar ou atualizar campanhas, conjuntos de anúncios, anúncios, criativos, orçamentos, públicos e vídeos. O status ACTIVE/PAUSED fica aqui.	path · params · adAccountId · pageId
runGraphDelete	escrita	Excluir ou arquivar. Campanhas, conjuntos de anúncios e anúncios usam POST com status DELETED ou ARCHIVED; arestas usam HTTP DELETE. Somente lista explícita aprovada.	path · method (POST | DELETE) · params · adAccountId
searchAdLibrary	leitura	Pesquisa na Biblioteca de Anúncios pública por palavra-chave ou IDs de Página: corpos de criativos, títulos, datas de veiculação, plataformas, URL de snapshot.	searchTerms | pageIds · countries · adActiveStatus · fields · limit (≤ 100) · after
uploadImageFromUrl	escrita	Busca uma URL de imagem, envia para act_<id>/adimages e retorna o image_hash para um criativo de anúncio.	adAccountId · imageUrl

O mesmo endpoint expõe os conjuntos de ferramentas do Google Ads, TikTok, GA4, Search Console e Shopify. A lista entre plataformas está na referência de API de publicidade e ferramentas MCP; o lado do Google tem sua própria página em Google Ads MCP server.

03 — Pré-requisitos

O que você precisa antes de começar

Você precisa

• Um login do Facebook com acesso de administrador ou anunciante à conta de anúncios, geralmente pelo Business Manager. (Como conceder acesso.)
• Uma conta Ryze AI com um plano ou teste grátis — a conta é criada durante a etapa OAuth se você não tiver uma.
• Um cliente MCP: Claude Pro, Team ou Max (conectores personalizados não estão no plano grátis), ChatGPT Plus, Pro ou Business com modo Desenvolvedor, ou Claude Code, Cursor, Windsurf, VS Code em qualquer plano.

Você não precisa

• Um app de desenvolvedor Meta, revisão de app ou token de acesso da Marketing API. (O que a rota da API envolve.)
• Um usuário de sistema, um token de longa duração para rotacionar ou a permissão ads_management no seu próprio app.
• Python, Node, um ambiente virtual, um arquivo .env ou um processo para manter rodando.

04 — Configuração

Configuração do Meta Ads MCP: instale em cada cliente MCP

Todas as rotas terminam na mesma tela OAuth: faça login com o Facebook, escolha seu espaço de trabalho Ryze e clique em Permitir. Uma conexão mapeia para um espaço de trabalho, então agências com vários espaços de trabalho de clientes reconectam por espaço de trabalho. Capturas de tela para a rota do Claude estão em como conectar o Claude ao Google e Meta Ads.

Claude (web e desktop)

1. 01Em claude.ai, clique no seu avatar (canto inferior esquerdo) → Configurações.
2. 02Abra a aba Conectores e clique em Personalizar, depois no + ao lado de Conectores.
3. 03Nome: Ryze AI. URL do servidor MCP remoto: https://connector.get-ryze.ai/mcp. Clique em Adicionar.
4. 04Clique em Conectar no novo conector, faça login com o Facebook, escolha seu espaço de trabalho e clique em Permitir que o Claude conecte.
5. 05Uma confirmação verde lista as ferramentas disponíveis. Inicie um novo chat e faça sua primeira pergunta.

Requer Claude Pro, Team ou Max. O app desktop do Claude usa o mesmo fluxo Configurações → Conectores; se você preferir o arquivo de configuração, use a entrada mcp-remote em "Arquivo de configuração do Claude Desktop" abaixo.

ChatGPT

1. 01 Configurações → Apps. Em Configurações avançadas, ative o modo Desenvolvedor.
2. 02Clique em Criar app. Nome: Ryze AI. URL do servidor MCP: https://connector.get-ryze.ai/mcp — escolha URL do servidor, não Tunnel.
3. 03Autenticação: OAuth. Marque o reconhecimento e clique em Criar.
4. 04Na página de autorização, escolha Entrar com Ryze AI, selecione seu espaço de trabalho e clique em Permitir.
5. 05Inicie um novo chat: "Puxe os últimos 7 dias de gasto e ROAS da Meta por campanha."

Requer um plano do ChatGPT que suporte apps e conectores (Plus, Pro ou Business).

Claude Code

claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp

Depois execute /mcp dentro do Claude Code para concluir o login OAuth. Adicione --scope user para disponibilizá-lo em todos os projetos.

Cursor, Windsurf e qualquer cliente mcp.json

mcp.json (Cursor:.cursor/mcp.json · Windsurf: mcp_config.json)json

{
  "mcpServers": {
    "ryze": {
      "url": "https://connector.get-ryze.ai/mcp"
    }
  }
}

Salve e aprove o prompt OAuth que o cliente abrir. O Windsurf usa a chave serverUrl em vez de url.

VS Code (modo agente do GitHub Copilot)

{
  "servers": {
    "ryze": {
      "type": "http",
      "url": "https://connector.get-ryze.ai/mcp"
    }
  }
}

Arquivo de configuração do Claude Desktop (opcional)

{
  "mcpServers": {
    "ryze": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://connector.get-ryze.ai/mcp"]
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json. Reinicie o Claude Desktop; a primeira chamada abre o navegador para OAuth. A maioria das pessoas não vai precisar disso — Configurações → Conectores faz o mesmo sem Node.

05 — Uso

O que perguntar depois de conectar

Relatórios

• >“Puxe os últimos 7 dias de gasto, CPM, CTR e ROAS da Meta por campanha.”
• >“Monte meu relatório de segunda-feira da Meta: gasto, ROAS, top 5 anúncios e o que corrigir.”
• >“Detalhe o gasto do mês passado por posicionamento — onde está o Instagram Reels vs Feed?”

CPM e fadiga de criativos

• >“Por que meu CPM subiu esta semana? Verifique frequência e queda de CTR por conjunto de anúncios.”
• >“Quais criativos estão em fadiga? Classifique anúncios por frequência e tendência de CTR nas últimas 4 semanas.”
• >“Compare Advantage+ shopping vs minhas campanhas manuais em ROAS, últimos 30 dias.”

Leads e concorrentes

• >“Exporte os leads do meu formulário 'Auditoria grátis' desta semana e sinalize duplicados.”
• >“Mostre os anúncios ativos que a Marca X está rodando nos EUA agora, com seus ganchos.”
• >“Liste todos os criativos na conta que estão ativos há mais de 60 dias.”

Mudanças (com aprovação)

• >“Mova 20% do orçamento dos dois piores conjuntos de anúncios para o melhor — mostre o plano primeiro.”
• >“Pause todo anúncio com frequência acima de 4 e CTR abaixo de 0,8% este mês.”
• >“Duplique o anúncio vencedor no conjunto de anúncios de retargeting com a nova imagem.”

Fluxos de trabalho prontos: otimização de orçamento da Meta via MCP, otimização de posicionamento, pesquisa na Biblioteca de Anúncios pelo Claude, depuração de Pixel e o guia do comprador de mídia para o Claude.

06 — Exemplos de solicitações

Chamadas de Insights e Graph que você pode descrever no chat

Você raramente precisa escrever estas — o assistente as constrói. Quando quiser controle exato, descreva a solicitação e o servidor a executa via runRawInsights ou runGraphRead. Três que aparecem diariamente:

Insights: desempenho de campanha, últimos 30 dias

{
  "level": "campaign",
  "timeRange": { "startDate": "2026-08-04", "endDate": "2026-09-02" },
  "fields": ["campaign_name", "spend", "impressions", "cpm", "ctr",
             "frequency", "actions", "purchase_roas"],
  "filtering": [{ "field": "spend", "operator": "GREATER_THAN", "value": 50 }],
  "limit": 50
}

Gasto e valores de ação de Insights chegam em unidades de moeda inteiras. purchase_roas é o campo de ROAS; não existe um campo chamado roas.

Insights: detalhamento por posicionamento com a janela de atribuição de um cliente

{
  "level": "adset",
  "timeRange": { "startDate": "2026-08-27", "endDate": "2026-09-02" },
  "fields": ["adset_name", "spend", "cpm", "ctr", "actions"],
  "breakdowns": ["publisher_platform", "platform_position"],
  "actionAttributionWindows": ["7d_click", "1d_view"]
}

Cada janela solicitada chega como uma chave extra em cada ação (ex.: '7d_click'); o valor simples permanece na janela padrão.

Leitura do Graph e, em seguida, uma alteração de orçamento com aprovação

// runGraphRead
{ "path": "act_1234567890/adsets",
  "fields": "name,status,daily_budget,optimization_goal" }

// runGraphWrite  (approval-gated)
{ "path": "23851234567890123",
  "params": { "daily_budget": 5000 } }

Os campos de dinheiro do Graph estão em unidades menores: daily_budget 5000 = R$ 50,00 (JPY e KRW são unidades inteiras). Atualizações precisam de aprovação antes de serem executadas.

07 — Comparação

Hospedado vs. oficial vs. auto-hospedado

O que você opera	Servidor hospedado Ryze AI	MCP oficial da Meta	Open source (ex.: GoMarble)
Runtime	Nenhum — HTTP remoto	Processo local que você executa	Python local que você executa
Credenciais que você gerencia	Apenas login do Facebook	App Meta + token de acesso da Marketing API	App Meta + token de acesso no .env
Permissões e revisão do app	Gerenciadas pela Ryze	Escopos ads_read / ads_management do seu app	Escopos do seu app
Limites de taxa	Gerenciados pelo app da Ryze	Limites de Ads Management do seu app	Limites de Ads Management do seu app
Quando a versão da API muda	A Ryze atualiza o servidor	Você atualiza o servidor	Você espera por uma atualização do repositório
Plataformas	Meta + Google Ads, TikTok, GA4, Search Console, Shopify	Apenas Meta	Apenas Meta
Controles de aprovação de escrita	Por ferramenta, ativados por padrão	O que seu token permitir	Varia por projeto

Auto-hospedar é a escolha certa quando os dados nunca podem sair da sua máquina ou quando você está construindo seu próprio agente sobre a API bruta. Para esse caminho: Explicação do MCP oficial da Meta, o servidor MCP do Meta Business SDK, o que o lançamento do MCP e da CLI oficiais mudou e os melhores servidores MCP para Meta Ads ranqueados.

08 — Segurança e permissões

Seguro por padrão

Leituras são automáticas, escritas aguardam você

Somente OAuth 2.0

Você faz login na página do Facebook. Sua senha nunca toca a Ryze, e os tokens são trocados e renovados no lado do servidor.

Um workspace por conexão

Cada conexão é autorizada contra um único workspace da Ryze, escolhido na tela de consentimento. Trocar de workspace significa reconectar e iniciar um novo chat.

Escritas com aprovação

As ferramentas de leitura são automáticas. No Claude, abra Configurações → Conectores → Ryze AI e mantenha runGraphWrite, runGraphDelete e uploadImageFromUrl em 'Needs approval' — o padrão recomendado para contas ativas.

Exclusões são separadas e explícitas

Os arquivamentos da Meta são em cascata — arquive o último anúncio e o conjunto de anúncios segue — e não podem ser desfeitos, então runGraphDelete só executa em uma lista aprovada item por item. Pausar via runGraphWrite é o caminho reversível.

Revogue a qualquer momento

Remova o acesso em Configurações do Facebook → Integrações de negócios, ou em Configurações do Workspace → Integrações na Ryze.

09 — Cotas e limites

O que saber antes de uma sessão pesada

App e token de desenvolvedor	Não é seu para gerenciar — o servidor hospedado roda no app e nas permissões da Meta da Ryze AI.
Limites de taxa	Os limites de Ads Management da Meta se aplicam por conta de anúncios e aparecem como erro 80004. listCreatives pagina em 100 por padrão (máx. 1.000); puxe contas grandes em páginas.
Solicitações de Insights	Campos e detalhamentos devem ser nomes válidos de Insights. Faixas de datas muito amplas podem expirar (erro 100, subcódigo 1504018) — reduza o intervalo ou adicione timeIncrement.
Campos de dinheiro	Gastos de Insights e valores de ação são unidades inteiras de moeda. Campos do Graph — daily_budget, lifetime_budget, bid_amount, amount_spent, spend_cap — são unidades menores: 5000 = R$ 50,00 (JPY e KRW são unidades inteiras).
Atribuição	Padrão é a configuração de atribuição de cada conjunto de anúncios, como no Ads Manager. Passe actionAttributionWindows (1d_click, 7d_click, 28d_click, 1d_view) para espelhar a janela de um cliente e ler essa chave.
Paginação	Uma leitura do Graph com paging.next está incompleta. Passe a URL completa de paging.next como o próximo caminho até que ela não exista mais.
Leads	listLeadForms e listLeads precisam do ID da Página; o servidor troca por um token de acesso da Página. Requer os escopos leads_retrieval e pages_read_engagement na conexão.
Biblioteca de Anúncios	Arquivo público, até 100 anúncios por página e 10 países por consulta. Sem métricas de gasto ou desempenho, exceto para anúncios políticos e da UE.
Mídia	Imagens são enviadas de uma URL via uploadImageFromUrl e retornam um image_hash. Vídeos são postados em act_<id>/advideos com um file_url e processados de forma assíncrona — verifique o status antes de criar o criativo.
Planos de cliente	Conectores personalizados do Claude: Pro, Team ou Max. Conectores do ChatGPT: Plus, Pro ou Business com modo Desenvolvedor.

10 — Solução de problemas

Erros comuns e a correção

Sintoma	Causa	Correção
As ferramentas não aparecem no chat	O chat foi aberto antes de o conector existir.	Inicie um novo chat — Claude e ChatGPT vinculam conectores quando uma conversa começa.
Sem opção de 'conector personalizado' no Claude	Plano gratuito do Claude.	Conectores personalizados precisam de Claude Pro, Team ou Max. ChatGPT precisa de Plus, Pro ou Business com modo Desenvolvedor ativado.
"adAccountId é obrigatório" ou a conta errada	Nenhuma conta escolhida ainda.	Peça suas contas de anúncios primeiro (listAdAccounts) e nomeie uma. IDs parecem act_1234567890.
Erro 80004: muitas chamadas para esta conta de anúncios	Limite de taxa de Ads Management da Meta para essa conta.	Aguarde e depois pagine com limites menores — puxar milhares de criativos em uma chamada dispara o alerta.
Erro 190 em uma chamada de leads	A recuperação de leads precisa de um token de acesso da Página, ou o escopo leads_retrieval está ausente.	Passe pageId (a Página que possui o formulário). Se persistir, reconecte o Meta e conceda as permissões de leads.
Erro 100: parâmetro inválido em Insights	O campo ou detalhamento não é um campo de Insights.	status, placement e creative são atributos de objeto (use runGraphRead); roas é purchase_roas.
Números não batem com o Ads Manager	Janela de atribuição diferente, ou conversões no nível do anúncio vs. no nível da conta.	Passe actionAttributionWindows para espelhar a janela do cliente e leia essa chave. Linhas de conta incluem conversões modeladas que linhas de anúncio não incluem.
Orçamentos parecem 100× errados	Campos de dinheiro do Graph são unidades menores.	daily_budget 5000 = R$ 50,00; amount_spent '25468' = R$ 254,68. Gastos de Insights já são unidades inteiras.
"Ad Sets may not be added to archived Campaigns"	Cascata de arquivamento: arquivar o último filho arquivou o pai.	Leia effective_status antes de excluir o último filho ativo. Pause com runGraphWrite em vez de arquivar; atualize criativos no lugar.
Dados da conta errada do cliente	A conexão está autorizada para outro workspace.	Cada conexão é um workspace da Ryze. Reconecte, escolha o workspace certo e inicie um novo chat.

Ainda travado? Envie um e-mail para support@get-ryze.ai. Mais correções do lado da Meta: solução de problemas da conexão Meta Ads MCP. Agências lidando com muitas contas: configuração MCP para múltiplas contas de anúncios.

11 — FAQ

Perguntas sobre o servidor Meta Ads MCP

O que é o servidor Meta Ads MCP?

É um servidor MCP (Model Context Protocol) que expõe uma conta de anúncios da Meta — campanhas do Facebook e Instagram — como ferramentas que um assistente de IA pode chamar. O servidor Meta Ads MCP da Ryze AI é hospedado e remoto: você adiciona uma URL ao Claude, ChatGPT, Cursor ou Claude Code, faz login com o Facebook via OAuth, e o assistente pode executar relatórios de Insights, ler qualquer objeto da Graph API, pesquisar a Biblioteca de Anúncios e fazer alterações com aprovação.

Qual é a URL do servidor Meta Ads MCP?

A URL do servidor é https://connector.get-ryze.ai/mcp. É um servidor MCP remoto sobre Streamable HTTP com OAuth 2.0. O mesmo endpoint atende aos conjuntos de ferramentas de Meta Ads, Google Ads, TikTok, GA4, Search Console e Shopify, então um conector cobre toda a pilha de anúncios. Cada conexão é autorizada contra um workspace da Ryze.

Preciso de um app de desenvolvedor Meta ou de um token de acesso da Marketing API?

Não. O servidor hospedado roda no app e nas permissões da Meta da própria Ryze AI. Você faz login com uma conta do Facebook que tem acesso de administrador ou anunciante à conta de anúncios e pronto. Servidores auto-hospedados, como o MCP oficial da Meta ou o servidor open-source GoMarble, exigem seu próprio app Meta, um token de acesso de longa duração e um runtime Python local.

Quais clientes MCP funcionam com o servidor Meta Ads MCP?

Qualquer cliente que suporte MCP remoto sobre HTTP com OAuth: Claude web e desktop (plano Pro, Team ou Max), ChatGPT (Plus, Pro ou Business com modo Desenvolvedor), Claude Code, Cursor, Windsurf, VS Code e Gemini CLI, além de frameworks de agentes como Claude Agent SDK, OpenAI Agents SDK, LangChain, CrewAI e n8n.

Como adiciono o conector Claude para Meta Ads?

Em claude.ai ou Claude Desktop, abra Configurações, Conectores, Adicionar conector personalizado, cole https://connector.get-ryze.ai/mcp e faça login com a conta do Facebook que gerencia suas contas de anúncios. No Claude Code, execute: claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp. Nenhum app de desenvolvedor Meta ou token de acesso é necessário.

Existe um Meta Ads MCP gratuito?

O servidor MCP de anúncios da própria Meta conecta com um login de negócios da Meta e cobre apenas a Meta. O Meta Ads MCP da Ryze adiciona Google Ads, GA4 e a Biblioteca de Anúncios da Meta no mesmo conector, com alterações com aprovação; está incluído em todos os planos da Ryze, e Paid Ads custa US$ 89/mês com teste gratuito de 7 dias.

Posso usar o Meta Ads MCP no Claude Code ou no Cursor?

Sim. Claude Code: claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp, depois /mcp para fazer login. Cursor: Configurações, MCP, adicione um servidor com essa URL. O mesmo conector atende Google Ads e Google Analytics.

Quantas ferramentas de Meta Ads o servidor expõe?

12 ferramentas de Meta Ads: 9 ferramentas de leitura (resumo da conta, contas de anúncios, detalhe de criativo, lista de criativos, formulários de leads, leads, Insights brutos, leituras brutas do Graph e pesquisa na Biblioteca de Anúncios) e 3 ferramentas de escrita (escritas no Graph, exclusões no Graph e upload de imagem), cada uma com aprovação. O endpoint completo carrega mais de 150 ferramentas em seis plataformas.

O servidor MCP pode alterar minhas campanhas do Facebook, ou apenas lê-las?

Ambos. As ferramentas de leitura funcionam assim que o OAuth é concluído. runGraphWrite cria e atualiza campanhas, conjuntos de anúncios, anúncios, criativos e orçamentos, e exige aprovação: no Claude, você define como 'Needs approval' em Configurações → Conectores → Ryze AI. Exclusões e arquivamentos ficam em uma ferramenta separada, runGraphDelete, porque os arquivamentos da Meta são em cascata e não podem ser desfeitos; ela só executa em uma lista explícita item por item.

Como executo uma consulta de Insights pelo servidor MCP?

Pergunte em linguagem natural ou descreva a solicitação exata. runRawInsights aceita um nível (account, campaign, adset ou ad), um intervalo de datas, quaisquer campos válidos de Insights, detalhamentos como age, gender, country, publisher_platform ou platform_position, filtros e janelas de atribuição. O gasto retorna em unidades inteiras de moeda, enquanto os campos de orçamento do Graph estão em unidades menores.

Por que os números não batem com meu Ads Manager?

Quase sempre é a janela de atribuição. Por padrão, o servidor segue a configuração de atribuição de cada conjunto de anúncios, como o Ads Manager faz, mas um cliente pode visualizar uma janela diferente. Passe actionAttributionWindows como ['7d_click','1d_view'] e leia o valor sob essa chave de janela. Conversões no nível da conta também incluem conversões modeladas que linhas no nível do anúncio não incluem, então somas no nível do anúncio ficam alguns pontos percentuais menores.

Posso exportar leads de formulários de leads com o servidor MCP?

Sim. listLeadForms retorna os formulários em uma Página do Facebook, e listLeads exporta os leads coletados por um formulário. Ambos precisam do ID da Página, porque a Meta exige um token de acesso da Página para recuperação de leads; o servidor troca isso automaticamente. Se você vir o erro 190 do Graph em uma chamada de leads, a conexão não tem o escopo leads_retrieval — reconecte o Meta e conceda-o.

O servidor Meta Ads MCP inclui pesquisa de concorrentes na Biblioteca de Anúncios?

Sim. searchAdLibrary consulta a Biblioteca de Anúncios pública da Meta por palavra-chave ou ID exato da Página, filtrada por país e status ativo, e retorna corpos de criativos, títulos de links, datas de entrega, plataformas e uma URL de snapshot por anúncio. Ela usa uma credencial no nível da plataforma, então não é limitada às suas próprias contas. Gastos e desempenho não são expostos, exceto para anúncios políticos e da UE.

Quanto custa o servidor MCP do Meta Ads?

O conector está incluído em todos os planos da Ryze AI. O Paid Ads custa US$ 89/mês, preço fixo, com teste gratuito de 7 dias. No lado do cliente, você precisa de um plano Claude que permita conectores personalizados (Pro, Team ou Max) ou de um plano ChatGPT com conectores (Plus, Pro ou Business).

O servidor MCP do Meta Ads é seguro?

O acesso é somente via OAuth 2.0, então sua senha do Facebook nunca passa pela Ryze. Cada conexão é limitada a um workspace da Ryze, as ferramentas de escrita e exclusão são aprovadas por padrão, e você pode revogar o acesso a qualquer momento em Configurações do Facebook → Integrações de negócios ou em Configurações do Workspace → Integrações na Ryze. A política de privacidade do MCP, os termos do MCP e a política de segurança estão linkados nesta página.

Por que o Claude não vê as ferramentas do Meta Ads depois que eu conectei?

Inicie um novo chat. O Claude e o ChatGPT vinculam conectores quando uma conversa começa, então um chat existente mantém seu conjunto original de ferramentas. Se a opção de conector estiver totalmente ausente, você está em um plano Claude gratuito — conectores personalizados exigem Pro, Team ou Max. Por fim, confirme se o conector aparece como Conectado em Configurações → Conectores.

Qual é a diferença em relação ao servidor MCP oficial da Meta?

O MCP oficial da Meta é feito para desenvolvedores: você cria um aplicativo Meta, gerencia tokens de acesso e permissões da Marketing API, executa o servidor você mesmo e tem apenas a Meta. O servidor da Ryze AI é hospedado, não exige nada além de um login no Facebook, adiciona Google Ads, TikTok, GA4, Search Console e Shopify no mesmo endpoint, e inclui controles de aprovação para cada escrita.

Como o MCP da Ryze para Meta Ads se compara a outras ferramentas?

O ranking melhor MCP para Meta Ads cobre outros servidores MCP. Para opções mais amplas, compare ferramentas de automação de Meta Ads, ferramentas de IA para gerenciamento de Meta Ads e ferramentas de Meta Ads com preço acessível, além de plataformas de publicidade Meta e ferramentas de segmentação de público com IA.

Onde está a documentação de configuração do servidor MCP da Ryze?

A central de ajuda da Ryze tem guias passo a passo para conectar o Claude ao Google Ads e Meta Ads e conectar o ChatGPT, além da referência do servidor MCP da Ryze, do modelo de permissões e aprovações e do FAQ do conector.

12 — Compatibilidade

Funciona em todos os clientes MCP

Claude (web e desktop)01

Claude Code02

Claude Agent SDK03

ChatGPT04

OpenAI Agents SDK05

Cursor06

Windsurf07

VS Code08

Gemini CLI09

LangChain10

CrewAI11

n8n12

13 — Relacionados

Continue lendo

• Servidor MCP do Google Ads
• Servidor MCP do TikTok Ads
• Servidor MCP do LinkedIn Ads
• Servidor MCP do Google Analytics
• Servidor MCP do Google Search Console
• MCP oficial da Meta e CLI: o que mudou
• Conecte o Claude ao Google e Meta Ads (capturas de tela)
• Melhor MCP para Meta Ads — servidores ranqueados
• Melhor conector Claude para Meta Ads
• Meta Conversions API com Claude MCP
• Ferramentas MCP para relatórios de campanhas de anúncios
• Conectar IA à sua conta de anúncios pode causar banimento?

Um login OAuth · 12 ferramentas de Meta Ads · Ativo em ~60 segundos

Adicione Meta Ads à sua IA hoje.

Incluído no Paid Ads — US$ 89/mês, preço fixo, teste gratuito de 7 dias. A Ryze AI executa as otimizações para você, 24/7.

2.000+ clientes · 700+ agências · US$ 500M+ gerenciados · Sem app de desenvolvedor · Sem servidor para executar