Como conectar o Google Search Console ao Claude: guia de configuração

Conecte o Google Search Console ao Claude com um conector MCP remoto. Pré-requisitos, passos na web e no Claude Code, uma primeira auditoria e correção de erros comuns.

TL;DR

Para conectar o Google Search Console ao Claude, adicione um servidor MCP remoto, como o GSC Magic, como conector personalizado (Customize, depois Connectors), entre com a conta do Google que tem acesso à sua propriedade e peça ao Claude que liste os seus sites. O Claude Code usa um único comando no terminal. Menus e limites de plano variam conforme a conta.

Como conectar o Google Search Console ao Claude?

Você conecta o Google Search Console ao Claude adicionando um servidor MCP (Model Context Protocol) remoto como conector personalizado, entrando com a conta do Google que enxerga a sua propriedade e ativando o conector em uma conversa. A partir daí, o Claude chama as ferramentas do servidor para buscar cliques, impressões, consultas e dados de indexação, em vez de chutar.

CaminhoIdeal paraO que você precisaPrincipal contrapartida
Conector personalizado no Claude (web ou desktop)A maioria dos donos de site e consultoresUm plano que permita conectores personalizados, uma URL de MCP remoto e um login do GoogleMenus e limites variam conforme o plano e o workspace
Claude Code (terminal)SEO dentro de um fluxo de desenvolvimentoClaude Code instalado e a mesma URL de MCPSó funciona na linha de comando
Upload de uma exportação em CSVPerguntas pontuais, sem conector disponívelUma exportação do Search ConsoleRetrato estático, sem atualização
Script próprio na API do Search ConsoleData warehouses e automações sob medidaUm projeto no Google Cloud, OAuth e códigoVocê constrói e mantém tudo

O restante deste guia cobre em detalhe os dois primeiros caminhos. Para o caminho da API, veja o guia da API do Search Console.

O que o Claude consegue fazer com os dados do Search Console depois de conectado?

Um Claude conectado responde a perguntas sobre a sua própria propriedade do Search Console: quais páginas perderam cliques, quais consultas ficam logo abaixo dos primeiros resultados, quais URLs têm problemas de indexação. Sem conexão, ele explica conceitos de SEO, mas não enxerga os seus relatórios privados de desempenho.

Perguntas que funcionam bem: quais páginas mais perderam cliques nos últimos 28 dias completos, quais consultas com muitas impressões ficam entre as posições 4 e 20 com CTR fraco, se uma queda ocorre só no celular e quais URLs pedem uma verificação de indexação.

O Google Search Console mede o que acontece na Pesquisa Google: impressões, cliques, taxa de cliques (CTR) e posição média. Ele não mostra o que os visitantes fizeram depois do clique. Para sessões e conversões, você precisa do Google Analytics 4; para o Bing, do Bing Webmaster Tools. As próprias páginas do GSC Magic descrevem um único conector que cobre as três fontes; antes de compará-las, veja por que os cliques do GSC e as sessões do GA4 diferem.

O que você precisa antes de começar?

Você precisa de uma conta do Google com acesso a pelo menos uma propriedade verificada do Search Console, de uma conta do Claude em que conectores personalizados sejam permitidos e da URL de um servidor MCP remoto cujo login você consiga concluir. Sem os três, a configuração falha ou devolve uma lista de propriedades vazia.

  1. Uma propriedade do Search Console. Qualquer propriedade que você consiga abrir no Search Console serve, seja você proprietário ou um usuário com permissões menores. O que o Claude pode ler é limitado ao que aquela conta do Google pode ler. O Google descreve os papéis na página sobre proprietários, usuários e permissões.
  2. Um plano do Claude que permita conectores personalizados. O guia de conectores personalizados da Anthropic descreve conectores MCP remotos personalizados nos planos Free, Pro, Max, Team e Enterprise. Versões anteriores desse guia limitavam as contas Free a um conector personalizado, então confira o texto atual. No Team e no Enterprise, um Owner adiciona primeiro o conector para a organização.
  3. Um endpoint MCP remoto acessível pela internet. O guia da Anthropic diz que os conectores personalizados se conectam a partir da nuvem da Anthropic, e não do seu dispositivo; por isso, um servidor em localhost não funciona como conector na web. O endpoint do GSC Magic é https://mcp.gscmagic.com/mcp.

Sobre o acesso ao GSC Magic. As páginas do GSC Magic descrevem um plano gratuito limitado a 1 site e 200 requisições por mês (10 por dia), um plano Pro para até 10 sites e um teste de 7 dias do Pro para contas novas. Crie uma conta gratuita antes: o endpoint autentica pela sua conta do GSC Magic, então conecte o Google e importe pelo menos uma propriedade antes de adicionar o conector. A versão resumida destes passos está na página de integração com o Claude.

