Conecte o Google Ads ao Claude com o MCP.

MCP · Anúncios do Google para Claude

Perguntar Claude sobre sua conta do Google Ads, em inglês simples

Conecte o Claude, o Claude Code, o Cursor ou qualquer cliente MCP ao Query Streams uma única vez. O Claude lê a estrutura da sua conta do Google Ads, escreve o SQL, executa-o em modo somente leitura por meio do Agente que já possui seus dados e retorna as linhas como resposta. Nenhuma senha do banco de dados chega à IA. Leva cerca de dez minutos e o plano gratuito cobre esse processo.

Cerca de 10 minutos Claude, ChatGPT, Cursor + 11 outros clientes As credenciais permanecem com você. Somente leitura, sempre

O resultado final será o que você obterá.

Um Claude que pode responder a perguntas sobre sua conta do Google Ads com consultas SQL em tempo real e somente leitura, explicar o significado das colunas e dar seguimento quando você solicitar mais informações — sem nunca precisar acessar o banco de dados e sem alterar o firewall: o Agente, já presente em sua rede, executa o SQL e envia apenas as linhas de volta. Depois que o Agente estiver instalado, conectar o Claude leva cerca de 90 segundos, caso você se sinta confortável com a tela de configurações. Assim:

Claude ChatGPT Cursor Código Claude VS Code Windsurf Gemini CLI JetBrains Códice+5 maisSomente leitura

O que há em google_ads.campaign_performance Na minha conta do Google Ads? Mostre-me algumas linhas e explique o que cada coluna significa.

qs_get_table_schema qs_executar_consulta inteligência_de_esquema

Primeiro, examinei a estrutura da tabela e, em seguida, executei uma consulta somente leitura por meio do seu agente. Aqui estão três das linhas de google_ads.campaign_performance:

nome_da_campanha	impressões	cliques
1042	Comerciantes do Northwind	Seattle
1057	Equipamentos Alpinos	Denver
1063	Alimentos do Porto	Halifax

nome_da_campanha identifica a linha. impressões e cliques estão descritos no seu modelo de Inteligência Semântica, então posso filtrá-los por nome.

Quais três cliques Quais empresas geraram a maior receita neste trimestre? Como isso se compara ao trimestre anterior? Há algo que eu deva investigar?

qs_get_relacionamentos qs_executar_consulta qs_executar_consulta

Eu entrei google_ads.campaign_performance para pedidos Com base na relação encontrada pela Inteligência Semântica, foi realizada uma agregação para cada trimestre. Ambas as consultas eram somente leitura e retornaram 3 linhas cada:

cliques	Este trimestre	Último trimestre	Mudar
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	-26%

Denver A história é a seguinte: a receita aumentou 38% com praticamente o mesmo número de clientes, portanto o valor médio do pedido também aumentou. Halifax Caiu 26%, e essa queda se deve a dois clientes que faziam pedidos todos os meses no trimestre passado e não fizeram nenhum neste trimestre — vale a pena ligar antes do fim do mês. Em Seattle está estável. Quer os nomes das duas contas de Halifax?

Somente SELECIONAR, verificado pelo Agente Acessei a guia Atividade do MCP. 9 linhas retornadas em 3 consultas Mesma conexão em 14 clientes MCP

Prefere não instalar um cliente de IA? No plano de negócios, Nova é o assistente integrado ao próprio Query Streams. Ele possui todas as ferramentas que o Claude tem aqui, além de outras que o Claude não tem: ele elabora e valida o SQL com base no seu modelo de Inteligência Semântica, transforma a resposta em um gráfico e salva o resultado como uma consulta que sua equipe pode executar no Excel, no Google Sheets ou na API REST — sem chave, sem conector, nada para instalar. Use o MCP quando sua equipe já utiliza o Claude, o Cursor ou o ChatGPT; use o Nova quando você quiser as respostas dentro do Portal.

O Google Ads armazena seus dados por trás de sua API. Claude, por outro lado, reside em um navegador ou terminal e não sabe nada sobre isso. A solução usual é colar um esquema no chat e torcer para que funcione, ou fornecer sua senha do Google Ads para um servidor MCP de código aberto. O Query Streams funciona de forma diferente: o Agente que já está associado à sua conta do Google Ads executa o SQL que Claude escreve, em modo somente leitura, e o servidor MCP verifica, entre as consultas, quem está fazendo a solicitação, o que pode ser feito e com que frequência. Claude obtém as respostas. Ele nunca obtém as credenciais.

O que você vai precisar

Uma conta do Query Streams

O MCP está disponível em todos os planos, inclusive no plano gratuito. O plano gratuito permite uma chave ou um aplicativo conectado, que é tudo o que este guia precisa. Cadastre-se em my.querystreams.com.

O Google Ads foi conectado através do Agente.

O agente é instalado em qualquer computador que esteja sempre ligado, com a conexão do Google Ads adicionada em Agentes de Dados.

MCP ativado para você

Criadores, proprietários e administradores têm acesso desde o início. Todos os outros precisam de um administrador para ativar o recurso. MCP alterne ao lado do nome deles abaixo Conta → Controle de acessoAté então, a página do MCP exibe a mensagem "O MCP está desativado para sua conta".

