Google Ads MCP Server (hosted, no developer token)

Servidor MCP remoto hospedado que conecta Claude, ChatGPT, Cursor e Claude Code ao Google Ads com um único login OAuth: 14 ferramentas do Google Ads para relatórios GAQL, Keyword Planner, recomendações e alterações com aprovação, sem necessidade de instalação.

Ver em get-ryze.aiExperimente este MCPPatrocinado

Documentação

Google Ads MCP Server: execute seu Google Ads a partir do Claude ou ChatGPT

Cole um link no Claude ou ChatGPT, faça login com o Google, e sua IA poderá ler e gerenciar sua conta do Google Ads. Sem developer token, 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

01Copie seu link MCP:https://connector.get-ryze.ai/mcp
02No Claude, vá em Configurações → Conectores → Adicionar conector personalizado. Nomeie como Ryze AI, cole o link e clique em Adicionar. No ChatGPT, é Configurações → Apps → Criar app.
03Clique em Conectar, faça login com o Google e escolha seu workspace. Abra um novo chat e pergunte: “Quais campanhas desperdiçaram mais dinheiro este mês?”

Funciona no Claude, ChatGPT, Cursor e Claude Code · Conexão gratuita · Guia de configuração completo

01 — Visão geral

O que este servidor MCP do Google Ads faz

A versão resumida

Uma URL, https://connector.get-ryze.ai/mcp, funciona no Claude, ChatGPT, Claude Code, Cursor e em qualquer cliente MCP.
Faça login com o Google. Sem developer token, sem projeto no Google Cloud, sem Python, sem servidor para executar.
14 ferramentas do Google Ads: 8 de leitura (GAQL, Keyword Planner, recomendações, árvore de contas) e 6 de escrita, cada uma com aprovação.
O mesmo endpoint inclui Meta Ads, TikTok, GA4, Search Console e Shopify — mais de 150 ferramentas no total.
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ê.

google_ads · especificação do servidorOAuth2

Nome do servidor

Ryze AI (Google Ads MCP)

Endpoint

https://connector.get-ryze.ai/mcp

Transporte

MCP remoto via Streamable HTTP

Autenticação

OAuth 2.0 (login com Google, um workspace Ryze por conexão)

Hospedagem

Hospedado pela Ryze AI — nada para instalar ou executar

Ferramentas do Google Ads

14 (8 de leitura · 6 de escrita, com aprovação)

Também neste endpoint

Meta Ads, TikTok, GA4, Search Console, Shopify — mais de 150 ferramentas

Developer 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 Google Ads transforma sua conta de anúncios em um conjunto dessas ferramentas, permitindo que um assistente gere um relatório, pesquise palavras-chave ou altere um orçamento a partir de um chat, em vez da interface do Google Ads. A maioria dos servidores MCP do Google Ads no GitHub são processos Python locais que você configura com suas próprias credenciais de API; este é hospedado, então toda a configuração é uma URL e um login com o Google. A comparação mais adiante aborda quando a auto-hospedagem é a melhor opção.

/01

OAuth 2.0 gerenciado

Login no navegador com o Google, tokens renovados no servidor. Sem projeto no Cloud, sem client_secret.json, sem solicitação de developer token.

/02

Execução de consultas GAQL

runRawGaql executa qualquer relatório da Google Ads Query Language — campanhas, termos de pesquisa, ativos, histórico de alterações — até 10.000 caracteres por consulta.

/03

Pesquisa no Keyword Planner

Ideias de palavras-chave a partir de palavras-chave iniciais ou uma URL, além de volume histórico, concorrência e faixas de lance de topo de página para qualquer lista de palavras-chave.

/04

Recomendações do Google

Liste as recomendações de otimização do Google com impacto estimado e aplique ou dispense-as diretamente no chat.

/05

Escritas com aprovação

Mutações para campanhas, orçamentos, palavras-chave, negativas e públicos passam por aprovação por ferramenta. Exclusões usam uma ferramenta separada e explícita.

/06

Compatível com Manager (MCC)