Como adicionar o GSC Magic como conector personalizado no Claude na web ou no desktop?

Abra Customize, depois Connectors, adicione um conector personalizado, dê um nome a ele, cole https://mcp.gscmagic.com/mcp e conclua o login do Google. Em outubro de 2026, esse é o caminho descrito no guia da Anthropic, mas a Anthropic costuma renomear menus, então trate os nomes abaixo como aproximados.

Claude Pro ou Max (contas individuais):

  1. Abra o Claude e vá em Customize, depois Connectors.
  2. Escolha Add e depois Add custom connector.
  3. Informe o nome GSC Magic e a URL https://mcp.gscmagic.com/mcp.
  4. Revise as configurações de autenticação que o Claude detectar e continue. Num servidor OAuth, você será levado a uma página de login.
  5. Entre com a conta do Google que tem acesso à sua propriedade do Search Console. Leia as permissões solicitadas e aprove apenas o que você entende.
  6. Abra uma conversa nova, confira se o conector GSC Magic está ativado nos controles de conectores e pergunte: “Liste as propriedades do Search Console às quais você tem acesso.”

Claude Team ou Enterprise:

  1. Um Owner da organização abre Organization settings, depois Connectors, e adiciona o conector personalizado (Add, depois Custom, depois Web) com a mesma URL.
  2. Em seguida, cada membro abre Customize, depois Connectors, encontra o conector e escolhe Connect para entrar com a própria conta do Google.
  3. Os administradores podem definir as ferramentas de um conector como Always allow, Needs approval ou Blocked. Se você não vê o conector, uma política pode estar escondendo-o.

Nunca cole uma senha do Google, um segredo de API ou um token em uma mensagem comum do chat.

Como conectar o Search Console ao Claude Code?

Execute um comando no terminal e depois autorize de dentro do Claude Code. A documentação do Claude Code recomenda o transporte HTTP para servidores remotos. O comando registra o servidor, mas não confere credenciais.

claude mcp add --transport http gsc-magic https://mcp.gscmagic.com/mcp

Depois, inicie o Claude Code e digite /mcp. Um servidor que ainda precisa de login aparece como pendente de autenticação; selecione-o e conclua o login no navegador. Um servidor funcionando mostra um ícone de confirmação, e um com falha mostra o status HTTP. Os detalhes estão na documentação de MCP do Claude Code.

Por padrão, o servidor é salvo no escopo local, ou seja, fica privado para você e ativo apenas no projeto atual. Adicione --scope user para disponibilizá-lo em todos os projetos. Use o conector na web se você não trabalha no terminal; use o Claude Code quando as verificações de SEO fazem parte do fluxo de trabalho com o código.

Como conferir se o Claude está lendo dados reais do Search Console?

Peça algo que você consiga verificar na interface do Search Console antes de confiar em qualquer relatório. Teste primeiro.

  1. Pergunte: “Liste as propriedades do Search Console às quais você tem acesso e diga qual ferramenta usou.” A lista deve bater com o que você vê no Search Console.
  2. Escolha uma propriedade. Anote se ela é uma propriedade de domínio ou de prefixo de URL. Uma propriedade de domínio cobre todos os subdomínios e protocolos, enquanto uma propriedade de prefixo de URL cobre um único prefixo exato. Essa escolha muda os totais.
  3. Peça o total de cliques e impressões da Pesquisa Google (tipo Web) nos últimos 28 dias completos, com as datas de início e de fim.
  4. Abra no relatório de Desempenho do Search Console a mesma propriedade, o mesmo tipo de pesquisa e as mesmas datas. Os totais devem ser próximos. Pequenas diferenças podem vir de dados recentes ainda preliminares.
  5. Peça as cinco principais consultas de uma página e confira por amostragem no relatório de Desempenho, filtrando por essa página.
  6. Se os números forem diferentes, verifique o tipo de pesquisa, o escopo da propriedade, as datas e se os dias mais recentes são preliminares.

Se a lista de propriedades vier vazia, provavelmente a conta do Google usada no login não é a que tem acesso ao Search Console. Desconecte, reconecte e escolha a conta certa.

Quais prompts testar primeiro?

Comece por prompts que obrigam o Claude a informar a propriedade, o período e a ferramenta. Eles expõem rapidamente uma conexão quebrada e acostumam você a pedir resultados auditáveis.

Liste as propriedades do Google Search Console às quais tenho acesso. Diga qual delas você está usando antes de analisá-la.

