Instalar o MCP do Google Search Console no Windows: Guia Definitivo com Claude Desktop

Conectar modelos avançados de inteligência artificial diretamente às fontes de dados do seu negócio é o maior divisor de águas da automação moderna. Graças ao Model Context Protocol (MCP), você não precisa mais exportar planilhas manuais do Google Search Console para depois subir em chats: o próprio Claude Desktop passa a ler, inspecionar e auditar os dados orgânicos do seu site em tempo real através de linguagem natural.

No entanto, quem utiliza o Windows frequentemente esbarra em particularidades do sistema operacional: comandos de terminal desenhados originalmente para Linux/macOS, variáveis de ambiente que o Claude não enxerga, sandboxes da Microsoft Store e armadilhas de extensões ocultas de arquivos.

Neste guia definitivo e testado na prática, você aprenderá exatamente como configurar o MCP oficial do Google Search Console no Windows, terá acesso ao vídeo demonstrativo, poderá baixar a Skill exclusiva pronta para uso e aprenderá a contornar cada um dos erros típicos do ambiente Windows.

Assista ao Vídeo Tutorial Prático

Se você prefere acompanhar a instalação passo a passo na tela, assista ao vídeo completo abaixo antes de executar os comandos:

▶ Clique para assistir ao tutorial prático YouTube 1080p

Download da Skill Exclusiva

Para quem utiliza agentes inteligentes e ferramentas compatíveis com skills de automação (como o ecossistema Claude, Antigravity ou Cursor), disponibilizei o pacote oficial da skill para download direto:

Antes de Começar: Checklist de Pré-Requisitos

Antes de abrir o terminal, certifique-se de que os três itens abaixo estão prontos:

1. Claude Desktop instalado: É necessário o aplicativo nativo para desktop (disponível em anthropic.com/claude-desktop). Extensões de navegador ou a versão web simples não executam servidores MCP locais.
2. Conta no Google Cloud Console: Acesso ativo ao console da Google (console.cloud.google.com) para geração de credenciais OAuth.
3. Propriedade verificada no Google Search Console: O site ou domínio que você quer auditar já deve estar vinculado e validado na sua conta Google.

Passo a Passo Completo de Instalação

Passo 1: Instalar o gerenciadoruvvia PowerShell

O pacote oficial do MCP Search Console (mcp-search-console) roda através do uv, o gerenciador de pacotes ultrarrápido do ecossistema Python desenvolvido pela Astral.

Abra o PowerShell (não use o Prompt de Comando comum CMD). Pressione Win + X e selecione Windows Terminal ou PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Após a conclusão da instalação, feche o PowerShell e abra uma nova janela para carregar as alterações. Confirme se o comando está funcionando:

uv --version

Resultado esperado: O terminal deve retornar a versão instalada, por exemplo uv 0.12.5.

Passo 2: Gerar as credenciais OAuth no Google Cloud Console

Para que o Claude leia suas métricas sem violar a segurança da Google, é necessário criar uma chave de autorização OAuth 2.0:

1. Acesse o Google Cloud Console e crie um novo projeto (ou selecione um projeto existente).
2. Ative a Google Search Console API acessando a Biblioteca de APIs do Search Console e clicando em Ativar.
3. Configure a Tela de consentimento OAuth:
   • Defina o tipo de usuário como Externo.
   • Adicione o seu e-mail do Google na lista de Usuários de teste (Passo obrigatório enquanto o app estiver em modo de teste).
4. Crie a credencial:
   • Vá para o menu Credenciais.
   • Clique em + Criar Credenciais → ID do cliente OAuth.
   • Em Tipo de aplicativo, selecione obrigatoriamente App para computador (Desktop App).
   • Dê um nome (ex: Claude Desktop MCP) e clique em Criar.
5. No pop-up que surgir com a credencial criada, clique em Fazer download do JSON.

Passo 3: Salvar o JSON num local definitivo e evitar a armadilha do.json.json

Mova o arquivo baixado para uma pasta permanente (nunca deixe na pasta Downloads, pois ela pode ser apagada por engano).

Caminho sugerido:

C:\Users\SEU_USUARIO\mcp-gsc\client_secrets.json

⚠️ A maior armadilha do Windows: Por padrão, o Windows esconde extensões de arquivos conhecidos. Se você renomear o arquivo baixado no Explorador de Arquivos para client_secrets.json, o Windows pode secretamente salvá-lo como client_secrets.json.json. O Claude emitirá um erro de que o arquivo não existe, mesmo que o caminho aparente estar correto.

