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

Meta Ads MCP Server: execute seus anúncios do Facebook e Instagram a partir do Claude ou ChatGPT

Cole um link no Claude ou ChatGPT, faça login com o Facebook, e sua IA poderá 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 etapas — cerca 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, vá em 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 · Conexão gratuita · Guia de configuração completo

Uma URL entre seu cliente de IA e o Meta Ads

01 — Visão geral

O que este servidor MCP do Meta Ads faz

A versão resumida

1. Uma URL, https://connector.get-ryze.ai/mcp, funciona no Claude, ChatGPT, Claude Code, Cursor e em qualquer cliente MCP.
2. Faça login com o Facebook. Sem app de desenvolvedor Meta, sem token de acesso, sem revisão de app, sem servidor para executar.
3. 12 ferramentas do Meta Ads: 9 de leitura (Insights, leituras do 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. Conexão gratuita. Paid Ads Autopilot custa US$ 89/mês fixos se você quiser que a Ryze AI execute as otimizações por você.

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 executar

Ferramentas do 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

Conexão gratuita · Paid Ads Autopilot 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 MCP do Meta Ads 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 realocar um orçamento a partir de um chat, em vez do Gerenciador de Anúncios. A maioria dos servidores MCP do Meta Ads 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 aborda quando o self-hosting é a melhor opção.

/01

OAuth gerenciado do Facebook

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

/02

API Insights bruta

runRawInsights gera relatórios 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 por meio de 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 de uma Página do Facebook e exporte os leads coletados por um formulário, direto para o 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 captura de tela 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 do Meta Ads

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

Ferramenta	Acesso	O que faz	Parâmetros principais
getAccountSummary	leitura	Gastos, impressões, CPM, CTR, conversões e ROAS para um intervalo de datas na janela de atribuição padrão da Meta.	adAccountId · período { startDate, endDate }
listAdAccounts	leitura	Todas as contas 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 alertas 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 em qualquer nó ou aresta da Graph API, incluindo pesquisa de segmentação e leituras no escopo da 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. Apenas 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 captura de tela.	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 ferramentas da API de publicidade e 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 gratuita Ryze AI — criada durante a etapa OAuth se você ainda não tiver uma.
• Um cliente MCP: Claude Pro, Team ou Max (conectores personalizados não estão no plano gratuito), ChatGPT Plus, Pro ou Business com modo Desenvolvedor, ou Claude Code, Cursor, Windsurf, VS Code em qualquer plano.

Você não precisa

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

04 — Configuração

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. Capturas de tela da rota do Claude estão em como conectar o Claude ao Google e Meta Ads.

Claude (web e desktop)

1. 01No claude.ai, clique no seu avatar (canto inferior esquerdo) → Configurações.
2. 02Abra a aba Conectores e clique em Personalizar e 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 se 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 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 gastos e ROAS do 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

Em seguida, 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 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 gastos, CPM, CTR e ROAS do Meta por campanha.”
• >“Monte meu relatório de segunda-feira do Meta: gastos, ROAS, top 5 anúncios e o que corrigir.”
• >“Detalhe os gastos 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 os anúncios por frequência e tendência de CTR nas últimas 4 semanas.”
• >“Compare o Advantage+ shopping com minhas campanhas manuais em ROAS, últimos 30 dias.”

Leads e concorrentes

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

Alterações (com aprovação)

• >“Mova 20% do orçamento dos dois piores conjuntos de anúncios para o melhor — mostre o plano primeiro.”
• >“Pause todos os anúncios 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 do Meta via MCP, otimização de posicionamento, pesquisa na Biblioteca de Anúncios a partir do 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

Raramente você precisará escrevê-las — o assistente as constrói. Quando quiser controle exato, descreva a solicitação e o servidor a executa por meio de runRawInsights ou runGraphRead. Três que aparecem diariamente:

Insights: desempenho da 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
}

Os valores de gastos e ações dos 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 mudança 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 = $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	Código aberto (ex.: GoMarble)
Runtime	Nenhum — HTTP remoto	Processo local que você executa	Python local que você executa
Credenciais que você gerencia	Apenas login no Facebook	App Meta + token de acesso da Marketing API	App Meta + token de acesso no .env
Permissões e revisão de app	Gerenciado pela Ryze	Escopos ads_read / ads_management do seu app	Escopos do seu app
Limites de taxa	Gerenciados pelo app da Ryze	Limites de Gerenciamento de Anúncios do seu app	Limites de Gerenciamento de Anúncios 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: MCP oficial da Meta explicado, o servidor MCP do Meta Business SDK, o que o lançamento do MCP e 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 por 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

Ferramentas de leitura são automáticas. No Claude, abra Configurações → Conectores → Ryze AI e mantenha runGraphWrite, runGraphDelete e uploadImageFromUrl em 'Precisa de aprovação' — o padrão recomendado para contas ao vivo.

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 Gerenciamento de Anúncios 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) — estreite 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 = $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 do 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 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
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 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 Gerenciamento de Anúncios 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 a 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 estão em unidades menores.	daily_budget 5000 = $50,00; amount_spent '25468' = $254,68. Gastos de Insights já estão em unidades inteiras.
"Conjuntos de anúncios não podem ser adicionados a campanhas arquivadas"	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: solucionando problemas da conexão Meta Ads MCP. Agências gerenciando 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 mudanças 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 HTTP Streamable com OAuth 2.0. O mesmo endpoint atende aos conjuntos de ferramentas 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 tenha acesso de administrador ou anunciante à conta de anúncios e pronto. Servidores auto-hospedados, como o MCP oficial da Meta ou o servidor de código aberto 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.

Quantas ferramentas Meta Ads o servidor expõe?

12 ferramentas 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. 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 é controlado por aprovação: no Claude, você define como 'Precisa de aprovação' 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 faz a troca 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 a 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 veiculação, 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 Meta Ads MCP?

Conectar é gratuito — criar uma conta Ryze AI não custa nada e o conector não tem taxa por chamada. O Ads Autopilot pago custa US$ 89/mês fixos com teste gratuito de 7 dias se você quiser que a Ryze AI execute as otimizações por você. No lado do cliente, você precisa de um plano Claude que permita conectores personalizados (Pro, Team ou Max) ou um plano ChatGPT com conectores (Plus, Pro ou Business).

O servidor Meta Ads MCP é seguro?

O acesso é somente OAuth 2.0, então sua senha do Facebook nunca toca a Ryze. Cada conexão é limitada a um workspace da Ryze, ferramentas de escrita e exclusão são controladas por aprovação 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 Meta Ads depois que eu conectei?

Inicie um novo chat. Claude e 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 gratuito do Claude — conectores personalizados exigem Pro, Team ou Max. Por fim, confirme se o conector aparece como Conectado em Configurações → Conectores.

Como isso é diferente do 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 obtém apenas 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 gravação.

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

• Google Ads MCP server
• 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 resultar em banimento?

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

Adicione Meta Ads à sua IA hoje.

Conecte gratuitamente. Faça upgrade para o Paid Ads Autopilot (US$ 89/mês fixo, teste gratuito de 7 dias) quando quiser que a Ryze AI execute as otimizações por você, 24/7.

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