Descubra todos os clientes acessíveis, mapeie um gerente para suas contas filhas e passe loginCustomerId para configurações de agência.

/07

Upload de ativos de imagem

Envie ativos de imagem diretamente para a Biblioteca de Ativos para Performance Max e anúncios responsivos de display.

/08

Seis plataformas, uma URL

O mesmo endpoint inclui conjuntos de ferramentas do Meta Ads, TikTok, GA4, Search Console e Shopify — um login em vez de seis servidores.

02 — Referência de ferramentas

As 14 ferramentas do Google Ads

Cada ferramenta aceita um customerId opcional (o ID da conta do Google Ads com 10 dígitos) e loginCustomerId (a conta de gerente quando você trabalha por meio de um MCC). Ferramentas de escrita são aprovadas e suportam validateOnly dry-runs quando o Google os oferece.

Ferramenta	Acesso	O que faz	Parâmetros principais
`getAccountSummary`	leitura	Gastos, cliques, conversões, CPA e ROAS para um intervalo de datas em uma única chamada.	customerId · period { startDate, endDate } · loginCustomerId
`getAccountHierarchy`	leitura	Árvore de gerente → subcontas para um MCC.	customerId · loginCustomerId
`listAccessibleCustomers`	leitura	Todas as contas do Google Ads que o login conectado pode acessar. Chame primeiro para encontrar IDs de clientes.	nenhum
`listConversionActions`	leitura	Ações de conversão com status, categoria e configurações de contagem.	customerId · loginCustomerId
`listRecommendations`	leitura	Recomendações de otimização do Google, incluindo as dispensadas, mediante solicitação.	customerId · dismissed · loginCustomerId
`applyRecommendation`	escrita	Aplica uma ou mais recomendações por nome de recurso.	customerId · operations[] { resourceName }
`dismissRecommendation`	escrita	Dispensa recomendações para que o Google pare de exibi-las novamente.	customerId · operations[] { resourceName }
`generateKeywordIdeas`	leitura	Ideias do Keyword Planner com volume mensal a partir de uma palavra-chave inicial, URL inicial ou ambos.	customerId · request { keywordSeed \| urlSeed \| keywordAndUrlSeed, geoTargetConstants, language, keywordPlanNetwork }
`generateKeywordHistoricalMetrics`	leitura	Médias de pesquisas mensais, concorrência e lances de topo de página baixo/alto para uma lista de palavras-chave conhecida.	customerId · request { keywords, geoTargetConstants, language, keywordPlanNetwork, historicalMetricsOptions }
`runRawGaql`	leitura	Qualquer consulta GAQL em recursos de relatórios (campaign, ad_group, keyword_view, search_term_view, geographic_view, customer…).	customerId · query (≤ 10.000 caracteres) · loginCustomerId
`runRawMutate`	escrita	Cria ou atualiza campanhas, orçamentos, grupos de anúncios, critérios, anúncios e ativos. Suporta dry-runs validateOnly.	customerId · mutateOperations[] · validateOnly
`runRawMutateDelete`	escrita	Remove recursos. Irreversível no Google Ads, por isso só é executada em uma lista explícita, aprovada item por item.	customerId · mutateOperations[] { …Operation: { remove } } · validateOnly
`runRawCustomAudienceMutate`	escrita	Cria ou atualiza públicos personalizados (membros por palavra-chave, URL, app ou categoria de local) para segmentação e sinais do PMax.	customerId · operations[] · validateOnly
`uploadImageAsset`	escrita	Envia uma imagem de uma URL como ativo IMAGE e retorna o nome do recurso.	customerId · imageUrl · assetName

O mesmo endpoint expõe os conjuntos de ferramentas do Meta Ads, TikTok, GA4, Search Console e Shopify. A lista multiplataforma está na referência de APIs de publicidade e ferramentas MCP; o lado do Meta tem sua própria página em Meta Ads MCP.

03 — Pré-requisitos

O que você precisa antes de começar

Você precisa

Um login do Google com acesso Padrão ou Administrador à conta do Google Ads (ou à conta de gerente acima dela).
Uma conta gratuita da Ryze AI — criada durante a etapa OAuth se você 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

