Meta Ads MCP

Interaja com a API do Meta Ads para acessar, analisar e gerenciar campanhas de publicidade.

Documentação

Meta Ads MCP

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA — Claude, ChatGPT, Perplexity, Cursor ou qualquer cliente MCP — executem seus Meta Ads de ponta a ponta: lance campanhas, envie criativos, atualize orçamentos e analise desempenho por meio de conversa natural no Facebook, Instagram e em todas as superfícies de anúncios da Meta. Disponível como MCP remoto hospedado — sem token de desenvolvedor, sem necessidade de auto-hospedagem.

Este é o nó Meta Ads da família MCP Pipeboard — cinco servidores MCP remotos (Meta, Google, TikTok, Snap, Reddit) mais um Pipeboard CLI unificado, mais de 230 ferramentas no total, uma autenticação, um modelo de segurança. Se você está comparando MCPs de plataforma única, está olhando para um nó de uma rede — veja A Família MCP Pipeboard abaixo.

Nota: Este é um projeto open-source independente que usa as APIs públicas da Meta. O serviço hospedado por trás dele — Pipeboard — é um Meta Business Partner com selo e um aplicativo Meta oficialmente aprovado que gerencia Meta, Google, TikTok, Snap e Reddit Ads com um único login (com plano gratuito) — portanto, não é exclusivo da Meta nem algo que você precise auto-hospedar. Meta, Facebook, Instagram e outros nomes de marcas da Meta são marcas registradas de seus respectivos proprietários.

mcp-name: co.pipeboard/meta-ads-mcp

Comunidade e Suporte

Discord. Junte-se à comunidade.
Suporte por E-mail. Envie-nos um e-mail para suporte.

Sumário

A Família MCP Pipeboard
🚀 Começando com MCP Remoto (Recomendado para Profissionais de Marketing)
Pipeboard CLI (Alternativa ao MCP)
Instalação Local (Somente Usuários Técnicos)
Recursos
Configuração
Ferramentas MCP Disponíveis
Licenciamento
Privacidade e Segurança
Testes
Solução de Problemas

A Família MCP Pipeboard

O Pipeboard oferece um servidor MCP remoto para cada grande plataforma de anúncios — além de um CLI de binário único que engloba todos eles. Todos os cinco servidores compartilham o mesmo OAuth, a mesma descoberta tools/list, o mesmo modelo de segurança de confirmação de escrita e o mesmo token de API do Pipeboard — então um agente que aprende um, aprende os demais.

Servidores MCP remotos

Plataforma	URL MCP Remota	Superfície
Meta Ads MCP (Facebook + Instagram)	`https://meta-ads.mcp.pipeboard.co/`	42 ferramentas — campanhas, conjuntos de anúncios, anúncios, criativos (incluindo teste de criativo dinâmico), upload de imagens, insights, segmentação por interesse / comportamento / demografia / geolocalização, gerenciamento de páginas
Google Ads MCP	`https://google-ads.mcp.pipeboard.co/`	59 ferramentas — campanhas, grupos de anúncios, anúncios de pesquisa responsivos, Performance Max, palavras-chave, consultas GAQL, extensões (links de site, frases de destaque, snippets estruturados), públicos, uploads de ativos, mutate genérico
TikTok Ads MCP	`https://tiktok-ads.mcp.pipeboard.co/`	59 ferramentas — campanhas, grupos de anúncios, anúncios, identidades, upload de imagens e vídeos, gerenciamento de público e criativos, insights
Snap Ads MCP	`https://snap-ads.mcp.pipeboard.co/`	37 ferramentas — contas de anúncios, campanhas, esquadrões de anúncios, anúncios, criativos, upload de mídia, insights
Reddit Ads MCP	`https://reddit-ads.mcp.pipeboard.co/`	33 ferramentas — contas, campanhas, grupos de anúncios, anúncios, relatórios de desempenho