Para a propriedade selecionada, compare os cliques e as impressões da Pesquisa Google nos últimos 28 dias completos com os 28 dias anteriores. Mostre as datas de início e de fim e as cinco páginas que mais explicam as mudanças.

Encontre consultas com pelo menos 200 impressões nos últimos 28 dias, posição média entre 4 e 20 e CTR comparativamente baixo. Devolva a consulta, a página, as impressões, os cliques, o CTR e a posição.

Trate os limites como pontos de partida, e não como regras de SEO. Um site pequeno pode precisar de um limite de impressões mais baixo, e um site grande, de um mais alto. Para ver mais, leia 25 prompts de SEO para agentes de IA e o guia para encontrar consultas com CTR baixo.

Como fazer uma primeira auditoria no Claude?

Faça uma auditoria bem delimitada, em vez de pedir ao Claude que “conserte o meu SEO”. Os seis passos abaixo geram uma linha de base que você pode repetir todo mês e comparar depois de fazer mudanças.

  1. Selecione a propriedade. Peça ao Claude que liste as propriedades e escolha exatamente a que será analisada.
  2. Escolha períodos comparáveis. Use os últimos 28 dias completos contra os 28 dias anteriores. Exija que o Claude escreva os dois intervalos de datas.
  3. Dimensione a mudança. Peça cliques, impressões, CTR e posição média de cada período, com a variação absoluta e a percentual, usando o período anterior como denominador.
  4. Ache as páginas que importam. Ordene por cliques perdidos, e não por porcentagem perdida. Uma página que cai de 3 para 1 clique perdeu 67%, enquanto uma que cai de 900 para 650 perdeu 250 cliques.
  5. Investigue uma página. Para a maior perda, peça as consultas, a divisão por dispositivo e a divisão por país que mudaram. Uma queda só no celular pede verificações diferentes de uma queda em todos os dispositivos.
  6. Escreva um registro de ações. Anote a observação, uma hipótese a testar e uma métrica que mostraria a melhora. Não deixe o Claude apresentar como fato uma causa não verificada.

Use a propriedade do GSC selecionada e compare os dois períodos completos de 28 dias mais recentes. Mostre as datas de início e de fim e o total de cliques, impressões, CTR e posição de cada período. Liste as cinco URLs com as maiores perdas absolutas de cliques.

Para a URL com a maior perda, identifique quais consultas e dispositivos mudaram. Rotule as observações como observadas e as explicações propostas como hipóteses.

Resuma as três melhores próximas ações como: página, evidência, mudança proposta, esforço e métrica de sucesso. Não use dados de serviços que não estejam conectados.

Como é um exemplo prático?

Os números abaixo são hipotéticos, de um site fictício, e servem para mostrar como ler uma auditoria do Claude, não o que você vai encontrar. A lição principal é que as impressões podem subir enquanto os cliques caem.

Métrica28 dias anterioresÚltimos 28 diasVariação
Cliques12.40010.850-1.550 (-12,5%)
Impressões410.000421.000+11.000 (+2,7%)
CTR3,02%2,58%-0,44 ponto percentual

Suponha que o Claude informe, em seguida, que três páginas explicam 1.240 dos 1.550 cliques perdidos (cerca de 80%): /guides/api (-620), /blog/old-news (-410) e /pricing (-210). Uma leitura sólida é: os cliques caíram enquanto as impressões subiram, então a visibilidade não desabou; algo reduziu a proporção de impressões que viram cliques. Entre as hipóteses possíveis estão uma posição média menor em consultas importantes, um novo recurso de busca ocupando espaço ou um snippet mais fraco. Nenhuma é provada por essa tabela. O próximo passo é comparar consultas e posições de /guides/api e depois inspecionar os resultados ao vivo das principais consultas dela.

Quais são os limites dos dados do Search Console no Claude?

O Claude é tão completo quanto os dados que o conector devolve, e o próprio Search Console tem lacunas. Conheça-as antes de apresentar números a um cliente.

LimiteO que significaFonte
Os dias recentes são provisóriosOs dados mais novos (geralmente de hoje e, às vezes, de ontem) ainda podem mudar; por padrão, o relatório mostra dias completosGoogle: sobre os dados
Cerca de 16 meses de históricoComparações mais antigas exigem exportações guardadasComo guardar dados além de 16 meses
A API devolve as primeiras linhas, não tudoCada requisição devolve até 25.000 linhas, e a API expõe até cerca de 50.000 linhas por dia por tipo de pesquisa; as linhas vêm ordenadas por cliquesGoogle: consultas do Search Analytics
Consultas anonimizadasConsultas raras são omitidas por privacidade, então as tabelas de consultas podem somar menos que o totalGoogle: divergências nos dados
Os recursos de IA aparecem misturadosAs aparições em AI Overviews e no AI Mode são contadas no tipo de pesquisa Web; o relatório separado do Google sobre IA generativa mostra impressões, não cliquesGoogle: relatório de desempenho de IA generativa
Cota da Inspeção de URL2.000 inspeções por dia e 600 por minuto por site pela APIGoogle: limites de uso