Um developer token da API do Google Ads — o servidor hospedado traz seu próprio acesso à API. (O que envolve a rota do token.)
Um projeto no Google Cloud, tela de consentimento OAuth ou client_secret.json.
Python, Node, um ambiente virtual, um 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 Google, escolha seu workspace Ryze e clique em Permitir. Uma conexão mapeia para um workspace, então agências com vários workspaces de clientes reconectam por workspace. Capturas de tela da rota do Claude estão em como conectar o Claude ao Google e Meta Ads.

Claude (web e desktop)

01Em claude.ai, clique no seu avatar (canto inferior esquerdo) → Configurações.
02Abra a aba Conectores e clique em Personalizar e depois no + ao lado de Conectores.
03Nome: Ryze AI. URL do servidor MCP remoto: https://connector.get-ryze.ai/mcp. Clique em Adicionar.
04Clique em Conectar no novo conector, faça login com o Google, escolha seu workspace e clique em Permitir que o Claude conecte.
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 aplicativo de 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

01 Configurações → Apps. Em Configurações avançadas, ative o modo Desenvolvedor.
02Clique em Criar app. Nome: Ryze AI. URL do servidor MCP: https://connector.get-ryze.ai/mcp — escolha URL do servidor, não Tunnel.
03Autenticação: OAuth. Marque o reconhecimento e clique em Criar.
04Na página de autorização, escolha Entrar com Ryze AI, selecione seu workspace e clique em Permitir.
05Inicie um novo chat: “Puxe os gastos do Google Ads dos últimos 7 dias e detalhe 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. Mais em o guia de configuração do Google Ads no Claude Desktop.

05 — Uso

O que perguntar depois de conectar

Relatórios

>“Puxe os gastos do Google Ads dos últimos 7 dias e detalhe por campanha.”
>“Compare o CPA desta semana com o da semana passada por campanha. O que mudou?”
>“Monte um relatório semanal do Google Ads e sinalize qualquer coisa em que eu deva agir.”

Gastos desperdiçados

>“Quais campanhas desperdiçaram mais gastos nos últimos 30 dias?”
>“Liste termos de pesquisa com custo acima de US$ 100 e zero conversões este mês e adicione-os como negativos.”
>“Mostre grupos de anúncios com CTR abaixo de 1% e gastos acima de US$ 50 nos últimos 14 dias.”

Pesquisa de palavras-chave

>“Gere ideias de palavras-chave para 'ai ad management' nos EUA e mostre o volume mensal.”
>“Obtenha métricas históricas para estas 20 palavras-chave: pesquisas médias, concorrência, lance de topo de página.”
>“Quais das minhas campanhas de Pesquisa não cobrem nenhuma das 50 principais ideias para 'google ads automation'?”

Alterações (com aprovação)

>“Aumente o orçamento da campanha com maior ROAS em 20%, valide primeiro.”
>“Aplique as recomendações de 'adicionar palavras-chave negativas' do Google, mas mostre a lista antes.”
>“Pause todos os grupos de anúncios com CTR abaixo de 1% e gastos acima de US$ 50 este mês.”

Fluxos de auditoria prontos: a auditoria completa do Google Ads com Claude MCP, análise de concorrentes via MCP, receitas de automação e o guia do comprador de mídia para Claude.

06 — Exemplos de GAQL

Consultas que você pode colar no chat

Raramente você precisará escrever GAQL — o assistente faz isso. Quando quiser controle exato, cole uma consulta e o servidor a executa por meio de runRawGaql. Três que aparecem diariamente:

Desempenho da campanha, últimos 30 dias

SELECT
  campaign.name,
  campaign.status,
  metrics.cost_micros,
  metrics.clicks,
  metrics.conversions,
  metrics.conversions_value
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
  AND campaign.status = 'ENABLED'
ORDER BY metrics.cost_micros DESC
LIMIT 25

Os custos retornam em micros — divida cost_micros por 1.000.000.