Isso é mais de 230 ferramentas em cinco plataformas de anúncios com uma única autenticação. Conecte qualquer uma dessas URLs ao Claude, Cursor, ChatGPT, Perplexity ou qualquer cliente compatível com MCP. Conecte suas contas de anúncios uma vez em pipeboard.co e todos os clientes terão acesso.

Pipeboard CLI — as mesmas ferramentas, no seu shell

Pipeboard CLI é um binário Go único que expõe cada ferramenta MCP acima como um comando de shell tipado — criado para agentes de codificação de IA (Claude Code, Cline, OpenClaw, Codex) e scripts de automação que preferem chamadas de subprocesso em vez de JSON-RPC:

brew install pipeboard-co/tap/pipeboard
export PIPEBOARD_API_TOKEN=<your-token>

pipeboard meta-ads get-campaigns   --account-id act_123
pipeboard google-ads execute-gaql-query   --customer-id 1234567890 --query "..."
pipeboard tiktok-ads get-campaigns --advertiser-id 7605685552884596737

Inicialização em menos de 50ms, sem handshake MCP por chamada, todas as cinco plataformas em um único binário. Documentação completa no repositório pipeboard-cli.

Por que uma família em vez de um MCP por repositório?

Uma conta, todas as plataformas — autentique uma vez em pipeboard.co; gerencie Meta + Google + TikTok + Snap + Reddit na mesma sessão de agente
Perguntas entre plataformas recebem respostas entre plataformas — "qual canal teve as inscrições mais baratas na semana passada?" realmente funciona
Mesmo contrato de segurança em todos os lugares — escritas são explícitas, novas campanhas começam pausadas quando a plataforma suporta, e os prompts de confirmação parecem idênticos em todos os cinco servidores
Um token, um teto de limite de taxa, um lugar para revogar — sem gerenciar fluxos OAuth separados ou instalações por fornecedor

Benchmarks de MCP de plataforma única não captam o essencial. O valor está na rede, não no nó.

Como o Pipeboard se compara

Se você está escolhendo entre as formas de executar Meta Ads a partir de um assistente de IA, aqui está o panorama honesto:

	Pipeboard	MCP oficial da Meta	Servidores open-source / auto-hospedados
Plataformas	Meta + Google + TikTok + Snap + Reddit, um login	Somente Meta	Geralmente somente Meta
Configuração	MCP remoto hospedado — sem token de desenvolvedor, ~2 minutos	Hospedado pela Meta (somente Meta)	Auto-hospedado, gerencie seus próprios tokens e atualizações
Confiança	Meta Business Partner com selo + aplicativo Meta aprovado	Primeira parte (Meta)	Varia — audite o código você mesmo
Segurança	Confirmação explícita em cada escrita; novas campanhas começam pausadas	Definido pela Meta	Você constrói as proteções
Preço	Plano gratuito, depois níveis pagos	Gratuito (beta aberto)	Gratuito, mas você administra a infraestrutura

O conector oficial da Meta é a opção mais segura de plataforma única. O Pipeboard é a escolha entre plataformas — o mesmo controle conversacional em cinco redes de anúncios com uma autenticação e um modelo de segurança, com plano gratuito e respaldo de Meta Business Partner. Servidores open-source oferecem controle total se você estiver disposto a auto-hospedar e manter.

Começando com MCP Remoto (Recomendado)

A forma mais rápida e confiável de começar é 🚀 Começar com nosso Meta Ads MCP Remoto. Nosso serviço em nuvem usa transporte HTTP transmissível para acesso confiável e escalável à sua conta de Meta Ads. Sem configuração técnica necessária — basta conectar e começar a lançar, atualizar e analisar campanhas com IA!

Para usuários do Claude Pro/Max

Vá para claude.ai/settings/integrations (requer Claude Pro ou Max)
Clique em "Adicionar Integração" e insira:
- Nome: "Pipeboard Meta Ads" (ou qualquer nome que preferir)
- URL da Integração: https://meta-ads.mcp.pipeboard.co/
Clique em "Conectar" ao lado da integração e siga os prompts para:
- Fazer login no Pipeboard
- Conectar sua conta de Facebook Ads