Nunca trate um resultado truncado como completo e peça ao Claude que diga o que está faltando, em vez de estimar conversões que o Search Console não mostra.

Não use esta configuração quando você precisar de dados garantidamente em tempo real, quando a sua organização proibir o envio de dados de consultas a serviços de terceiros ou quando só precisar de uma exportação. Nesses casos, o upload de um CSV ou um script direto na API pode ser mais seguro.

Como resolver os problemas mais comuns do conector?

A maioria das falhas vem de limites do plano, da conta do Google errada ou de um conector instalado, mas não ativado na conversa atual. Percorra a tabela de cima para baixo.

SintomaCausa provávelO que verificar
Não aparece a opção “Add custom connector”Plano ou política do workspaceConfira o seu plano do Claude, o limite de conectores e, com um administrador, se os conectores personalizados estão habilitados
O plano Free recusa mais um conectorLimite de conectoresRemova um conector personalizado existente ou faça upgrade; confirme o limite atual no guia da Anthropic
O conector está instalado, mas o Claude não o usaNão está ativado nesta conversaAbra os controles de conectores no chat e ative-o; confira as permissões das ferramentas
O login entra em loop ou termina com erroProblema no servidor ou na autorizaçãoTente de novo e depois desconecte e reconecte; confirme que a URL do MCP é exatamente https://mcp.gscmagic.com/mcp
O login funciona, mas nenhuma propriedade é listadaConta do Google erradaReconecte com a conta que tem acesso ao Search Console; contas pessoais e profissionais costumam ser diferentes
Mensagem “Not authorized” ou nenhuma propriedade encontradaAinda não há conta no GSC Magic ou nenhuma propriedade do Google conectadaCrie uma conta gratuita em app.gscmagic.com, conecte o Google, importe uma propriedade e tente de novo
Os dados terminam alguns dias atrásAtraso do Search ConsoleCompare apenas períodos completos
Os números diferem da interface do Search ConsoleFiltros diferentes ou dados preliminaresAlinhe propriedade, tipo de pesquisa, datas e dimensões
O Claude Code mostra o servidor com falhaProblema de rede ou de autenticaçãoRode /mcp, leia o status exibido e autorize de novo

Se os nomes dos menus mudarem, o guia de conectores da Anthropic é a referência a seguir.

O que conferir antes de autorizar um conector?

Leia a tela de permissões, prefira o acesso somente leitura e conecte apenas servidores em que você confia. Um conector MCP é uma ponte entre o Claude e um serviço remoto, então o que ele pode fazer depende das ferramentas que expõe, e não só do Claude.

  • Acesso às propriedades. O conector enxerga o que a conta do Google conectada enxerga. Use uma conta com apenas o acesso de que você precisa.
  • Escopo das ferramentas. Diferencie a leitura de relatórios da escrita, como o envio de sitemaps. O GSC Magic mantém o plano Free somente leitura; nos planos pagos, as ferramentas de escrita ficam disponíveis, e o proprietário da conta pode desativá-las em Configurações.
  • Saídas sensíveis. As consultas podem revelar produtos ainda não lançados. Decida se esses dados podem ser compartilhados com o serviço de IA que você usa.
  • Controle da organização. Em um workspace de empresa, siga o processo de aprovação do administrador. A Anthropic avisa que os conectores personalizados não são verificados por ela.
  • Revogação. Saiba como desconectar o conector no Claude e como revogar o acesso na sua conta do Google.

A documentação de autorização do MCP explica como funciona o login baseado em OAuth em servidores remotos, se você quiser o contexto técnico.

Vale usar o Claude, o ChatGPT ou a API para o Search Console?

Use o que a sua equipe já tem: o Claude e o ChatGPT conseguem chamar o mesmo servidor MCP remoto, mas os menus, as regras de plano e os pedidos de aprovação são diferentes.

PerguntaConector do ClaudeApp MCP personalizado do ChatGPTScript na API do Search Console
Esforço de configuraçãoBaixo: cole uma URL e entreBaixo a médio; depende do plano e do workspaceAlto: OAuth, código, agendamento
Barreira de plano ou de administradorDepende do plano e do workspaceMuitas vezes mais rígida; veja o guia do ChatGPTNenhuma além das permissões do Google
Dados ao vivoSim, enquanto conectadoSim, enquanto conectadoSim, no seu agendamento
Ideal paraAnálise interativaEquipes que já usam o ChatGPTArmazenamento de dados e automação