Para diagnosticar e garantir que o nome está correto, execute no PowerShell:

Get-ChildItem "C:\Users\$env:USERNAME\mcp-gsc"

Se o nome exibido for client_secrets.json.json, corrija imediatamente com o comando:

Rename-Item "C:\Users\$env:USERNAME\mcp-gsc\client_secrets.json.json" "client_secrets.json"

Valide se o caminho responde positivamente (deve retornar True):

Test-Path "C:\Users\$env:USERNAME\mcp-gsc\client_secrets.json"

Passo 4: Descobrir o caminho absoluto douvx.exe

O Claude Desktop não herda automaticamente a variável de ambiente PATH da sessão interativa do seu terminal no Windows. Por isso, precisamos passar o caminho completo e absoluto para o binário do uvx.exe.

Descubra o local exato executando no PowerShell:

Get-Command uvx | Select-Object -ExpandProperty Source

Exemplo de saída típica: C:\Users\SEU_USUARIO\.local\bin\uvx.exe
Guarde esse caminho exato.

Passo 5: Localizar a pasta doclaude_desktop_config.json

O arquivo de configuração do Claude Desktop fica localizado na pasta de dados de aplicativos.

Cole o comando abaixo na barra de endereços do Explorador de Arquivos e pressione Enter:

%APPDATA%\Claude

Se o arquivo claude_desktop_config.json não existir nessa pasta, você pode criá-lo com o Bloco de Notas.

💡 Instalação via Microsoft Store? Se o Windows informar que não encontrou o caminho %APPDATA%\Claude, seu aplicativo foi instalado através da loja da Microsoft em modo sandbox. O caminho real fica localizado em: C:\Users\SEU_USUARIO\AppData\Local\Packages\Claude_<hash>\LocalCache\Roaming\Claude

Passo 6: Editar o arquivo de configuração com atenção às barras duplas

Abra o arquivo claude_desktop_config.json.

Regra fundamental: Se você já tiver outros servidores MCP configurados (como Neo4j, Supabase ou Google Tag Manager), nunca apague o conteúdo existente. Apenas adicione a chave "gscServer" dentro do objeto "mcpServers".

Repare também que os caminhos no arquivo JSON do Windows devem utilizar barras invertidas duplas (\\):

{
  "mcpServers": {
    "gscServer": {
      "command": "C:\\Users\\SEU_USUARIO\\.local\\bin\\uvx.exe",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "C:\\Users\\SEU_USUARIO\\mcp-gsc\\client_secrets.json"
      }
    }
  }
}

(Substitua SEU_USUARIO pelo seu usuário real do Windows nos dois caminhos).

Passo 7: Reiniciar o Claude Desktop por completo

Fechar a janela do Claude clicando no X superior não encerra o processo, pois o Claude continua em execução em segundo plano na bandeja do sistema.

Para aplicar a nova configuração:

1. Vá até a Bandeja do Sistema (ícones ocultos perto do relógio do Windows).
2. Clique com o botão direito no ícone do Claude.
3. Escolha Sair / Quit.
4. Inicie o Claude Desktop novamente.

Passo 8: Testar a Conexão no Chat

Abra um novo chat no Claude Desktop e digite:

List my GSC properties

Na primeira execução, o Claude abrirá automaticamente uma aba no seu navegador padrão solicitando autorização na sua conta Google. Conceda as permissões.

Se o Claude listar todas as suas propriedades do Search Console, parabéns: sua IA agora tem acesso direto aos dados orgânicos do seu domínio!

Guia de Resolução de Problemas no Windows (Troubleshooting)

O que Perguntar ao Claude após a Conexão?

Com o MCP conectado, você pode transformar auditorias complexas em perguntas cotidianas:

Conclusão

A integração do Claude Desktop com o Google Search Console via MCP elimina o atrito de alternar entre abas, planilhas e filtros manuais. Com essa configuração estável no Windows, suas decisões de SEO, ajustes de conteúdo e diagnósticos de indexação passam a ser orientados por dados atualizados e interpretados com profundidade pela IA.

Se você curtiu este tutorial, lembre-se de baixar a Skill para seus agentes e compartilhar este conteúdo com outros desenvolvedores e profissionais de SEO que utilizam o Windows!