Pronto! Agora você pode pedir ao Claude para analisar suas campanhas de Meta Ads, obter insights de desempenho e gerenciar sua publicidade.

Avançado: Autenticação Direta por Token (Claude)

Para autenticação direta baseada em token sem o fluxo interativo, use este formato de URL ao adicionar a integração:

https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN

Obtenha seu token em pipeboard.co/api-tokens.

Para usuários do Cursor

Adicione o seguinte ao seu ~/.cursor/mcp.json. Depois de habilitar o MCP remoto, clique em "Needs login" para concluir o processo de login.

{
  "mcpServers": {
    "meta-ads-remote": {
      "url": "https://meta-ads.mcp.pipeboard.co/"
    }
  }
}

Avançado: Autenticação Direta por Token (Cursor)

Se preferir autenticar sem o fluxo de login interativo, você pode incluir seu token de API do Pipeboard diretamente na URL:

{
  "mcpServers": {
    "meta-ads-remote": {
      "url": "https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN"
    }
  }
}

Obtenha seu token em pipeboard.co/api-tokens.

Para outros clientes MCP

Use a URL MCP Remota: https://meta-ads.mcp.pipeboard.co/

📖 Obtenha instruções detalhadas de configuração para seu cliente de IA aqui

Avançado: Autenticação Direta por Token (OpenClaw e outros clientes)

Para clientes MCP que suportam autenticação baseada em token, você pode anexar seu token de API do Pipeboard à URL:

https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN

Isso ignora o fluxo de login interativo e autentica imediatamente. Obtenha seu token em pipeboard.co/api-tokens.

Outras plataformas

Meta Ads é um dos cinco servidores MCP remotos da família — veja A Família MCP Pipeboard para Google Ads, TikTok Ads, Snap Ads e Reddit Ads, todos configurados da mesma forma.

Pipeboard CLI (Alternativa ao MCP)

Se seu agente prefere comandos de shell em vez de JSON-RPC, o Pipeboard CLI expõe cada ferramenta da família como um subcomando tipado — veja a seção da família acima para instalação rápida e o repositório pipeboard-cli para documentação completa.

Instalação Local (Somente Usuários Técnicos Avançados)

🚀 Recomendamos fortemente usar MCP Remoto — é mais rápido, mais confiável e não requer configuração técnica.

O Meta Ads MCP também suporta transporte HTTP transmissível local, permitindo executá-lo como uma API HTTP independente para aplicações web e integrações personalizadas. Veja o Guia de Configuração HTTP Transmissível para instruções completas.

Recursos

Gerenciamento de Campanhas: Lance campanhas, conjuntos de anúncios e anúncios, atualize orçamentos, pause e retome, e aplique mudanças de segmentação — tudo a partir de uma conversa, com confirmação explícita em cada escrita
Operações de Criativos: Envie imagens, crie criativos e atualize textos, títulos, descrições e CTAs sem sair do seu cliente de IA
Teste de Criativo Dinâmico: Uma API para anúncios simples (título/descrição únicos) e testes A/B completos (múltiplos títulos/descrições)
Análise de Campanhas com IA: Deixe seu LLM favorito analisar o desempenho e apresentar insights acionáveis
Recomendações Estratégicas: Receba sugestões baseadas em dados para otimizar gastos com anúncios, segmentação e conteúdo criativo
Otimização de Orçamento: Obtenha recomendações para realocar orçamento para conjuntos de anúncios com melhor desempenho
Melhoria de Criativos: Receba feedback sobre textos de anúncios, imagens e chamadas para ação
Monitoramento Automatizado: Peça a qualquer LLM compatível com MCP para rastrear métricas de desempenho e alertá-lo sobre mudanças significativas
Integração Entre Plataformas: Funciona com Facebook, Instagram e todas as superfícies de anúncios da Meta
Suporte Universal a LLMs: Compatível com qualquer cliente MCP, incluindo Claude Desktop, Cursor, Cherry Studio e outros
Respaldado por Parceiro, Não Apenas Open Source: Construído pela Pipeboard, um Meta Business Partner com selo e aplicativo Meta oficialmente aprovado — com plano gratuito e MCP remoto hospedado (sem necessidade de auto-hospedagem)
Busca Aprimorada: Função de busca genérica inclui pesquisa de páginas quando as consultas mencionam "página" ou "páginas"
Autenticação Simples: Configuração fácil com autenticação OAuth segura
Suporte Entre Plataformas: Funciona em Windows, macOS e Linux