Um cliente de IA

O Claude na web, o Claude Desktop ou os aplicativos móveis do Claude se conectam sem necessidade de chave. O Claude Code, o Cursor, o ChatGPT e cerca de outras dez ferramentas também funcionam; o Portal possui uma configuração pronta para cada uma delas.

Configure em quatro etapas

1. Abra o MCP no portal.

   Faça login em my.querystreams.com e aberto Transmissões → Ao vivo → MCPA página possui quatro abas: Conectar, Aplicativos Conectados, Minhas chaves e, para administradores, AtividadeVerifique o Minhas chaves Enquanto estiver aqui, o painel lateral lista seu conector do Google Ads e indica se o Semantic Intelligence foi executado nele. A cobertura completa é o que permite ao Claude escrever o SQL correto do Google Ads na primeira tentativa.

   MCP aberto

   Está vendo a mensagem “O MCP está desativado para sua conta”? Sua organização possui MCP, mas seu usuário está desativado. Um administrador o ativa com o MCP alterne ao lado do seu nome abaixo. Conta → Controle de acessoCriadores, proprietários e administradores estão presentes desde o início.

2. Escolha como você se conectará.

   Existem duas entradas, e ambas terminam no mesmo lugar:

   Aplicativos de bate-papo · sem chave

   claude.ai, Claude Desktop, ChatGPT

   Em Claude, Query Streams está no Diretório de Conectores AntrópicosNavegue pelos conectores e clique. ConectarEm outros lugares, você cola um endereço no aplicativo, https://mcp.querystreams.com/mcpe conecte-se por meio de um chat. Uma página de Fluxos de Consulta será aberta, você seleciona a organização e as permissões e clica em Aprovar conexãoNada para copiar, nada para manter em segredo. A conexão aparece em Aplicativos Conectados e pode ser revogada lá.

   Ferramentas de desenvolvedor · uma chave

   Claude Code, Cursor, VS Code e amigos

   Sobre Minhas chaves clique Gerar chaveDê uma olhada. Nome da chave como “Código Claude no meu laptop”, mantenha Ler e Executar Com a opção marcada, escolha uma Validade (Nunca, 30 dias, 90 dias ou 1 ano) e clique Gerar chaveCopie-o e então Continue a instalação: o Conectar A aba mostra o trecho de código exato para sua ferramenta com a chave já preenchida.

   Ambas as formas utilizam as mesmas três permissões, que você escolhe na tela de consentimento ou na chave:

   Ler

   Liste conectores, navegue por tabelas e colunas, leia suas consultas salvas e regras de alerta. Nunca retorna dados de linha.

   Executar

   Execute consultas SQL somente leitura e consultas salvas por meio do seu Agente e retorne as linhas. Sem isso, Claude pode descrever seus dados, mas não responder com base neles.

   Analisar

   Tabelas de perfil, descoberta de relacionamentos e agendamento de uma execução de Inteligência Semântica. Isso consome créditos de IA e dados do Nova, portanto, a tela de consentimento nunca é marcada previamente.

   Perdeu a chave? Aberto Minhas chavesO ícone do olho mostra isso novamente e Copiar chave completa copia-o. Revogue-o lá se um laptop desaparecer; todos os clientes que o utilizam falham na próxima chamada, em cerca de cinco minutos.

3. Conecte-se com Claude

   Escolha a receita do Claude que você usa. O endereço do servidor é o mesmo em todos os lugares: https://mcp.querystreams.com/mcp.

   Claude na web, Claude para desktop e dispositivos móveis. sem chave

   1. Aberto Configurações → Conectores e clique em Navegue pelos conectores. O Query Streams está listado no Diretório de Conectores Antrópicos: encontrar Fluxos de consulta e clique em Conectar(Ou abra a lista de diretórios diretamente e clique) Conectar lá.)
   2. Se sua organização oculta conectores de diretório, clique Adicionar conector personalizado Em vez disso, dê um nome a ele. Fluxos de consulta, colar https://mcp.querystreams.com/mcpDeixe os campos OAuth vazios e clique em AdicionarEm seguida, em qualquer bate-papo, clique + → Navegue pelos conectores → Fluxos de consulta → Conectar.
   3. Uma aba "Fluxos de Consulta" será aberta. Faça login, se solicitado, selecione a organização e revise. Ler e Executar, opcionalmente Limitar a conectores específicose clique Aprovar conexão.
   4. De volta ao Claude, você vê “Conectado aos Fluxos de Consulta”. Na primeira vez que o Claude usa uma ferramenta, ele pergunta: escolha Permitir sempre.

   Se você adicionar manualmente no Claude Desktop, use Configurações → Conectores → Adicionar, não o chat interno Adicionar ao mercado opção, que espera um repositório git. Os conectores sincronizam com sua conta Claude, então os aplicativos móveis e o Desktop os reconhecem automaticamente. Os nomes dos menus são da Anthropic e podem ser alterados.

   Código Claude chave

   Um único comando, com a sua chave de "Minhas Chaves":

   terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_COLE_SUA_CHAVE_AQUI"

   Isso descreve o projeto atual. .mcp.json. Adicionar --escopo usuário Para ter fluxos de consulta em todos os projetos. Execute /mcp dentro do Código Claude para ver se está conectado.

   Cursor chave

   Aberto Configurações do cursor → MCP → Adicionar novo servidor MCPou editar .cursor/mcp.json na raiz do seu espaço de trabalho:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_COLE_SUA_CHAVE_AQUI" } } } }

   Reinicie o Cursor ou execute MCP: Reiniciar servidores; um fluxos de consulta O ícone aparece na barra de status do MCP.

   Usar outra coisa? O Conectar guia Possui receitas prontas para colar para ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev e JetBrains AI, além de um Colar e mesclar ferramenta que solta o fluxos de consulta entrada em um arquivo de configuração que você já possui. Qualquer cliente que se comunique via MCP sobre HTTP funciona: servidor https://mcp.querystreams.com/mcp, cabeçalho Chave X-MCP (um Autorização: Portador O cabeçalho com a mesma chave também funciona).

