O PaidSync é nossa escolha para a maioria das equipes que decidem entre o MCP oficial do Google Ads e suas alternativas: ele dá ao Claude ou ao ChatGPT 158 ferramentas do Google Ads que leem relatórios e fazem alterações, conecta sem chave de API, sem token de desenvolvedor do Google e sem projeto do Google Cloud, e o mesmo login alcança 14 plataformas, incluindo Meta e LinkedIn. O PaidSync é grátis para 100 tarefas por mês, no valor de $50, sem cartão de crédito, depois com preço por uso, a partir de $99 por mês para 1,000 tarefas.
O servidor oficial do Google é a escolha gratuita para um caso mais restrito, quando você só precisa de respostas e pode hospedá-lo por conta própria. Ele é do próprio Google e ainda é somente leitura: a versão 0.0.4, publicada em 25 de setembro de 2026, tem 3 ferramentas para relatórios e diagnósticos, então não pode pausar uma campanha, alterar um orçamento nem adicionar uma palavra-chave negativa, e um mantenedor do Google diz que o acesso de escrita está planejado, sem data. Você não precisa mais de um token de desenvolvedor para ele: a documentação de token de desenvolvedor do Google diz que os tokens foram encerrados em 9 de setembro de 2026, e o acesso agora segue o projeto do Google Cloud por trás das suas credenciais OAuth. Aviso: o PaidSync publica esta página.
Cada fato desta página foi checado em uma fonte primária ao vivo em 27 de setembro de 2026: o repositório oficial e suas notas de versão, o histórico de versões no PyPI, a página de token de desenvolvedor e a documentação do servidor MCP do Google, e os repositórios comunitários citados abaixo. Várias páginas de terceiros ainda erram a data de lançamento ou os recursos, e algumas ainda mandam os leitores buscar um token de desenvolvedor. As fontes primárias estão linkadas para você conferir por conta própria.
Qual opção escolher
Nossa escolha para a maioria das equipes é o PaidSync. Sem nada para hospedar, ele dá ao Claude ou ao ChatGPT 94 ferramentas de escrita do Google Ads e cria cinco tipos de campanha: Pesquisa, Performance Max, Display, Shopping e Demand Gen. Por padrão, novas campanhas e anúncios começam pausados ou como rascunhos, e edições de orçamento rodam primeiro como prévia. Pausas, ativações e remoções ao vivo exigem um sinalizador de confirmação explícito, e uma mudança de orçamento de campanha do Google Ads maior que 50% exige um segundo. O PaidSync é grátis para 100 tarefas por mês sem cartão de crédito, depois com preço por uso, a partir de $99 por mês para 1,000 tarefas. O mesmo login funciona na Meta e no LinkedIn.
O que saber. O acesso ao Search Console é somente leitura, e o plano grátis do PaidSync para em 100 tarefas por mês.
Escolha outra opção se um destes casos mais restritos combinar com você. Os fatos por trás de cada escolha estão nas seções e na tabela abaixo.
- Você só precisa de relatórios e pode rodar um servidor por conta própria. Use o servidor oficial do Google em github.com/googleads/google-ads-mcp. Ele é gratuito, do próprio Google e somente leitura. Você o hospeda, e o projeto do Google Cloud por trás das suas credenciais OAuth precisa de acesso à API do Google Ads. Não é preciso token de desenvolvedor desde 9 de setembro de 2026.
- Seu trabalho principal é juntar dados do Google Ads com seu CRM, sua loja ou muitas outras fontes de dados. Veja o Windsor.ai ou o Supermetrics.
- Você quer código aberto para estender. Comece pelo repositório do Google, não pelos comunitários. Os dois servidores comunitários populares que verificamos só leem dados e ainda chamam a versão 19 da API do Google Ads, que o Google não lista mais como disponível. O Google disse que não aceitará pull requests externos que adicionem recursos de escrita, então qualquer ferramenta de escrita que você adicionar fica no seu próprio fork.
- Você precisa de alterações e não aceita nenhum terceiro no caminho dos dados. Construa diretamente na API do Google Ads e reserve tempo real de engenharia para login, verificações de segurança nas alterações e manutenção.
O que mudou desde agosto de 2026
Esta página foi publicada pela primeira vez em 1 de agosto de 2026. Três coisas mudaram em setembro e uma não mudou, e algumas páginas que ranqueiam para este tema ainda descrevem a configuração antiga.
- 9 de setembro de 2026. Os tokens de desenvolvedor foram encerrados. A página de token de desenvolvedor do Google diz: “You can continue sending developer tokens in your API call headers, but this is optional and ignored by the API servers.” Seu nível de acesso à API agora vem do projeto do Google Cloud que você usou para criar suas credenciais OAuth, e o Google moveu automaticamente os níveis de acesso dos tokens existentes para projetos do Cloud, com base na atividade recente da API.
- 9 e 10 de setembro de 2026. O servidor oficial acompanhou. A versão 0.0.2 chegou ao PyPI em 9 de setembro e a 0.0.3 em 10 de setembro, com a nota de versão “Remove devtoken validation”. O README agora marca a etapa do token de desenvolvedor como “Optional”.
- 25 de setembro de 2026. Versão 0.0.4. Ela adiciona um parâmetro opcional de ID de cliente de login a toda ferramenta que pode usá-lo, para que uma conta de administrador (MCC) escolha a conta do cliente em cada requisição, e corrige a compatibilidade do Streamable HTTP entre clientes MCP.
- Added on 2 November 2026. Write access for assets and labels. Release v0.0.6 says "Implement asset and label management with propose-and-confirm flow" (release notes, read 7 Nov 2026), with four write tools behind a propose-and-confirm step.
O que o Google lançou em 7 de outubro de 2025
Em 7 de outubro de 2025, a equipe da API do Google Ads publicou “Open Source Google Ads API MCP Server” no Ads Developer Blog e abriu o código em github.com/googleads/google-ads-mcp. O primeiro pacote chegou ao PyPI em 22 de outubro de 2025. O anúncio tem uma frase que resolve toda a comparação:
“This initial release is read-only, meaning it can be used for reporting and diagnostics but will not make changes to your account.”
Equipe da API do Google Ads, Ads Developer Blog, 7 de outubro de 2025Quase um ano depois, isso continua verdadeiro. O repositório lista três ferramentas: search (executa consultas GAQL na sua conta), get_resource_metadata (descreve os campos de um tipo de recurso da API, como campaign) e list_accessible_customers (retorna os IDs de cliente que seu login alcança). No código, a ferramenta search roda por search_stream e é registrada com readOnlyHint=True. O servidor também oferece 4 recursos: o documento de descoberta da API, métricas, segmentos e notas de versão. Um arquivo tools_config.yaml permite ligar e desligar ferramentas individuais ou grupos inteiros e renomear seus prefixos. Ele exige Python 3.10 ou superior, usa a licença Apache 2.0 e roda localmente com pipx ou Docker, ou no Google Cloud Run. O Google não oferece endpoint hospedado.
A configuração mudou desde o lançamento. Você não precisa mais de token de desenvolvedor. Seu nível de acesso à API vem do projeto do Google Cloud por trás das suas credenciais OAuth, e para consultar contas reais esse projeto precisa de pelo menos acesso Explorer, que permite 2,880 operações da API do Google Ads por dia em contas de produção. Você também ativa a API do Google Ads nesse projeto e escolhe uma de três configurações de credenciais: o proxy OAuth do FastMCP com seu próprio ID e segredo de cliente OAuth, Application Default Credentials ou um arquivo google-ads.yaml para o cliente Python da API do Google Ads.
Uma linha do repositório que vale ler antes de conectar qualquer coisa: “The MCP Server will expose your data to the Agent or LLM that you connect to it.” Isso vale para todas as opções desta página, incluindo a nossa. O README também diz que um cabeçalho extra é adicionado às suas chamadas de API para que o Google possa coletar dados de uso.
O que somente leitura significa na prática
Somente leitura parece um detalhe. Em uma conta real, é o fluxo de trabalho inteiro. O servidor oficial pode dizer ao seu assistente de IA que o gasto de uma campanha dobrou da noite para o dia. Ele não pode pausar essa campanha. Uma pessoa ainda precisa abrir a interface do Google Ads e clicar.
O que ele pode fazer
- Executar qualquer consulta GAQL: gasto, conversões, termos de pesquisa, índice de qualidade, histórico de alterações
- Listar todas as contas que seu login pode acessar
- Escolher uma conta de cliente sob uma conta de administrador em cada requisição (adicionado na 0.0.4)
- Explicar ao modelo os recursos e as métricas da própria API
- Alimentar com respostas o Antigravity, o Codex, o Claude Code, o Cursor ou outro cliente MCP
O que ele não faz
- Pausar ou ativar campanhas, grupos de anúncios ou anúncios
- Alterar orçamentos ou estratégias de lances
- Adicionar palavras-chave negativas
- Editar anúncios responsivos de pesquisa ou ativos
- Criar qualquer coisa
Então o enquadramento honesto não é “oficial vs não oficial”. É “somente leitura vs escrita”. Se o seu fluxo termina em um relatório, o servidor oficial resolve. Se o seu fluxo termina com a conta mudando, ele para um passo antes, sempre.
Quando o servidor oficial é a escolha certa
Há casos reais em que o servidor oficial é a escolha correta, e fingir o contrário seria bobagem:
- Você já tem um projeto do Google Cloud com acesso à API do Google Ads. Se você usava um token de desenvolvedor antes de 9 de setembro de 2026, o Google moveu automaticamente o nível de acesso dele para seus projetos do Cloud, com base na atividade recente da API.
- Relatórios são todo o trabalho. Resumos semanais, detecção de anomalias, exploração de GAQL, controle de qualidade no histórico de alterações. Somente leitura cobre tudo isso.
- A confiança em um fornecedor oficial importa para seu cliente ou sua equipe jurídica. Código mantido pelo Google, Apache 2.0, nenhum terceiro no caminho dos dados. Para algumas agências, essa única propriedade decide.
- Você quer custo zero de software. O código é gratuito. Se você o implantar no Cloud Run, paga ao Google Cloud pela hospedagem.
Se essa lista descreve você, use-o. Comparamos com ele frente a frente em PaidSync vs o MCP oficial do Google Ads, e a opção gratuita às vezes é a nossa própria recomendação.
Quando precisa de escrita e mensuração
A lacuna aparece na primeira vez que seu assistente encontra algo que vale corrigir. Gasto desperdiçado em um termo de pesquisa pede uma palavra-chave negativa. Uma campanha que gasta demais pede uma pausa. Um orçamento precisa ser remanejado antes do fim de semana. Somente leitura transforma cada um desses casos em uma passagem de bastão; o acesso de escrita os transforma em uma ação aprovada.
O PaidSync é o nosso produto, então aqui vão os fatos simples, sem adjetivos. É um servidor MCP hospedado com mais de 630 ferramentas em 14 plataformas. 158 delas funcionam no Google Ads: 64 leem dados e 94 fazem alterações, de orçamentos, lances e palavras-chave negativas a ações de conversão e experimentos. Ele cria cinco tipos de campanha do Google Ads: Pesquisa, Performance Max, Display, Shopping e Demand Gen. O mesmo login faz alterações na Meta (92 ferramentas) e no LinkedIn (34 ferramentas). Por padrão, novas campanhas e anúncios começam pausados ou como rascunhos, e edições de orçamento rodam primeiro como prévia. A mensuração vem no mesmo endpoint: 39 ferramentas do Google Tag Manager que cobrem tags, acionadores, variáveis e publicação, 26 ferramentas do GA4 incluindo criação de eventos de conversão e 6 ferramentas somente leitura do Search Console. Não há projeto do Google Cloud, cliente OAuth nem servidor para você configurar: você entra no PaidSync e aprova o acesso na tela de consentimento do próprio Google.
Os preços são públicos na página de preços. O PaidSync é grátis para 100 tarefas por mês em todas as 14 plataformas, sem cartão de crédito e sem limite de tempo. Depois disso você paga pelo uso, as tarefas que sua IA executa, não por assentos nem por uma parte do investimento em anúncios: o Pro custa $99 por mês para 1,000 tarefas, $149 para 2,500 e $199 para 6,000, ou $999 cobrados por ano para 1,000 por mês, e você pode adicionar tarefas se elas acabarem. O Team começa em $249 por mês para até 20 assentos dividindo 10,000 tarefas. Um plano Done For You tem preço personalizado.
Experimente grátis o lado com capacidade de escrita. 100 tarefas por mês, sem cartão.
Comece grátis Ver o servidor MCPQuatro opções comparadas
Estas são as quatro formas realistas de colocar o Google Ads atrás de um endpoint MCP em 2026, com o PaidSync primeiro como nossa escolha. A linha comunitária vem dos dois repositórios comunitários com mais estrelas que verificamos. Há outros, e suas listas de ferramentas variam, então leia o código-fonte de qualquer repositório antes de conectá-lo a uma conta que gasta dinheiro.
| Opção | Ferramentas do Google Ads | Acesso de escrita | Plataformas | Configuração | Mensuração (GA4, GTM, GSC) | Preço |
|---|---|---|---|---|---|---|
| PaidSync | 158, das quais 94 fazem alterações (mais de 630 no total) | Sim, no Google, na Meta e no LinkedIn | 14 plataformas | Hospedado. Entre no PaidSync e aprove a tela de consentimento do Google | GA4 26 ferramentas, GTM 39 com publicação, GSC 6 somente leitura | Grátis para 100 tarefas por mês sem cartão de crédito, depois com preço por uso, a partir de $99 por mês para 1,000 tarefas. |
| MCP oficial do Google Ads | 3 | Não, somente leitura na 0.0.4. Acesso de escrita planejado, sem data | Só Google Ads | Você hospeda. Python 3.10 ou superior ou Docker, um projeto do Google Cloud com acesso Explorer ou superior, suas próprias credenciais OAuth. Sem token de desenvolvedor | Não | $0 por mês pelo software, Apache 2.0. Você paga sua própria hospedagem |
| Servidores comunitários (cohnen, gomarble) | 12 (cohnen), 3 (gomarble) | Não, somente leitura no código | Só Google Ads | Você hospeda. O código ainda pede um token de desenvolvedor e chama a versão 19 da API | Não | $0 por mês, MIT |
| Solução própria na API do Google Ads | O que você construir | Possível, você constrói a camada de segurança | O que você construir | Um projeto do Google Cloud com o nível de acesso certo, mais tempo de engenharia | APIs separadas, construções separadas | Custo de engenharia |
Verificado em 27 de setembro de 2026. As linhas oficial e comunitária vêm dos repositórios ao vivo do GitHub e do código deles; a linha do PaidSync vem do nosso catálogo de ferramentas gerado, resumido na página do servidor MCP.
O que o PaidSync não faz
Os limites, sem rodeios
O acesso ao Search Console é somente leitura, 6 ferramentas. O PaidSync cria novas campanhas no Google Ads, na Meta, no LinkedIn e no ChatGPT Ads; na Microsoft, no TikTok, no Snapchat, no Reddit, no Pinterest e no X ele atua dentro de campanhas que você já executa. E, além das 100 tarefas por mês do plano grátis, você paga pelo uso, a partir de $99 por mês para 1,000 tarefas. Se tudo de que você precisa é relatório só do Google Ads e você pode hospedar um servidor, o oficial faz esse trabalho de graça, e você deve usá-lo.
Adicionar ao ChatGPT: abra o PaidSync.ai no diretório de plugins do ChatGPT, instale e faça login.
Adicionar ao Claude: abra o PaidSync.ai no diretório de conectores do Claude, clique em Conectar e faça login.
Perguntas frequentes
O MCP oficial do Google Ads é somente leitura?
Yes. Google's announcement on the Ads Developer Blog (7 October 2025) says: "This initial release is read-only, meaning it can be used for reporting and diagnostics but will not make changes to your account." Release v0.0.6, published on 2 November 2026, adds writes: its release notes say "Implement asset and label management with propose-and-confirm flow" (GitHub release notes, read 7 Nov 2026), and its README lists four write tools with a propose-and-confirm step and a setting to run it strictly read-only.
Ainda preciso de um token de desenvolvedor do Google Ads?
Não. A documentação de token de desenvolvedor do Google diz que os tokens de desenvolvedor foram encerrados em 9 de setembro de 2026. Você ainda pode enviar um nos cabeçalhos da chamada de API, mas o Google diz que é opcional e ignorado pelos servidores da API. Seu nível de acesso agora vem do projeto do Google Cloud que você usou para criar suas credenciais OAuth, e para consultar contas reais esse projeto precisa de pelo menos acesso Explorer (2,880 operações da API do Google Ads por dia em contas de produção). O servidor oficial removeu a verificação do token de desenvolvedor na versão 0.0.3 em 10 de setembro de 2026. No PaidSync você entra com o Google, e não há token nem chave para adicionar.
Quantas ferramentas o MCP oficial do Google Ads tem?
Três: search (executa consultas GAQL nos dados da sua conta), get_resource_metadata (descreve os campos de um tipo de recurso da API, como campaign) e list_accessible_customers (retorna os IDs de cliente que seu login alcança). Ele também oferece 4 recursos: o documento de descoberta da API, métricas, segmentos e notas de versão. Um arquivo tools_config.yaml permite ligar ou desligar ferramentas. Verificado no repositório do GitHub em 27 de setembro de 2026, na versão 0.0.4.
O MCP oficial do Google Ads pode pausar campanhas ou alterar orçamentos?
Ainda não. Ele não pode pausar nem ativar campanhas, alterar orçamentos ou lances, adicionar palavras-chave negativas, editar anúncios ou criar qualquer coisa. Um mantenedor do Google escreveu em 4 de junho de 2026: “We already have plans to add write access soon”, com cada ferramenta de escrita sendo ativada uma a uma no arquivo de configuração YAML do servidor. Nenhuma data foi dada, o mantenedor acrescentou “we won't accept PRs adding write features”, e nenhuma ferramenta de escrita havia sido lançada até 27 de setembro de 2026. Até lá, uma pessoa faz a correção na interface do Google Ads, ou você usa um servidor que escreve, como o PaidSync.
O que preciso para rodar o MCP oficial do Google Ads?
Um projeto do Google Cloud com a API do Google Ads ativada e pelo menos acesso Explorer para contas reais, Python 3.10 ou superior com pipx (ou Docker) e uma de três configurações de credenciais: o proxy OAuth do FastMCP com seu próprio ID e segredo de cliente OAuth, Application Default Credentials ou um arquivo google-ads.yaml para o cliente Python da API do Google Ads. Você o hospeda por conta própria, no seu computador ou no Google Cloud Run. O Google não oferece endpoint hospedado. Um token de desenvolvedor é opcional desde que o Google os encerrou em 9 de setembro de 2026. É uma instalação para desenvolvedores, não um fluxo de cadastro.
Quando o Google lançou o servidor MCP oficial do Google Ads?
7 de outubro de 2025. O anúncio, intitulado “Open Source Google Ads API MCP Server”, foi publicado no Google Ads Developer Blog pela equipe da API do Google Ads. O primeiro pacote, 0.0.1, chegou ao PyPI em 22 de outubro de 2025, e a versão mais recente, 0.0.4, saiu em 25 de setembro de 2026. Alguns artigos de terceiros datam o lançamento em 2026; a fonte primária diz 7 de outubro de 2025.
Os servidores comunitários de código aberto do Google Ads MCP conseguem escrever?
Os dois com mais estrelas que verificamos não conseguem. cohnen/mcp-google-ads (709 estrelas, 12 ferramentas, último push de código em 16 de outubro de 2025) e gomarble-ai/google-ads-mcp-server (145 estrelas, 3 ferramentas, último push em 5 de agosto de 2026) só executam consultas de leitura, e nenhum chama um endpoint de mutação do Google Ads. Ambos ainda param com erro quando não há token de desenvolvedor e ambos chamam a versão 19 da API do Google Ads, que não está mais na lista de versões disponíveis do Google. Em 27 de setembro de 2026 a versão mais antiga listada é a v22, e o Google diz que as requisições a uma versão encerrada falham. Leia o código-fonte de qualquer repositório comunitário antes de conectá-lo a uma conta real.
Qual é a melhor alternativa de MCP do Google Ads com acesso de escrita?
O PaidSync é nossa escolha para a maioria das equipes, e como nós o construímos, leia esta resposta como a afirmação do próprio fornecedor, com os fatos anexados: 158 ferramentas do Google Ads, 94 delas fazem alterações, entre mais de 630 ferramentas em 14 plataformas. Ele cria campanhas de Pesquisa, Performance Max, Display, Shopping e Demand Gen, e o mesmo login faz alterações na Meta e no LinkedIn. Por padrão, novas campanhas e anúncios começam pausados ou como rascunhos, e edições de orçamento rodam primeiro como prévia. Pausas, ativações e remoções ao vivo exigem um sinalizador de confirmação explícito, e uma mudança de orçamento de campanha do Google Ads maior que 50% exige um segundo. O PaidSync é grátis para 100 tarefas por mês em todas as 14 plataformas, sem cartão de crédito e sem limite de tempo. Depois disso você paga pelo uso, as tarefas que sua IA executa, não por assentos nem por uma parte do investimento em anúncios: o Pro custa $99 por mês para 1,000 tarefas, $149 para 2,500 e $199 para 6,000, ou $999 cobrados por ano para 1,000 por mês, e você pode adicionar tarefas se elas acabarem. O Team começa em $249 por mês para até 20 assentos dividindo 10,000 tarefas. Se você só precisa de relatórios e pode hospedar um servidor, o oficial é gratuito e do próprio Google, e essa é a recomendação honesta para esse caso mais restrito.
O MCP oficial do Google Ads cobre GA4, GTM ou Search Console?
Não. Ele fala apenas com a API do Google Ads. GA4, Google Tag Manager e Search Console precisam cada um de sua própria conexão. O PaidSync reúne todos em um só endpoint MCP: 26 ferramentas do GA4, incluindo criação de eventos de conversão, 39 ferramentas do Google Tag Manager que cobrem tags, acionadores, variáveis e publicação, e 6 ferramentas somente leitura do Search Console.