Configuração

MCP Remoto (Recomendado)

✨ Comece com MCP Remoto aqui — sem configuração técnica necessária! Basta conectar sua conta de Facebook Ads e começar a pedir à IA para analisar suas campanhas.

Instalação Local (Usuários Técnicos Avançados)

Para usuários avançados que precisam auto-hospedar, o pacote pode ser instalado a partir do código-fonte. Instalações locais exigem a criação do seu próprio aplicativo de desenvolvedor Meta. Recomendamos usar MCP Remoto para uma experiência mais simples.

Ferramentas MCP Disponíveis

mcp_meta_ads_get_ad_accounts
- Obter contas de anúncios acessíveis por um usuário
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará token em cache se não fornecido)
  - user_id: ID de usuário da Meta ou "me" para o usuário atual
  - limit: Número máximo de contas a retornar (padrão: 200)
- Retorna: Lista de contas de anúncios acessíveis com seus detalhes
mcp_meta_ads_get_account_info
- Obtenha informações detalhadas sobre uma conta de anúncios específica
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - account_id: ID da conta de anúncios da Meta (formato: act_XXXXXXXXX)
- Retorna: Informações detalhadas sobre a conta especificada
mcp_meta_ads_get_account_pages
- Obtenha as páginas associadas a uma conta de anúncios da Meta
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - account_id: ID da conta de anúncios da Meta (formato: act_XXXXXXXXX) ou "me" para as páginas do usuário atual
- Retorna: Lista de páginas associadas à conta, útil para criação e gerenciamento de anúncios
mcp_meta_ads_get_campaigns
- Obtenha campanhas para uma conta de anúncios da Meta com filtragem opcional
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - account_id: ID da conta de anúncios da Meta (formato: act_XXXXXXXXX)
  - limit: Número máximo de campanhas a retornar (padrão: 10)
  - status_filter: Filtrar por status (vazio para todas, ou 'ACTIVE', 'PAUSED', etc.)
- Retorna: Lista de campanhas que correspondem aos critérios
mcp_meta_ads_get_campaign_details
- Obtenha informações detalhadas sobre uma campanha específica
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - campaign_id: ID da campanha de anúncios da Meta
- Retorna: Informações detalhadas sobre a campanha especificada
mcp_meta_ads_create_campaign
- Crie uma nova campanha em uma conta de anúncios da Meta
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - account_id: ID da conta de anúncios da Meta (formato: act_XXXXXXXXX)
  - name: Nome da campanha
  - objective: Objetivo da campanha (ODAX, baseado em resultados). Deve ser um dos seguintes:
    - OUTCOME_AWARENESS
    - OUTCOME_TRAFFIC
    - OUTCOME_ENGAGEMENT
    - OUTCOME_LEADS
    - OUTCOME_SALES
    - OUTCOME_APP_PROMOTION
    Nota: Objetivos legados como BRAND_AWARENESS, LINK_CLICKS, CONVERSIONS, APP_INSTALLS, etc. não são mais válidos para novas campanhas e causarão um erro 400. Use os valores baseados em resultados acima. Mapeamentos comuns:
    - BRAND_AWARENESS → OUTCOME_AWARENESS
    - REACH → OUTCOME_AWARENESS
    - LINK_CLICKS, TRAFFIC → OUTCOME_TRAFFIC
    - POST_ENGAGEMENT, PAGE_LIKES, EVENT_RESPONSES, VIDEO_VIEWS → OUTCOME_ENGAGEMENT
    - LEAD_GENERATION → OUTCOME_LEADS
    - CONVERSIONS, CATALOG_SALES, MESSAGES (fluxos focados em vendas) → OUTCOME_SALES
    - APP_INSTALLS → OUTCOME_APP_PROMOTION
  - status: Status inicial da campanha (padrão: PAUSED)
  - special_ad_categories: Lista de categorias especiais de anúncios, se aplicável
  - daily_budget: Orçamento diário na moeda da conta (em centavos)
  - lifetime_budget: Orçamento vitalício na moeda da conta (em centavos)
  - bid_strategy: Estratégia de lance. Deve ser um dos seguintes: LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS.