4. Faça sua primeira pergunta

   Comece com algo cuja resposta você já saiba, para que possa ver Claude escolher a ferramenta certa. Três opções que funcionam bem com sua conta do Google Ads:

   “Que dados tenho na minha conta do Google Ads?”

   Claude lista as tabelas que consegue visualizar, informa quais possuem Inteligência Semântica e pergunta o que você deseja analisar.

   “Mostre-me dez linhas da tabela google_ads.campaign_performance e explique cada coluna.”

   Claude primeiro lê a estrutura da tabela (Ler), depois executa um comando SELECT através do seu Agente (Executar) e descreve o que significam as impressões e os cliques.

   “Quantas linhas por clique tem a tabela google_ads.campaign_performance? Qual tabela de cliques tem o maior número?”

   Claude escreve o GROUP BY no dialeto do Google Ads, executa-o e responde em uma frase com uma pequena tabela. Continue a conversa no mesmo chat; isso mantém o contexto.

   Para confirmar a fiação, pergunte “Quais conectores de fluxos de consulta eu tenho?”Claude liga qs_list_connectorse em Minhas chaves a chave Último uso A hora é atualizada em poucos segundos. Um aplicativo conectado aparece abaixo. Aplicativos Conectados com a hora em que foi conectado e a última vez que foi usado.

O que Claude pode fazer quando estiver conectado

Claude vê dezenove pequenas ferramentas. Você nunca as nomeia; Claude escolhe a certa para a sua pergunta. Em outras palavras:

Por que a Inteligência Semântica é importante aqui?

Cada resposta que Claude recebe é etiquetada com a origem da estrutura, e Claude ajusta o grau de confiança que deposita no que vê.

Se um banco de dados for importante, execute a Inteligência Semântica nele uma vez a partir de Nova → Inteligência. O Minhas chaves A aba mostra um painel de cobertura para cada conector. Como funciona a Inteligência Semântica.

O que os planos permitem

O MCP está incluído em todos os planos, inclusive no plano gratuito, sem custo adicional. O que cada plano define é a quantidade de chaves ou aplicativos conectados que você pode armazenar e quantas chamadas Claude pode fazer por minuto:

A connected app counts as a key. On top of the per-minute figure, any one key may run at most 10 queries a minute. A query returns up to 1,000 rows and runs for up to 60 seconds unless Claude asks for more, to a ceiling of 50,000 rows and five minutes. The rows Claude receives count against your Data Realm allowance, the same pool your Excel and Sheets queries use, and MCP is measured the same way as your spreadsheet queries. Semantic Intelligence runs started from Claude spend Nova AI credits, exactly as they do from the Portal. Consulte a página de preços. pelas verbas.

Mantendo-o seguro

Boas próximas jogadas

• Salve as consultas que você considera canônicas. No Construtor de Consultas, Claude prioriza as consultas salvas, portanto, "clientes ativos" significa o que sua equipe define.
• Use um projeto Claude Com os Fluxos de Consulta anexados, insira suas regras personalizadas nas instruções: qual banco de dados do Google Ads usar por padrão e quais consultas salvas são as definições oficiais.
• Conceda a função de Analisar quando desejar respostas mais aprofundadas. Analisar o perfil de uma coluna antes de filtrá-la é a diferença entre adivinhar um código de status e usar o correto. Isso consome créditos de IA da Nova, portanto, ficará desativado até que você o desative.
• Peça um gráfico. O claude.ai gera gráficos a partir das linhas que Claude recebe de volta.

Quando algo não funciona

Perguntas que as pessoas fazem

Guias relacionados

• Conecte o Stripe ao Claude com o MCP.
• Conecte o HubSpot ao Claude com o MCP.
• Conecte o Shopify ao Claude com o MCP.
• Conecte o Google Analytics 4 ao Claude com o MCP.
• Conectar fluxos de consulta ao Claude via MCP: configuração, permissões e solução de problemas
• Todos os guias MCP