Termos de pesquisa com gastos de US$ 100+ e zero conversões

SELECT
  search_term_view.search_term,
  campaign.name,
  ad_group.name,
  metrics.cost_micros,
  metrics.clicks,
  metrics.conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.conversions = 0
  AND metrics.cost_micros > 100000000
ORDER BY metrics.cost_micros DESC

100000000 micros = US$ 100. Alimente o resultado no runRawMutate como palavras-chave negativas.

Detalhamento por dispositivo, últimos 7 dias

SELECT
  segments.device,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM campaign
WHERE segments.date DURING LAST_7_DAYS
ORDER BY metrics.cost_micros DESC

Segmentar qualquer relatório de campanha por segments.device, segments.date ou segments.ad_network_type.

07 — Comparação

Hospedado vs oficial vs auto-hospedado

O que você opera	Servidor hospedado Ryze AI	MCP oficial do Google	Código aberto (ex.: GoMarble)
Runtime	Nenhum — HTTP remoto	Processo local que você executa	Ambiente virtual Python local que você executa
Credenciais que você gerencia	Apenas login do Google	Token de desenvolvedor + app OAuth do Cloud	Token de desenvolvedor + client_secret.json + .env
Cota da API Google Ads	Gerenciada pela Ryze	Seu token: acesso Básico 15.000 operações/dia	Seu token: acesso Básico 15.000 operações/dia
Quando a versão da API muda	A Ryze atualiza o servidor	Você atualiza o servidor	Você espera uma atualização do repositório
Plataformas	Google Ads + Meta, TikTok, GA4, Search Console, Shopify	Apenas Google Ads	Apenas Google Ads
Controles de aprovação de escrita	Por ferramenta, ativados por padrão	O que seus escopos OAuth permitirem	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: Configuração do MCP oficial do Google, servidores MCP locais vs remotos, API REST vs MCP e os melhores servidores MCP para Google Ads ranqueados.

08 — Segurança e permissões

Seguro por padrão

Somente OAuth 2.0

Você faz login na página do Google. Sua senha nunca toca a Ryze, e os tokens são 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 obrigatória

Ferramentas de leitura são automáticas. No Claude, abra Configurações → Conectores → Ryze AI e mantenha toda ferramenta de escrita e exclusão em 'Needs approval' — o padrão recomendado para contas ativas.

Exclusões são separadas e explícitas

Remoções no Google Ads não podem ser desfeitas, então runRawMutateDelete só executa em uma lista aprovada item por item. Pausar via runRawMutate é o caminho reversível.

Revogue a qualquer momento

Remova o acesso nas permissões de terceiros da sua conta Google ou em Configurações do Workspace → Integrações na Ryze.

09 — Cotas e limites

O que saber antes de uma sessão pesada