- Retorna: Confirmação com os detalhes da nova campanha
- Exemplo:
```
{
  "name": "2025 - Bedroom Furniture - Awareness",
  "account_id": "act_123456789012345",
  "objective": "OUTCOME_AWARENESS",
  "special_ad_categories": [],
  "status": "PAUSED",
  "buying_type": "AUCTION",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP",
  "daily_budget": 10000
}
```
mcp_meta_ads_get_adsets
- Obtenha conjuntos de anúncios para uma conta de anúncios da Meta com filtragem opcional por campanha
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - account_id: ID da conta de anúncios da Meta (formato: act_XXXXXXXXX)
  - limit: Número máximo de conjuntos de anúncios a retornar (padrão: 10)
  - campaign_id: ID da campanha opcional para filtrar
- Retorna: Lista de conjuntos de anúncios que correspondem aos critérios
mcp_meta_ads_get_adset_details
- Obtenha informações detalhadas sobre um conjunto de anúncios específico
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - adset_id: ID do conjunto de anúncios da Meta
- Retorna: Informações detalhadas sobre o conjunto de anúncios especificado
mcp_meta_ads_create_adset
- Crie um novo conjunto de anúncios em uma conta de anúncios da Meta
- Entradas:
  - account_id: ID da conta de anúncios da Meta (formato: act_XXXXXXXXX)
  - campaign_id: ID da campanha de anúncios da Meta à qual este conjunto de anúncios pertence
  - name: Nome do conjunto de anúncios
  - status: Status inicial do conjunto de anúncios (padrão: PAUSED)
  - daily_budget: Orçamento diário na moeda da conta (em centavos) como string
  - lifetime_budget: Orçamento vitalício na moeda da conta (em centavos) como string
  - targeting: Especificações de segmentação (ex.: idade, localização, interesses)
  - optimization_goal: Meta de otimização de conversão (ex.: 'LINK_CLICKS')
  - billing_event: Como você é cobrado (ex.: 'IMPRESSIONS')
  - bid_amount: Valor do lance em centavos. Obrigatório para LOWEST_COST_WITH_BID_CAP, COST_CAP, TARGET_COST.
  - bid_strategy: Estratégia de lance (ex.: 'LOWEST_COST_WITHOUT_CAP', 'LOWEST_COST_WITH_MIN_ROAS')
  - bid_constraints: Dicionário de restrições de lance. Obrigatório para LOWEST_COST_WITH_MIN_ROAS (ex.: {"roas_average_floor": 20000})
  - start_time, end_time: Horários de início/término opcionais (ISO 8601)
  - access_token (opcional): Token de acesso à API da Meta
- Retorna: Confirmação com os detalhes do novo conjunto de anúncios
mcp_meta_ads_get_ads
- Obtenha anúncios para uma conta de anúncios da Meta com filtragem opcional
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - account_id: ID da conta de anúncios da Meta (formato: act_XXXXXXXXX)
  - limit: Número máximo de anúncios a retornar (padrão: 10)
  - campaign_id: ID da campanha opcional para filtrar
  - adset_id: ID do conjunto de anúncios opcional para filtrar