O que fazer depois de conectar?

Faça a auditoria de seis passos uma vez, guarde a linha de base e escolha uma página e uma mudança para testar. Repita os mesmos prompts depois da próxima janela completa de 28 dias e compare.

A partir daí, siga como encontrar canibalização de palavras-chave quando duas páginas competem pela mesma consulta, o checklist de queda de tráfego quando os cliques caem ou por que as páginas não são indexadas quando URLs novas não aparecem. Para trazer dados do Bing, leia dados do Bing Webmaster Tools para agentes de IA.

Quer esse fluxo sem montar o seu próprio cliente de API? Comece grátis com o GSC Magic.

Perguntas frequentes

Dá para conectar o Google Search Console ao Claude sem programar?

Sim. No Claude na web ou no desktop, você adiciona um servidor MCP remoto como conector personalizado colando a URL dele e depois entra com o Google. Do seu lado, não é preciso escrever código nem criar um projeto no Google Cloud. O Claude Code usa um único comando no terminal. A disponibilidade depende do seu plano do Claude e das configurações do workspace.

O Claude tem acesso nativo aos meus dados do Search Console?

Não. O Claude não enxerga relatórios privados do Search Console, a menos que você conecte uma ferramenta que os exponha, como um conector MCP remoto, ou cole ou envie uma exportação. Sem conexão, ele só consegue explicar conceitos ou analisar os dados que você fornecer na conversa.

O plano Free do Claude pode usar um conector MCP personalizado?

O guia de conectores personalizados da Anthropic já listou suporte ao plano Free, com limite de um conector personalizado. As regras dos planos mudam, então confirme no artigo atual da Anthropic. O serviço MCP ao qual você se conecta, inclusive o GSC Magic, também pode ter limites próprios de requisições e de sites por plano.

O Claude pode alterar meu site ou enviar URLs pelo Search Console?

Só se o conector expuser ferramentas de escrita e você as permitir. O GSC Magic mantém o plano Free somente leitura; nos planos pagos, as ferramentas de escrita, como o envio de sitemaps ou o IndexNow, ficam disponíveis, e o proprietário da conta pode desativá-las em Configurações. O Claude também pode pedir aprovação antes de usar uma ferramenta.

Por que os números do Claude são diferentes dos da interface do Search Console?

As causas mais comuns são outra propriedade, outro tipo de pesquisa, outro período ou outro conjunto de dimensões, dados preliminares dos últimos dias e limites de linhas nas consultas à API. As consultas anonimizadas também entram nos totais, mas não nas tabelas de consultas. Peça ao Claude que informe a propriedade, o tipo de pesquisa e as datas exatas e compare os mesmos filtros no Search Console.

Os dados do Search Console no Claude incluem conversões?

Não. O Search Console informa impressões, cliques, taxa de cliques (CTR) e posição média na Pesquisa Google. Sessões, engajamento e eventos principais vêm do Google Analytics 4. Para responder a perguntas sobre conversões, conecte também o GA4 e espere que as duas ferramentas divirjam em alguns números, porque medem eventos diferentes.

É seguro autorizar um conector MCP com a minha conta do Google?

Revise o que o conector solicita antes de aprovar. Prefira o acesso somente leitura para relatórios, conecte apenas servidores em que você confia e nunca cole senhas ou segredos de API no chat. Você pode desconectar o conector no Claude e revogar o acesso dele nas permissões da sua conta do Google a qualquer momento.

Faça isso com o GSC Magic

A versão resumida deste guia, com o link de um clique “Add to Claude” e as perguntas frequentes, está na página de integração com o Claude. Desenvolvedores podem fazer o mesmo no Claude Code com um único comando.

, Fundador do GSC Magic

Łukasz desenvolve o GSC Magic, o servidor MCP que dá a agentes de IA acesso ao Google Search Console, ao Bing Webmaster Tools e ao GA4. Ele escreve sobre como usar dados do Search Console com Claude, ChatGPT e agentes de programação, e sobre os fluxos de trabalho de SEO que essas ferramentas tornam possíveis.

lukaszblania.comgithub.com/lumizone

Dê ao seu agente os seus dados de busca.

O GSC Magic conecta Claude, ChatGPT e Cursor ao Google Search Console, Bing e GA4. Plano gratuito, teste de 7 dias do Pro, sem cartão.

Começar grátis