Token de desenvolvedor e cota diária	Não é sua responsabilidade gerenciar — o servidor hospedado roda no acesso à API Google Ads da Ryze AI. Servidores auto-hospedados com token de acesso Básico recebem 15.000 operações de API por dia (cota publicada pelo Google, setembro de 2026).
Tamanho da consulta GAQL	Até 10.000 caracteres por chamada runRawGaql.
Keyword Planner	O Google limita métodos de planejamento a cerca de 1 requisição por segundo por ID de cliente, então buscas em massa de palavras-chave rodam sequencialmente.
Histórico de alterações	change_event retém 30 dias. Use um intervalo explícito de change_date_time ou LAST_14_DAYS.
Campos monetários	cost_micros, average_cpc, amount_micros e lances são micros: divida por 1.000.000. A moeda é customer.currency_code.
Operações de escrita	Mutações aceitam validateOnly para testes. Atualizações precisam de um update_mask listando cada campo alterado. Remoções passam apenas por runRawMutateDelete.
Mídia	Imagens são enviadas a partir de uma URL via uploadImageAsset (1.91:1, 1:1 e 4:5 mapeiam para diferentes espaços do PMax). Ativos de vídeo referenciam um ID do YouTube; o servidor não envia arquivos de vídeo.
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 exigem Claude Pro, Team ou Max. ChatGPT exige Plus, Pro ou Business com modo Desenvolvedor ativado.
"customerId is required"	Nenhuma conta escolhida ainda.	Peça primeiro as contas acessíveis (listAccessibleCustomers), depois nomeie a conta ou passe o ID dela.
UNRECOGNIZED_FIELD em uma consulta GAQL	O campo pertence a outro recurso ou versão da API.	Troque de recurso — ex.: performance_label existe apenas em ad_group_ad_asset_view — ou remova o campo.
"start date is too old" no histórico de alterações	change_event mantém 30 dias e LAST_30_DAYS resolve logo fora disso.	Use um intervalo explícito de change_event.change_date_time ou DURING LAST_14_DAYS.
Custos parecem um milhão de vezes maiores	Métricas monetárias são micros.	Divida cost_micros, average_cpc e amount_micros por 1.000.000. A moeda vem de customer.currency_code.
Uma ação de escrita 'não fez nada'	Está aguardando sua aprovação.	Aprove a chamada de ferramenta no chat, ou revise a configuração da ferramenta em Configurações → Conectores → Ryze AI.
Dados da conta de cliente errada	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.
PERMISSION_DENIED ou conta não encontrada	O login do Google não tem acesso, ou o ID do gerente está ausente.	Entre com um usuário que tenha acesso Padrão ou Administrador; passe loginCustomerId para contas filhas do MCC.

Ainda travado? Envie um e-mail para support@get-ryze.ai. Agências lidando com muitas contas: configuração MCP para múltiplas contas de anúncios. Erros do lado do Meta: solução de problemas da conexão Meta Ads MCP.

11 — FAQ

Perguntas sobre o servidor MCP do Google Ads

O que é o servidor MCP do Google Ads?

É um servidor MCP (Model Context Protocol) que expõe uma conta do Google Ads como ferramentas que um assistente de IA pode chamar. O servidor MCP do Google Ads da Ryze AI é hospedado e remoto: você adiciona uma URL ao Claude, ChatGPT, Cursor ou Claude Code, faz login com o Google via OAuth, e o assistente pode executar relatórios GAQL, pesquisa no Keyword Planner, recomendações do Google e alterações com aprovação.

Qual é a URL do servidor MCP do Google Ads?

A URL do servidor é https://connector.get-ryze.ai/mcp. É um servidor MCP remoto via Streamable HTTP com OAuth 2.0. O mesmo endpoint atende aos conjuntos de ferramentas do Google Ads, Meta Ads, TikTok, GA4, Search Console e Shopify, então um único conector cobre toda a pilha de anúncios. Cada conexão é autorizada contra um workspace da Ryze.

Preciso de um token de desenvolvedor da API Google Ads para usar este servidor MCP?

Não. O servidor hospedado roda no acesso próprio da Ryze AI à API Google Ads. Você faz login com uma conta Google que tenha acesso Padrão ou Administrador à conta do Google Ads e pronto. Servidores auto-hospedados, como o MCP oficial do Google ou o servidor de código aberto GoMarble, exigem seu próprio token de desenvolvedor, um app OAuth do Google Cloud e um runtime Python local.

Quais clientes MCP funcionam com o servidor MCP do Google Ads?

Qualquer cliente que suporte MCP remoto via 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 do Google Ads o servidor expõe?

14 ferramentas do Google Ads: 8 ferramentas de leitura (resumo da conta, hierarquia de contas, clientes acessíveis, ações de conversão, recomendações, ideias de palavras-chave, métricas históricas de palavras-chave e GAQL bruto) e 6 ferramentas de escrita (aplicar e dispensar recomendações, mutação bruta, exclusão bruta, públicos personalizados e envio de ativos de imagem). O endpoint completo carrega mais de 150 ferramentas em seis plataformas.

O servidor MCP pode alterar minhas campanhas, ou apenas ler dados?