- Retorna: Lista de anúncios que correspondem aos critérios
mcp_meta_ads_create_ad
- Crie um novo anúncio com uma criação existente
- Entradas:
  - account_id: ID da conta de anúncios da Meta (formato: act_XXXXXXXXX)
  - name: Nome do anúncio
  - adset_id: ID do conjunto de anúncios onde este anúncio será colocado
  - creative_id: ID de uma criação existente a ser usada
  - status: Status inicial do anúncio (padrão: PAUSED)
  - bid_amount: Valor do lance opcional (em centavos)
  - tracking_specs: Especificações de rastreamento opcionais
  - access_token (opcional): Token de acesso à API da Meta
- Retorna: Confirmação com os detalhes do novo anúncio
mcp_meta_ads_get_ad_details
- Obtenha informações detalhadas sobre um anúncio específico
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - ad_id: ID do anúncio da Meta
- Retorna: Informações detalhadas sobre o anúncio especificado
mcp_meta_ads_get_ad_creatives
- Obtenha detalhes da criação para um anúncio específico
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - ad_id: ID do anúncio da Meta
- Retorna: Detalhes da criação, incluindo texto, imagens e URLs
mcp_meta_ads_create_ad_creative
- Crie uma nova criação de anúncio usando um hash de imagem enviada
- Entradas:
  - account_id: ID da conta de anúncios da Meta (formato: act_XXXXXXXXX)
  - name: Nome da criação
  - image_hash: Hash da imagem enviada
  - page_id: ID da Página do Facebook para o anúncio
  - link_url: URL de destino
  - message: Texto do anúncio
  - headline: Título único para anúncios simples (não pode ser usado com títulos)
  - headlines: Lista de títulos para teste criativo dinâmico (não pode ser usado com título)
  - description: Descrição única para anúncios simples (não pode ser usado com descrições)
  - descriptions: Lista de descrições para teste criativo dinâmico (não pode ser usado com descrição)
  - dynamic_creative_spec: Configurações de otimização criativa dinâmica
  - call_to_action_type: Tipo de botão de CTA (ex.: 'LEARN_MORE')
  - instagram_actor_id: ID da conta do Instagram opcional
  - access_token (opcional): Token de acesso à API da Meta
- Retorna: Confirmação com os detalhes da nova criação
mcp_meta_ads_update_ad_creative
- Atualize uma criação de anúncio existente com novo conteúdo ou configurações
- Entradas:
  - creative_id: ID da criação de anúncios da Meta a ser atualizada
  - name: Novo nome da criação
  - message: Novo texto do anúncio
  - headline: Título único para anúncios simples (não pode ser usado com títulos)
  - headlines: Nova lista de títulos para teste criativo dinâmico (não pode ser usado com título)
  - description: Descrição única para anúncios simples (não pode ser usado com descrições)
  - descriptions: Nova lista de descrições para teste criativo dinâmico (não pode ser usado com descrição)
  - dynamic_creative_spec: Novas configurações de otimização criativa dinâmica
  - call_to_action_type: Novo tipo de botão de chamada para ação
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
- Retorna: Confirmação com os detalhes da criação atualizada
mcp_meta_ads_upload_ad_image
- Envie uma imagem para usar em criações de anúncios da Meta
- Entradas:
  - account_id: ID da conta de anúncios da Meta (formato: act_XXXXXXXXX)
  - image_path: Caminho para o arquivo de imagem a ser enviado
  - name: Nome opcional para a imagem
  - access_token (opcional): Token de acesso à API da Meta
