Servidor MCP · early access
Meta Ads MCP server
Conecte sua conta do Meta Ads ao Claude Code, ao Cursor ou a qualquer cliente MCP. Uma chave da Cinble, nenhum token de API para cuidar, somente leitura.
Não disponível no plano Gratuito
O Model Context Protocol (MCP) é o padrão aberto que permite a assistentes de IA chamarem ferramentas externas. A Cinble roda um servidor MCP hospedado do Meta Ads: em vez de registrar um app de desenvolvedor, gerar tokens de API e babá de servidor, você cria uma chave na Cinble, aponta o assistente para uma URL e começa a perguntar sobre as suas campanhas.
O endpoint
Server URL
https://meta-ads.mcp.cinble.com
O transporte é HTTP e a autorização é uma chave de acesso que você cria na Cinble, em Conexões, MCP. Na chave você escolhe o servidor, as contas que ela enxerga e a validade, e pode revogá-la a qualquer momento: ela para de responder na hora. As respostas vêm do que a Cinble já sincronizou das suas contas conectadas, até o último dia completo.
Como conectar
Claude Code
claude mcp add --transport http meta-ads https://meta-ads.mcp.cinble.com --header "Authorization: Bearer SUA_CHAVE"Cursor, VS Code e outros clientes configurados por JSON
{
"mcpServers": {
"meta-ads": {
"url": "https://meta-ads.mcp.cinble.com",
"headers": { "Authorization": "Bearer SUA_CHAVE" }
}
}
}Adicione o bloco ao arquivo de configuração MCP do cliente, troque SUA_CHAVE pela chave criada na Cinble e reinicie.
Agentes próprios
Qualquer cliente que fale MCP por HTTP e aceite um header de autorização funciona, inclusive agentes que você constrói com um SDK compatível.
Claude na web e ChatGPT
Em breve. O conector personalizado desses apps exige login por OAuth, que estamos construindo. Enquanto isso, use um dos clientes acima.
O que dá para perguntar depois de conectar
Você pergunta em linguagem comum. O assistente escolhe as ferramentas, lê os números que a Cinble sincronizou da sua conta e responde com os valores que usou:
Quais campanhas de prospecção estão queimando verba sem converter?
✓ get_performance meta-ads
Duas das suas cinco campanhas de prospecção estão abaixo do ponto de equilíbrio nos últimos 14 dias:
✓ compare_periods meta-ads
Responder ao Claude…
Outras perguntas que trazem para ele:
"O Advantage+ Shopping está ganhando das minhas campanhas manuais em ROAS este mês?"
"Quais criativos tiveram o CTR caindo nas últimas duas semanas?"
"Abra o gasto do mês passado por campanha e marque o que passar de $60 por compra."
Nada é copiado e colado, e os números são os mesmos do seu painel na Cinble. No early access o assistente recomenda o movimento e deixa a execução com você.
Ferramentas expostas
| Ferramenta | O que devolve |
|---|---|
| list_ad_accounts | As contas de anúncio que a chave enxerga, com nome, ID, moeda, fuso e última sincronização. |
| list_campaigns | As campanhas, com objetivo, situação e orçamento. |
| list_creatives | Os anúncios em si: títulos, texto, destino, formato e situação de aprovação. |
| get_performance | Gasto, impressões, cliques, CTR, CPC, CPM, conversões, custo por conversão e ROAS, no total e por campanha. |
| get_timeseries | Uma linha por dia, para achar quando algo mudou. |
| compare_periods | Dois períodos lado a lado, com as variações já calculadas. |
| get_audience_breakdown | Os números por idade, gênero, região, dispositivo ou posicionamento. |
| get_conversion_actions | As conversões por evento que as gerou. |
| get_creative_performance | Resultados por criativo, para saber qual peça carrega a campanha. |
| get_campaign_health | Uma nota de 0 a 100 por campanha contra o próprio passado, com o motivo da piora. |
Nomes e argumentos são descobertos do próprio servidor, então o assistente aprende a superfície ao conectar. A lista acima é o que o early access entrega.
Permissões e segurança
- Somente leitura no early access. Nenhuma ferramenta do conjunto atual gasta dinheiro, pausa campanha ou edita orçamento. Um assistente que te entende errado não custa nada.
- Você escolhe as contas. Ao criar a chave você marca as contas que ela enxerga, ou deixa todas. Conta fora da chave é invisível para o servidor.
- Revogável a qualquer momento na Cinble. A chave para de responder na hora.
- Escrita é planejada, não padrão. Quando chegar, será opt-in explícito por conta com etapa de confirmação, como o copiloto da Cinble já funciona.
Hospedado contra rodar o seu
Existem servidores em código aberto, e são uma escolha razoável se você quer controle total do processo. O que você assume é o encanamento:
| Por sua conta | Hospedado pela Cinble | |
|---|---|---|
| App de desenvolvedor do Meta | Você cria e mantém | O nosso |
| Tokens de acesso | Você gera, guarda e renova | Uma chave da Cinble, criada em um clique |
| Limites de requisição | Seu problema quando o assistente conversa demais | Nenhum: as respostas vêm do banco da Cinble |
| Hospedagem | Um processo para manter vivo | Nenhuma |
| Tempo até a primeira resposta | Uma tarde, num dia bom | Criar uma chave e colar um comando |
Onde o copiloto assume
Uma conexão MCP responde o que você lembrar de perguntar, e roda só enquanto você está no chat. O que ela não faz é vigiar a conta quando você não está olhando. Essa é a outra metade da Cinble: o copiloto consolida as mesmas contas conectadas num painel, lê o histórico e coloca as decisões de verba na sua frente, ordenadas por impacto.
Perguntas frequentes
O que é o servidor MCP do Meta Ads?
Um servidor Model Context Protocol hospedado pela Cinble que conecta sua conta do Meta Ads a assistentes de IA, que passam a ler campanhas, criativos, públicos e métricas e a responder em linguagem comum.
Preciso de token da Marketing API do Meta?
Não. A Cinble já sincroniza as contas que você conectou. Você cria uma chave na Cinble e conecta o assistente com ela.
O assistente pode alterar ou pausar minhas campanhas?
Não durante o early access. O servidor é somente leitura. Escrita virá depois, como opt-in explícito por conta e com etapa de confirmação.
Quais clientes de IA funcionam?
Claude Code, Cursor, VS Code e qualquer cliente que fale MCP por HTTP e aceite um header de autorização. O conector do Claude na web e o ChatGPT exigem OAuth, que está a caminho.
Os números são em tempo real?
Não. O servidor lê o que a Cinble já sincronizou, até o último dia completo, e toda resposta diz até que dia os dados vão. O dia corrente fica de fora porque a plataforma ainda está contabilizando.
Quanto custa?
Faz parte de qualquer plano pago da Cinble, sem custo extra.
Ative o servidor na sua conta
O early access está abrindo em lotes para contas com plano pago. Entre na lista de espera e ligamos o servidor MCP do Meta Ads junto com o copiloto.
Entrar na lista de espera