Ambos. Ferramentas de leitura funcionam assim que o OAuth é concluído. Ferramentas de escrita — runRawMutate, applyRecommendation, runRawCustomAudienceMutate e as demais — exigem aprovação: no Claude, você define cada ferramenta como 'Needs approval' em Configurações → Conectores → Ryze AI. Exclusões ficam em uma ferramenta separada, runRawMutateDelete, porque remoções no Google Ads são irreversíveis; ela só executa em uma lista explícita item por item.

Como executo uma consulta GAQL pelo servidor MCP?

Pergunte em linguagem natural ou cole GAQL diretamente. A ferramenta runRawGaql aceita qualquer consulta de até 10.000 caracteres contra recursos de relatório como campaign, ad_group, keyword_view, search_term_view e geographic_view. Campos monetários retornam em micros (divida por 1.000.000), e consultas de histórico de alterações precisam de um intervalo de datas explícito dentro dos últimos 30 dias.

O servidor MCP do Google Ads suporta contas de gerente (MCC)?

Sim. listAccessibleCustomers retorna todos os IDs de clientes que o login pode ver, getAccountHierarchy mapeia uma conta de gerente para todas as contas filhas, e toda ferramenta aceita loginCustomerId para o gerente junto com customerId para a conta filha que você quer consultar ou alterar.

Posso fazer pesquisa de palavras-chave com o servidor MCP do Google Ads?

Sim. generateKeywordIdeas aceita uma semente de palavra-chave, uma semente de URL ou ambas, além de alvos geográficos, idioma e rede, e retorna ideias do Keyword Planner com volume de pesquisa. generateKeywordHistoricalMetrics retorna médias mensais de pesquisas, concorrência e faixas de lance de topo de página para uma lista de palavras-chave que você já tem. O Google limita métodos do Keyword Planner a cerca de uma requisição por segundo por ID de cliente.

Quanto custa o servidor MCP do Google Ads?

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 MCP do Google Ads é seguro?

O acesso é somente OAuth 2.0, então sua senha do Google nunca toca a Ryze. Cada conexão é limitada a um workspace da Ryze, ferramentas de escrita e exclusão exigem aprovação por padrão, e você pode revogar o acesso a qualquer momento nas permissões da sua conta Google 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 do Google Ads depois que 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á no plano gratuito do Claude — conectores personalizados exigem Pro, Team ou Max. Por fim, confirme que o conector mostra Connected em Configurações → Conectores.

Como isso é diferente do servidor MCP oficial do Google Ads?

O MCP oficial do Google é feito para desenvolvedores: você fornece um token de desenvolvedor da API Google Ads, configura um app OAuth do Google Cloud, executa o servidor localmente e obtém apenas Google Ads. O servidor da Ryze AI é hospedado, não exige credenciais além do login do Google, adiciona Meta, TikTok, GA4, Search Console e Shopify no mesmo endpoint, e inclui controles de aprovação para toda escrita.

Posso usar o servidor MCP com várias contas ou clientes do Google Ads?

Sim. listAccessibleCustomers lista todas as contas que o login pode alcançar, e você passa customerId em cada chamada para escolher uma. Agências que trabalham por uma conta de gerente passam loginCustomerId para o MCC. Uma conexão mapeia para um workspace da Ryze, então ao trocar de workspace, reconecte ou inicie um novo chat para que o novo contexto se aplique.

12 — Compatibilidade

Funciona em todo cliente 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

Servidor MCP do Meta Ads
Automatizando Google Ads com Claude MCP
Conecte Claude ao Google e Meta Ads (capturas de tela)
Melhor MCP para Google Ads — 7 servidores ranqueados
Como conectar Google Ads ao Claude MCP
MCP do Google Keyword Planner para Claude
Ferramentas MCP para relatórios de campanhas de anúncios
Conectar IA à sua conta de anúncios pode te banir? Um login OAuth · 14 ferramentas do Google Ads · Ao vivo em ~60 segundos

Adicione o Google Ads à sua IA hoje.

Grátis para conectar. 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 para você, 24/7.

Mais de 2.000 clientes · Mais de 700 agências · Mais de US$ 500 milhões gerenciados · Sem token de desenvolvedor · Sem servidor para executar