- Retorna: Resposta JSON com detalhes da imagem, incluindo hash
mcp_meta_ads_get_ad_image
- Obtenha, baixe e visualize uma imagem de anúncio da Meta em uma única etapa
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - ad_id: ID do anúncio da Meta
- Retorna: A imagem do anúncio pronta para análise visual direta
mcp_meta_ads_update_ad
- Atualize um anúncio com novas configurações
- Entradas:
  - ad_id: ID do anúncio da Meta
  - status: Atualizar o status do anúncio (ACTIVE, PAUSED, etc.)
  - bid_amount: Valor do lance na moeda da conta (em centavos para USD)
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
- Retorna: Confirmação com os detalhes do anúncio atualizado e um link de confirmação
mcp_meta_ads_update_adset
- Atualize um conjunto de anúncios com novas configurações, incluindo limites de frequência
- Entradas:
  - adset_id: ID do conjunto de anúncios da Meta
  - frequency_control_specs: Lista de especificações de controle de frequência
  - bid_strategy: Estratégia de lance (ex.: 'LOWEST_COST_WITH_BID_CAP', 'LOWEST_COST_WITH_MIN_ROAS')
  - bid_amount: Valor do lance em centavos. Obrigatório para LOWEST_COST_WITH_BID_CAP, COST_CAP, TARGET_COST.
  - bid_constraints: Dicionário de restrições de lance. Obrigatório para LOWEST_COST_WITH_MIN_ROAS (ex.: {"roas_average_floor": 20000})
  - status: Atualizar o status do conjunto de anúncios (ACTIVE, PAUSED, etc.)
  - targeting: Especificações de segmentação, incluindo targeting_automation
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
- Retorna: Confirmação com os detalhes do conjunto de anúncios atualizado e um link de confirmação
mcp_meta_ads_get_insights
- Obtenha insights de desempenho para uma campanha, conjunto de anúncios, anúncio ou conta
- Entradas:
  - access_token (opcional): Token de acesso à API da Meta (usará o token em cache se não for fornecido)
  - object_id: ID da campanha, conjunto de anúncios, anúncio ou conta
  - time_range: Intervalo de tempo para insights (padrão: máximo)
  - breakdown: Dimensão de detalhamento opcional (ex.: idade, gênero, país)
  - level: Nível de agregação (ad, adset, campaign, account)
  - action_attribution_windows (opcional): Lista de janelas de atribuição para dados de conversão (ex.: ["1d_click", "1d_view", "7d_click", "7d_view"]). Quando especificada, actions e cost_per_action_type incluem campos adicionais para cada janela. O campo 'value' sempre mostra a atribuição de 7d_click.
- Retorna: Métricas de desempenho para o objeto especificado
mcp_meta_ads_get_login_link
- Obtenha um link de login clicável para autenticação no Meta Ads
- Entradas:
  - access_token (opcional): Token de acesso à API do Meta (usará o token em cache se não for fornecido)
- Retorna: Um link de recurso clicável para autenticação no Meta
mcp_meta_ads_create_budget_schedule
- Crie um agendamento de orçamento para uma campanha do Meta Ads
- Entradas:
  - campaign_id: ID da campanha do Meta Ads
  - budget_value: Valor do aumento de orçamento
  - budget_value_type: Tipo de valor de orçamento ("ABSOLUTE" ou "MULTIPLIER")
  - time_start: Timestamp Unix para quando o período de alta demanda deve começar
  - time_end: Timestamp Unix para quando o período de alta demanda deve terminar
  - access_token (opcional): Token de acesso à API do Meta
- Retorna: String JSON com o ID do agendamento de orçamento criado ou uma mensagem de erro
mcp_meta_ads_search_interests
- Pesquise opções de segmentação por interesses usando palavras-chave
- Entradas:
  - access_token (opcional): Token de acesso à API do Meta (usará o token em cache se não for fornecido)
  - query: Termo de busca para interesses (ex.: "beisebol", "culinária", "viagem")
  - limit: Número máximo de resultados a retornar (padrão: 25)
- Retorna: Dados de interesse com campos id, name, audience_size e path
mcp_meta_ads_get_interest_suggestions
- Obtenha sugestões de interesses com base em interesses existentes
- Entradas:
  - access_token (opcional): Token de acesso à API do Meta (usará o token em cache se não for fornecido)
  - interest_list: Lista de nomes de interesses para obter sugestões (ex.: ["Basquete", "Futebol"])
  - limit: Número máximo de sugestões a retornar (padrão: 25)
