Servidor MCP · early access
Google Ads MCP server
Conecte sua conta do Google 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 Google 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://google-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 google-ads https://google-ads.mcp.cinble.com --header "Authorization: Bearer SUA_CHAVE"Cursor, VS Code e outros clientes configurados por JSON
{
"mcpServers": {
"google-ads": {
"url": "https://google-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:
Onde estou desperdiçando verba em termos de pesquisa este mês?
✓ get_search_terms google-ads
Três termos levaram $2.140 sem nenhuma conversão nos últimos 30 dias:
✓ get_keyword_performance google-ads
Responder ao Claude…
Outras perguntas que trazem para ele:
"Quais campanhas subiram o custo por conversão mais de 20% contra o mês passado?"
"O Performance Max está canibalizando minha campanha de marca?"
"Quais palavras-chave de correspondência ampla gastam mais sem converter?"
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 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_search_terms | Os termos de pesquisa com gasto e conversões, os que gastaram sem converter e as palavras que se repetem. |
| get_keyword_performance | Resultados por palavra-chave, com o tipo de correspondência. |
| 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 anúncio, 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 | |
|---|---|---|
| Developer token | Pedir por uma conta de administrador e esperar a aprovação do Google | Já aprovado, o nosso |
| Configuração de OAuth | Projeto no Cloud, cliente OAuth, refresh token | Entrar com o Google |
| Contas de administrador | Você cuida dos login customer IDs na mão | Resolvidas para você |
| Hospedagem e limites | Seus para manter vivo e dentro da cota | Administrados |
| Tempo até a primeira resposta | Dias, esperando o token | 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 Google Ads?
Um servidor Model Context Protocol hospedado pela Cinble que conecta sua conta do Google Ads a assistentes de IA, que passam a ler campanhas, palavras-chave, termos de pesquisa e métricas e a responder em linguagem comum.
Preciso de developer token do Google Ads?
Não. Pedir um e esperar a aprovação do Google é a parte mais lenta de montar um servidor próprio. A Cinble já tem o token aprovado, então você conecta o Google Ads na Cinble e cria uma chave.
O assistente pode alterar minhas campanhas?
Não durante o early access. O servidor é somente leitura: nenhuma ferramenta pausa campanha, muda orçamento ou adiciona palavra-chave. Escrita virá depois, como opt-in explícito por conta.
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 Google Ads junto com o copiloto.
Entrar na lista de espera