- Retorna: Interesses sugeridos com campos id, name, audience_size e description
mcp_meta_ads_validate_interests
- Valide nomes ou IDs de interesses para segmentação
- Entradas:
  - access_token (opcional): Token de acesso à API do Meta (usará o token em cache se não for fornecido)
  - interest_list: Lista de nomes de interesses para validar (ex.: ["Japão", "Basquete"])
  - interest_fbid_list: Lista de IDs de interesses para validar (ex.: ["6003700426513"])
- Retorna: Resultados de validação mostrando status válido e audience_size para cada interesse
mcp_meta_ads_search_behaviors
- Obtenha todas as opções de segmentação por comportamento disponíveis
- Entradas:
  - access_token (opcional): Token de acesso à API do Meta (usará o token em cache se não for fornecido)
  - limit: Número máximo de resultados a retornar (padrão: 50)
- Retorna: Opções de segmentação por comportamento com campos id, name, audience_size bounds, path e description
mcp_meta_ads_search_demographics
- Obtenha opções de segmentação demográfica
- Entradas:
  - access_token (opcional): Token de acesso à API do Meta (usará o token em cache se não for fornecido)
  - demographic_class: Tipo de dados demográficos ('demographics', 'life_events', 'industries', 'income', 'family_statuses', 'user_device', 'user_os')
  - limit: Número máximo de resultados a retornar (padrão: 50)
- Retorna: Opções de segmentação demográfica com campos id, name, audience_size bounds, path e description
mcp_meta_ads_search_geo_locations
- Pesquise locais de segmentação geográfica
- Entradas:
  - access_token (opcional): Token de acesso à API do Meta (usará o token em cache se não for fornecido)
  - query: Termo de busca para locais (ex.: "Nova York", "Califórnia", "Japão")
  - location_types: Tipos de locais a pesquisar (['country', 'region', 'city', 'zip', 'geo_market', 'electoral_district'])
  - limit: Número máximo de resultados a retornar (padrão: 25)
- Retorna: Dados de local com campos key, name, type e informações de hierarquia geográfica

Licenciamento

O Meta Ads MCP é licenciado sob a Business Source License 1.1, o que significa:

✅ Gratuito para uso para fins individuais e empresariais
✅ Modifique e personalize conforme necessário
✅ Redistribua para outras pessoas
✅ Torna-se totalmente open source (Apache 2.0) em 1º de janeiro de 2029

A única restrição é que você não pode oferecer isso como um serviço hospedado concorrente. Para perguntas sobre licenciamento comercial, entre em contato conosco.

Privacidade e Segurança

O Meta Ads MCP segue as melhores práticas de segurança com gerenciamento seguro de tokens e tratamento automático de autenticação.

MCP Remoto: Toda a autenticação é tratada com segurança na nuvem - nenhum armazenamento local de token é necessário
Instalação Local: Os tokens são armazenados em cache com segurança na sua máquina local

Testes

Testes Básicos

Teste sua conexão com o Meta Ads MCP usando qualquer cliente MCP:

Verifique o Acesso à Conta: Peça ao seu LLM para usar mcp_meta_ads_get_ad_accounts
Verifique os Detalhes da Conta: Use mcp_meta_ads_get_account_info com o ID da sua conta
Liste Campanhas: Tente mcp_meta_ads_get_campaigns para ver suas campanhas de anúncios

Para testes detalhados de instalação local, consulte o repositório de origem.

Solução de Problemas

💡 Correção Rápida: Pule a Configuração Técnica!

A maneira mais fácil de evitar qualquer problema de configuração é 🎯 usar nosso MCP Remoto. Sem downloads, sem configuração - basta conectar sua conta de anúncios e começar a obter insights de IA sobre suas campanhas imediatamente!

Problemas de Instalação Local

Para problemas de instalação local, consulte o repositório de origem. Para a experiência mais fácil, recomendamos usar o MCP Remoto.