Google Search Console MCP Server

Um servidor Model Context Protocol (MCP) que fornece acesso ao Google Search Console e ao Google Analytics

Documentação

Google Search Console MCP Server — O Guia Completo (2026)

Resumir com IA: ChatGPT · Perplexity · Claude · Grok

Resposta rápida: Um servidor MCP do Google Search Console é um conector do Model Context Protocol que expõe dados ao vivo do GSC (e opcionalmente do GA4) como ferramentas que seu assistente de IA pode chamar. Pergunte ao Claude, Cursor ou Codex coisas como "Quais consultas caíram esta semana?" e obtenha respostas reais do Search Console — sem exportar CSV, sem alternar de aba.

Caminho mais rápido (recomendado): GenieSeo — hospedado, grátis durante o beta, configuração em 60 segundos, GSC + GA4, sem cartão de crédito.

Controle total: auto-hospedado com uvx mcp-search-console (veja configuração auto-hospedada).

Beta do GenieSeo — grátis agora: Todas as 28 ferramentas (21 do Search Console + 7 do GA4), uma URL MCP pessoal, funciona no Claude na web, Cursor, Codex e Antigravity. Comece grátis →

GenieSeo MCP - connect Google Search Console and GA4 to Claude, Cursor, and Codex

Watch setup video - connect Google Search Console and GA4 to Claude in 60 seconds

▶ Assista ao vídeo de configuração de 60 segundos — cadastre-se, conecte o Google, cole a URL MCP no Claude

Última atualização: 11 de junho de 2026 · Tempo de leitura: ~18 minutos · Nível de habilidade: Iniciante

Este guia cobre tudo o que você precisa para conectar o Google Search Console (e opcionalmente o GA4) ao Claude, Cursor ou Codex usando o Model Context Protocol (MCP) — incluindo uma opção hospedada gratuita, instalação auto-hospedada, referência das 28 ferramentas, prompts prontos para copiar e colar e um vídeo passo a passo.

Sumário

Vídeo passo a passo — configuração em 60 segundos
O que é um servidor MCP do Google Search Console?
Quanto custa? (opções gratuitas)
Por que profissionais de SEO e desenvolvedores usam MCP para o Search Console
Google Analytics 4 na mesma URL MCP
Todas as 28 ferramentas MCP (referência)
Hospedado vs auto-hospedado: qual escolher?
Configuração em 60 segundos — GenieSeo (hospedado)
Configuração auto-hospedada — código aberto
Conecte ao Claude, Cursor, Codex e Antigravity
Exemplos de prompts e fluxos de trabalho de SEO
Casos de uso por função
Segurança, privacidade e permissões
Preços
Comparações
Arquitetura
FAQ
Recursos e links

Vídeo passo a passo — configuração em 60 segundos

Prefere assistir em vez de ler? Clique no pôster abaixo para assistir ao vídeo de configuração do GenieSeo — cadastre-se, conecte o Google OAuth, copie sua URL MCP e cole no Claude. Grátis durante o beta, sem cartão de crédito.

Play setup video - GenieSeo connects Google Search Console MCP to Claude, Cursor, or Codex

▶ Assista ao vídeo de configuração · Abrir em tela cheia

Cobre: login no Google → geração da URL MCP → Configurações do Claude → Conectores → sua primeira consulta no Search Console.

Usuários auto-hospedados: O vídeo de configuração mostra o fluxo hospedado de ponta a ponta. Para instalações via uvx ou clone, vá para configuração auto-hospedada — a configuração de credenciais leva de 15 a 45 minutos.

O que é um servidor MCP do Google Search Console?

Você abre o Google Search Console, adiciona um filtro, altera o intervalo de datas, exporta um CSV, cria uma tabela dinâmica — e trinta minutos depois respondeu a uma pergunta que deveria levar dez segundos.

E se você pudesse simplesmente perguntar?

"Quais páginas perderam tráfego este mês?" · "A quais palavras-chave estou perto de ranquear na primeira página?" · "Alguma URL está canibalizando outra?"

Model Context Protocol (MCP) é um padrão aberto que permite que clientes de IA se conectem a dados e ferramentas externas por meio de uma única URL ou processo local — pense nele como USB para IA. Um servidor MCP do Google Search Console implementa esse protocolo para o GSC: ele traduz solicitações em linguagem natural da sua IA em chamadas à API do Google Search Console e retorna JSON estruturado que seu modelo pode analisar.

Você configura uma vez. Depois disso, faz perguntas em português simples e obtém respostas dos seus dados reais do Search Console — não suposições genéricas de dados de treinamento.

flowchart LR
  A[You in Claude / Cursor / Codex] --> B[MCP client]
  B --> C[Google Search Console MCP Server]
  C --> D[Google Search Console API]
  C --> E[Google Analytics 4 API]
  D --> F[Queries, clicks, indexing, sitemaps]
  E --> G[Sessions, conversions, funnels]
  F --> C
  G --> C
  C --> B
  B --> A

O que você ganha:

Sem MCP	Com um servidor MCP do GSC
Exportar CSV do GSC e colar no chat	Perguntar "Top 20 consultas nos últimos 28 dias com CTR abaixo de 2%"
Inspeção manual de URL, uma por vez	Inspecionar 10 URLs em lote em uma única chamada de ferramenta
Alternar entre abas do GSC e GA4	Cruzar cliques (GSC) com conversões (GA4) em uma única conversa
Capturas de tela estáticas para stakeholders	A IA gera tabelas, resumos e recomendações a partir de dados ao vivo

O que você pode fazer

Conecte o GenieSeo ao Claude, Cursor ou Codex e trabalhe com dados ao vivo do Search Console e GA4 — acompanhe rankings, corrija indexação, identifique oportunidades de conteúdo, cruze tráfego com conversões e execute fluxos de trabalho de SEO em português simples.

Isso não é um produto de chatbot. O GenieSeo e os servidores MCP do GSC auto-hospedados são conectores. A conversa permanece dentro do Claude, Cursor, Codex ou Antigravity — sua IA ganha superpoderes, não uma nova interface para aprender.

Quanto custa? (opções gratuitas)

Tudo o que você precisa para começar é gratuito.

Item	Custo
API do Google Search Console	Grátis
API do Google Analytics 4	Grátis
GenieSeo (MCP hospedado, beta)	Grátis — sem cartão de crédito
Auto-hospedado (`uvx mcp-search-console`)	Grátis (licença MIT)
Claude / Cursor (vários planos)	O nível gratuito funciona para testes

O único "custo" real é o tempo de configuração: ~60 segundos no GenieSeo, ou 15–45 minutos se você auto-hospedar com OAuth do Google Cloud.

Por que profissionais de SEO e desenvolvedores usam MCP para o Search Console

Problemas que o MCP resolve

Troca de contexto — A interface do GSC foi feita para humanos clicarem em filtros, não para agentes executarem auditorias repetíveis em dezenas de propriedades.
Atrito na exportação — O Search Analytics limita exportações; a Inspeção de URL é uma URL por clique.
Lacuna de análise — Dados brutos em uma planilha ainda precisam de um analista. O MCP coloca o analista (seu LLM) no mesmo fluxo dos dados.
Pontos cegos entre canais — O Search Console mostra quem clicou; o GA4 mostra o que aconteceu depois. Uma URL MCP combinada fecha esse ciclo.

Quem se beneficia

Função	Fluxo de trabalho típico
Especialista em SEO	Revisões semanais de ranking, verificações de canibalização, mineração de oportunidades de conteúdo
Gerente de contas em agência	Auditorias multicliente, resumos prontos para clientes, triagem de indexação
Desenvolvedor	Erros de indexação, problemas de canônica e correções — no mesmo IDE do código
Profissional de marketing de conteúdo	Mapeamento consulta-página, otimização de CTR, briefings a partir de demanda real de busca
Fundador de startup	Visões gerais de crescimento orgânico sem contratar uma pilha de ferramentas de SEO

GenieSeo - free beta: Google Search Console + GA4 MCP for Claude, Cursor, and Codex

O GenieSeo é grátis durante o beta — 28 ferramentas, uma URL MCP, sem necessidade de Python. Comece grátis →

Google Analytics 4 na mesma URL MCP

A maioria dos servidores MCP do GSC de código aberto são apenas Search Console. A pilha documentada aqui adiciona 7 ferramentas do GA4 no mesmo endpoint MCP e com o mesmo consentimento OAuth do Google (webmasters.readonly + analytics.readonly).

Por que combinar GSC + GA4?

Fonte de dados	Respostas
Google Search Console	Quais consultas e páginas geram impressões e cliques; status de indexação; saúde do sitemap
Google Analytics 4	Sessões, usuários engajados, conversões, receita, tráfego em tempo real, funis

Exemplo de prompt de cruzamento:

"Para minhas 10 principais páginas de destino orgânicas por cliques (últimos 28 dias), traga sessões engajadas do GA4 e taxa de conversão. Sinalize páginas com muitos cliques, mas taxa de conversão abaixo da média do site."

Essa única pergunta usa análise de pesquisa do GSC e run_ga4_report do GA4 — impossível em uma única etapa sem um conector combinado.

Desativar GA4 (somente auto-hospedado): defina GSC_DISABLE_GA4=true para expor apenas as ferramentas do GSC.

Todas as 28 ferramentas MCP (referência)

Chame get_capabilities primeiro em qualquer sessão — ela retorna o status de autenticação e a lista completa de ferramentas.

Autenticação (1 ferramenta)

Ferramenta	Descrição
`reauthenticate`	Executar novamente o login OAuth no navegador; use quando os tokens expirarem ou você precisar trocar de conta Google

Google Search Console — Propriedades (3 ferramentas)

Ferramenta	Parâmetros	Descrição
`list_properties`	—	Listar todas as propriedades do GSC (comece aqui para `site_url`)
`get_site_details`	`site_url`	Detalhes de verificação e propriedade
`get_creator_info`	—	Metadados do servidor e atribuição

Google Search Console — Análises e relatórios (5 ferramentas)

Ferramenta	Exemplo de pergunta	Descrição
`get_search_analytics`	"Top 20 consultas nos últimos 28 dias com CTR abaixo de 2%"	Principais consultas/páginas com cliques, impressões, CTR e posição
`get_performance_overview`	"Como está o desempenho do meu site este mês?"	Visão geral de KPIs de alto nível
`compare_search_periods`	"Quais consultas melhoraram em relação ao mês passado?"	Variações entre períodos
`get_search_by_page_query`	"Quais palavras-chave geram tráfego para /pricing?"	Consultas que geram tráfego para uma página
`get_advanced_search_analytics`	"Principais consultas móveis nos EUA nos últimos 90 dias"	Análises multidimensionais (país, dispositivo, consulta, página)

Google Search Console — Inspeção de URL e indexação (3 ferramentas)

Ferramenta	Exemplo de pergunta	Descrição
`inspect_url_enhanced`	"Esta URL está indexada e qual é a canônica?"	Status completo de rastreamento/indexação/canônica/mobile/dados estruturados
`batch_url_inspection`	"Inspecione minhas 10 principais páginas por cliques"	Inspeção em lote em uma única chamada (até 10 URLs)
`check_indexing_issues`	"Quais destas URLs têm problemas de indexação?"	Resumo priorizado de problemas de indexação

Google Search Console — Sitemaps (5 ferramentas)

Ferramenta	Principais parâmetros	Descrição
`get_sitemaps`	`site_url`	Listar sitemaps
`list_sitemaps_enhanced`	`site_url`	Status detalhado do sitemap, erros e avisos
`get_sitemap_details`	`site_url`, `sitemap_url`	Análise aprofundada de um único sitemap
`submit_sitemap`	`site_url`, `sitemap_url`	Enviar um sitemap
`manage_sitemaps`	`site_url`, `action`	Enviar ou excluir sitemaps

Google Search Console — Destrutivas (desativadas por padrão, 2 ferramentas)

Requer GSC_ALLOW_DESTRUCTIVE=true:

Ferramenta	Descrição
`add_site`	Adicionar uma propriedade ao GSC
`delete_site`	Remover uma propriedade do GSC

Google Analytics 4 (7 ferramentas)

Ferramenta	Parâmetros-chave	Descrição
`list_ga4_properties`	—	Todas as propriedades GA4 na conta conectada (comece aqui)
`get_ga4_property_details`	`property_id`	Fuso horário, moeda, setor, conta pai
`get_ga4_custom_dimensions_and_metrics`	`property_id`	Definições personalizadas na propriedade
`list_ga4_ads_links`	`property_id`	Contas do Google Ads vinculadas
`list_ga4_property_annotations`	`property_id`	Marcadores de data para eventos que afetam dados
`run_ga4_report`	`property_id`, dimensões, métricas, datas	Relatórios flexíveis (sessões, usuários, receita, etc.)
`run_ga4_realtime_report`	`property_id`	Últimos ~30 minutos de atividade ao vivo
`run_ga4_funnel_report`	`property_id`, etapas do funil	Funil de conversão passo a passo

Meta (1 ferramenta)

Ferramenta	Descrição
`get_capabilities`	Catálogo completo de ferramentas + status de autenticação ao vivo — chame isto primeiro

Hospedado vs. auto-hospedado: qual escolher?

Fator	GenieSeo (hospedado, beta gratuito)	Auto-hospedado (`uvx mcp-search-console`)
Tempo de configuração	~60 segundos	15–45 minutos (Google Cloud + configuração do cliente)
Python / terminal	Não necessário	Necessário (`uvx` ou clone)
Ferramentas GA4	Incluídas (7 ferramentas)	Incluídas nesta pilha
Claude na web (claude.ai)	Sim — URL MCP HTTPS	Não por padrão (stdio = somente Desktop)
Claude Desktop	Sim	Sim
Cursor	Sim	Sim (com configuração local)
OAuth	Login do Google com um clique	`client_secrets.json` manual
Armazenamento de tokens	Gerenciado com segurança pelo GenieSeo	`token.json` local na sua máquina
Custo	Grátis durante o beta (sem cartão de crédito)	Grátis (licença MIT)
Melhor para	Profissionais de SEO, agências, integração rápida	Desenvolvedores, ambientes isolados, implantações personalizadas

Recomendação:

Escolha GenieSeo se você quiser consultar em menos de um minuto, precisar de GA4 + GSC juntos, usar Claude na web ou compartilhar acesso com colegas não técnicos — atualmente grátis no beta.
Escolha auto-hospedado se precisar de controle total sobre credenciais, implantações Docker personalizadas ou zero dependência de um serviço hospedado.

Configuração em 60 segundos — GenieSeo (hospedado)

GenieSeo é o servidor MCP do Google Search Console hospedado com GA4 — uma URL MCP pessoal, transporte HTTP Streamable, sem client_secrets.json. Grátis durante o beta (sem cartão de crédito).

Assista primeiro (recomendado)

Clique na imagem para acompanhar — menos de dois minutos do cadastro à sua primeira consulta no Claude.

Watch: paste your GenieSeo MCP URL into Claude - step-by-step setup video

▶ Reproduzir vídeo de configuração

Etapas

Cadastre-se em seo.geniedial.in/signup — beta gratuito, sem cartão de crédito
Conecte o Google — uma única tela OAuth para acesso de leitura ao Search Console + Analytics
Copie sua URL MCP do painel do GenieSeo (formato: https://seo.geniedial.in/mcp/u/YOUR_TOKEN)
Cole no seu cliente de IA (veja os guias de clientes abaixo)
Faça sua primeira pergunta: "Liste minhas propriedades do Search Console" ou "Chame get_capabilities"

Trecho de configuração MCP (qualquer cliente HTTP Streamable)

{
  "mcpServers": {
    "genieseo": {
      "url": "https://seo.geniedial.in/mcp/u/YOUR_TOKEN"
    }
  }
}

Substitua YOUR_TOKEN pelo token do seu painel do GenieSeo.

Transporte: HTTP Streamable (especificação MCP 2025-03-26) — endpoint único /mcp para POST (JSON-RPC), GET (streaming), DELETE (fim da sessão).

Configuração auto-hospedada — código aberto

O servidor MCP do Google Search Console de código aberto roda localmente via uvx ou a partir de um repositório clonado. As ferramentas GA4 carregam automaticamente, a menos que GSC_DISABLE_GA4=true.

Pré-requisitos

Python 3.11+
uv (recomendado) ou virtualenv
Projeto Google Cloud com a API do Search Console ativada
Para GA4: API de Dados do Google Analytics e API de Administração do Google Analytics ativadas no mesmo projeto

Opção A — OAuth (recomendado para pessoas físicas)

Google Cloud Console → Criar/selecionar projeto
Ative a API do Search Console
Ative a API de Dados do Analytics e a API de Administração do Analytics (para ferramentas GA4)
Credenciais → Criar → ID do cliente OAuth → Aplicativo de desktop
Baixe o JSON → salve como, por exemplo, ~/Documents/client_secrets.json
Na primeira execução, o navegador abre para login do Google; o token é salvo no diretório de configuração da plataforma

Opção B — Conta de serviço (automação / equipes)

Crie a conta de serviço e baixe a chave JSON
Adicione o e-mail da conta de serviço a cada propriedade GSC (Configurações → Usuários → Acesso total)
Para GA4: conceda Visualizador (ou superior) no Admin do GA4 para cada propriedade
Defina GSC_CREDENTIALS_PATH e GSC_SKIP_OAUTH=true

Instalar com uvx (auto-hospedado mais rápido)

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

# Verify
uv --version
which uvx

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Use o caminho completo de which uvx — aplicativos GUI não leem o PATH do seu shell.

Variante com conta de serviço:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

Clonar e executar localmente

Prefira uvx mcp-search-console quando você só precisa executar o servidor — sem necessidade de clone (veja Opção A acima).

Para modificar o código-fonte localmente:

git clone https://github.com/AminForou/mcp-gsc.git
cd mcp-gsc
uv venv .venv
uv pip install -r requirements.txt
uv run python gsc_server.py

Variáveis de ambiente

Variável	Padrão	Descrição
`GSC_OAUTH_CLIENT_SECRETS_FILE`	—	Caminho para o JSON de segredos do cliente OAuth
`GSC_CREDENTIALS_PATH`	—	Caminho para o JSON da conta de serviço
`GSC_SKIP_OAUTH`	`false`	Forçar modo de conta de serviço
`GSC_DATA_STATE`	`all`	`all` = paridade com o painel do GSC; `final` = somente dados confirmados (atraso de 2–3 dias)
`GSC_ALLOW_DESTRUCTIVE`	`false`	Ativar `add_site`, `delete_site`, exclusão de sitemap
`GSC_DISABLE_GA4`	`false`	Pular registro de ferramentas GA4
`MCP_TRANSPORT`	`stdio`	Definir `streamable-http` para remoto/Docker
`MCP_HOST`	`127.0.0.1`	Host de vinculação para transporte HTTP
`MCP_PORT`	`3001`	Porta de vinculação para transporte HTTP

Docker (remoto / contêiner)

docker build -t mcp-gsc .
docker run \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=3001 \
  -e GSC_CREDENTIALS_PATH=/app/credentials.json \
  -v /path/to/credentials.json:/app/credentials.json \
  -p 3001:3001 \
  mcp-gsc

Endpoint: http://<host>:3001/mcp

Nota: O transporte sse obsoleto foi removido. Use apenas streamable-http.

Habilidades do Cursor Marketplace (auto-hospedado no Cursor)

Pesquise mcp-search-console no Cursor Marketplace para habilidades agrupadas:

Habilidade	Invocar com	Finalidade
`seo-weekly-report`	"Execute o relatório semanal de SEO para example.com"	Desempenho de 28 dias + comparação de períodos
`cannibalization-check`	"Verifique canibalização de palavras-chave em example.com"	Páginas concorrentes por consulta
`indexing-audit`	"Audite a indexação das minhas principais páginas"	Inspeção em lote das principais URLs
`content-opportunities`	"Encontre oportunidades de conteúdo para example.com"	Posições 11–20 + alta impressões

Verificar instalação

Pergunte à sua IA: "Liste minhas propriedades GSC" ou "Chame get_capabilities".

Conecte ao Claude, Cursor, Codex e Antigravity

Claude (web — claude.ai)

Requer URL Streamable HTTP (GenieSeo hospedado). Servidores stdio locais não funcionam no navegador.

Claude → Configurações → Conectores → Adicionar MCP personalizado
Nome: GenieSeo
URL: https://seo.geniedial.in/mcp/u/YOUR_TOKEN
Salvar → iniciar um novo chat → perguntar sobre dados do Search Console

Guia completo: Conecte o Search Console ao Claude

Claude Desktop

Hospedado: mesma URL acima nas configurações de MCP
Auto-hospedado: claude_desktop_config.json com uvx + variáveis de ambiente (veja auto-hospedado)

Cursor

Configurações → MCP → Adicionar servidor MCP
Nome: GenieSeo
URL: sua URL MCP do GenieSeo (ou endpoint streamable-http local)
Use no Chat ou no Composer (modo Agente) — agentes chamam ferramentas MCP diretamente

Guia completo: Conecte o Search Console ao Cursor

Codex CLI

~/.codex/config.toml:

[mcp_servers.genieseo]
url = "https://seo.geniedial.in/mcp/u/YOUR_TOKEN"
enabled = true

OAuth auto-hospedado:

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_OAUTH_CLIENT_SECRETS_FILE = "/full/path/to/client_secrets.json" }

Antigravity

Adicione a mesma URL MCP do GenieSeo nas configurações de MCP do Antigravity. Uma URL funciona em todos os clientes Streamable HTTP.

Exemplos de prompts e fluxos de trabalho de SEO

Desempenho de pesquisa

Show me the top 20 search queries for [site] in the last 30 days.
Highlight any with CTR below 2% and suggest title tag improvements.

Compare my site's Search Console performance between last month and the month before.
Which queries improved position the most? Which pages lost clicks?

Find queries with high impressions but average position below 10,
filtered to mobile traffic in the United States only.

Indexação e SEO técnico

Check these URLs for indexing issues:
https://example.com/product
https://example.com/services
https://example.com/about

Group results by issue type and prioritize fixes by estimated traffic impact.

Inspect my top 20 pages by clicks (last 28 days) for indexing status.
Return a table: URL, index status, canonical, last crawl, recommended action.

Sitemaps

List all sitemaps for [site], flag any with errors or warnings,
and recommend which sitemap entries to investigate first.

Analytics GA4

List my GA4 properties, then for property [ID] run a report:
sessions and conversions by landing page for the last 28 days, organic traffic only.

Show realtime active users on [property] broken down by country.

Referência cruzada GSC + GA4

Pull my top 15 organic landing pages by GSC clicks (last 28 days).
For each, get GA4 engaged sessions and conversion rate.
Flag high-click / low-conversion pages and suggest hypotheses.

Revisão semanal de agência

For client site [site_url]:
1. Top 50 queries this week vs last week
2. Flag positions that dropped more than 3 places
3. List affected URLs
4. Draft a 3-bullet client email summary

Casos de uso por função

Agência de SEO

Revisões semanais de classificação em muitas propriedades de clientes sem exportações CSV
Auditorias técnicas — inspeção de URLs em lote + triagem de tráfego GA4
Relatórios de clientes — markdown estruturado ou JSON que sua IA formata para apresentações

Guia: Fluxos de trabalho de SEO com IA para agências

SEO freelancer

Detecção de canibalização, análise de lacunas de conteúdo, triagem de indexação em um laptop entre reuniões

Desenvolvedor

Diagnosticar problemas de indexação, canônicos e dados estruturados dentro do Cursor enquanto edita a correção

Guia: Desenvolvedores + Search Console no Cursor

Profissional de marketing de conteúdo

Mapeamento consulta-para-página, otimização de CTR com base em dados reais de demanda do Search Console

Startup

Instantâneos de crescimento orgânico e priorização de conteúdo sem assinatura completa de ferramenta de SEO

Segurança, privacidade e permissões

Escopos OAuth (somente leitura por padrão)

Escopo	Acesso
`webmasters.readonly`	Dados do Search Console (analytics, inspeção, sitemaps)
`analytics.readonly`	Relatórios GA4 e metadados de propriedade

Operações de escrita (enviar sitemap, adicionar/excluir site) exigem configuração explícita do servidor (GSC_ALLOW_DESTRUCTIVE=true) em implantações auto-hospedadas.

GenieSeo hospedado

Tokens OAuth criptografados em repouso
URL MCP por usuário — tokens não compartilhados entre contas
Revogue o acesso a qualquer momento pelas permissões da conta Google ou pelo painel do GenieSeo
Sem venda de dados do Google; arquitetura somente conector

Auto-hospedado

Tokens armazenados localmente (token.json no diretório de configuração do usuário da plataforma)
Você controla a exposição de rede (padrão: stdio, sem portas abertas)
Implantações Docker/HTTP: volume de credenciais seguro e terminação TLS na sua borda

Preços

Plano	Preço	Inclui
GenieSeo Beta	Grátis (sem cartão de crédito)	28 ferramentas, GSC + GA4, URL MCP hospedada, todas as propriedades verificadas na conta Google conectada — grátis durante o beta
GenieSeo Pro (roadmap)	A definir	Espaços de trabalho em equipe, limites maiores, suporte prioritário
Auto-hospedado	Grátis (MIT)	Código-fonte completo, propriedades ilimitadas, apenas custos da sua infraestrutura

Detalhes: seo.geniedial.in/pricing

Claude e Cursor são cobrados separadamente pela Anthropic e pela Cursor. O GenieSeo é apenas o conector de dados — grátis durante o beta.

Comparações

GenieSeo vs. servidores MCP auto-hospedados somente GSC

	GenieSeo (hospedado, beta gratuito)	MCP GSC auto-hospedado típico
GA4	Sim (7 ferramentas)	Geralmente não
Claude web	Sim	Não (stdio padrão)
Configuração	~60s	~30 min
Pacote	URL hospedada	`uvx mcp-search-console` ou clone local

Comparação completa: GenieSeo vs. outros servidores MCP GSC

GenieSeo vs. Advanced GSC Visualizer (extensão do Chrome)

	GenieSeo MCP	Advanced GSC Visualizer
Onde roda	Claude, Cursor, Codex	Dentro da aba do navegador GSC
Fluxos de trabalho com IA	Sim	Não
GA4	Sim	Não

Comparação completa: GenieSeo vs. Advanced GSC

Melhores servidores MCP do Google Search Console (resumo 2026)

Veja a comparação selecionada: Melhores servidores MCP GSC 2026

Arquitetura

Servidor MCP de arquivo único (núcleo auto-hospedado)

O servidor é construído com FastMCP — sem framework personalizado. Módulos principais:

Arquivo	Função
`gsc_server.py`	Ferramentas GSC, autenticação OAuth/conta de serviço, transporte MCP
`ga4_tools.py`	Ferramentas GA4 registradas na mesma instância FastMCP

Ordem de autenticação:

OAuth token.json (hospedado ou local)
JSON de conta de serviço (GSC_CREDENTIALS_PATH) quando GSC_SKIP_OAUTH=true ou OAuth indisponível

Formato de resposta: Todas as ferramentas de dados retornam json.dumps(structured_data) — otimizado para raciocínio de LLM, não prosa.

Stack hospedada do GenieSeo (alto nível)

GenieSeo é um conector de nuvem gerenciado. Você continua usando Claude, Cursor ou Codex normalmente — GenieSeo cuida do OAuth do Google, armazenamento seguro de tokens e o endpoint MCP que fala com o Google Search Console e GA4 em seu nome.

flowchart LR
  A[You in Claude / Cursor / Codex] --> B[Your personal GenieSeo MCP URL]
  B --> C[GenieSeo managed service]
  C --> D[Google Search Console API]
  C --> E[Google Analytics 4 API]
  D --> C
  E --> C
  C --> B
  B --> A

O que você controla: qual conta do Google conectar, quando revogar o acesso e cada pergunta que você faz no seu cliente de IA.

O que o GenieSeo gerencia: OAuth, armazenamento criptografado de credenciais, disponibilidade e manter as ferramentas MCP sincronizadas com as APIs do Google — para que você nunca gerencie client_secrets.json ou tokens locais.

Perguntas Frequentes

O que é um servidor MCP do Google Search Console?

Um servidor que implementa o Model Context Protocol para expor o Google Search Console (e opcionalmente GA4) como ferramentas chamáveis dentro de assistentes de IA como Claude e Cursor.

Qual é o melhor servidor MCP do Google Search Console em 2026?

Para configuração mais rápida e GA4: GenieSeo (hospedado, beta gratuito, 28 ferramentas, compatível com Claude web). Para controle local total: auto-hospede com uvx mcp-search-console (veja configuração auto-hospedada).

Como conecto o Google Search Console ao Claude?

Cadastre-se no GenieSeo, conecte o OAuth do Google, copie sua URL MCP, cole em Configurações do Claude → Conectores → Adicionar MCP personalizado. Em menos de 60 segundos. Guia passo a passo · Vídeo de configuração.

Funciona com Claude na web (claude.ai)?

Sim, com GenieSeo (URL HTTPS Streamable HTTP). Servidores stdio auto-hospedados funcionam apenas no Claude Desktop, não no navegador.

Funciona com Cursor?

Sim. Adicione sua URL MCP em Configurações do Cursor → MCP. O modo agente Composer pode chamar todas as ferramentas GSC e GA4. Guia do Cursor.

Quantas ferramentas estão incluídas?

28 no total: 21 do Google Search Console + 7 do Google Analytics 4 em uma única URL MCP.

O Google Analytics está incluído?

Sim, nesta stack (GenieSeo hospedado e o pacote mcp-search-console / uvx). A maioria dos outros servidores MCP apenas GSC não inclui GA4.

Meus dados do Google estão seguros?

Os tokens OAuth têm escopos somente leitura. Tokens hospedados são criptografados em repouso. Revogue a qualquer momento pela Conta do Google ou pelo seu painel. Tokens auto-hospedados permanecem na sua máquina.

Existe uma opção gratuita?

Sim — GenieSeo é gratuito durante o beta (sem cartão de crédito); auto-hospedado é licenciado sob MIT e gratuito para sempre.

Preciso de Python?

Não para GenieSeo hospedado. Sim para auto-hospedado (uvx ou clone).

O que é MCP?

Model Context Protocol — um padrão aberto para clientes de IA se conectarem a ferramentas externas e fontes de dados.

Posso usar várias contas do Google?

GenieSeo: uma conta do Google por usuário hoje; workspaces com várias contas no roadmap. Auto-hospedado: reautentique ou use configurações separadas.

O que é `get_capabilities`?

Uma meta-ferramenta que retorna todas as ferramentas disponíveis, agrupadas por categoria, além do status de autenticação em tempo real. Chame-a primeiro ao depurar ou integrar.

Por que estou recebendo `spawn uvx ENOENT`?

Seu cliente de IA não consegue encontrar uvx no PATH. Use o caminho completo de which uvx na sua configuração MCP.

Posso desativar operações destrutivas do GSC?

Sim — elas estão desativadas por padrão. Defina GSC_ALLOW_DESTRUCTIVE=true apenas se precisar adicionar/excluir site ou excluir sitemap.

Qual transporte devo usar para implantação remota?

MCP_TRANSPORT=streamable-http. O transporte obsoleto sse não é mais suportado.

Onde está o código de código aberto?

Instale com uvx mcp-search-console (PyPI). Para mexer no código-fonte, clone uma cópia local — veja clonar e executar localmente. O servidor licenciado sob MIT alimenta tanto implantações auto-hospedadas quanto hospedadas do GenieSeo.

Como isso é diferente de exportar CSV do GSC?

O MCP retorna JSON estruturado diretamente para sua IA — sem exportação manual, sem limites de linhas no chat, e o modelo pode encadear várias chamadas de ferramentas (inspecionar → analisar → recomendar) em uma única conversa.

Agências podem usar isso para clientes?

Sim. Conecte uma conta do Google com acesso às propriedades do cliente; cada membro da equipe pode ter sua própria URL MCP. Alterne propriedades no meio da conversa nomeando o site_url.

Recursos e links

Produto

Recurso	URL
GenieSeo — Comece agora (beta gratuito)	https://seo.geniedial.in/signup
GenieSeo página inicial	https://seo.geniedial.in
Preços	https://seo.geniedial.in/pricing
Biblioteca de receitas (prompts copiar e colar)	https://seo.geniedial.in/recipes
Vídeo de configuração	Assistir vídeo de configuração

Auto-hospedado (código aberto)

Recurso	URL
Pacote PyPI (recomendado)	`uvx mcp-search-console`
Licença	MIT
Clone para desenvolvimento	Veja clonar e executar localmente

Guias de configuração

Cliente	URL
Claude	https://seo.geniedial.in/integrations/claude
Cursor	https://seo.geniedial.in/integrations/cursor
Codex	https://seo.geniedial.in/integrations/codex
ChatGPT	https://seo.geniedial.in/integrations/chatgpt
Todas as integrações	https://seo.geniedial.in/integrations

Conteúdo de blog e SEO

Tópico	URL
Visão geral do MCP GSC	https://seo.geniedial.in/blog/google-search-console-mcp-server
Conectar GSC ao Claude	https://seo.geniedial.in/blog/connect-google-search-console-to-claude-ai
Servidor MCP GA4	https://seo.geniedial.in/blog/ga4-mcp-server-claude-cursor
Melhores servidores MCP GSC 2026	https://seo.geniedial.in/blog/best-google-search-console-mcp-servers-2026

Suporte

Email: support@geniedial.in
Fundador: Nirav Modi no LinkedIn

Registro de alterações (servidor)

Versão	Destaques
Próxima	Transporte HTTP Streamable; `sse` removido
0.3.2	Correção de OAuth para uvx; ferramenta `get_capabilities`; melhores erros de autenticação
0.3.0	Plugin do Cursor Marketplace; 4 habilidades de SEO; saída JSON estruturada
0.2.x	Modo de segurança para operações destrutivas; Docker; transporte HTTP
0.1.0	19 ferramentas GSC iniciais; OAuth + conta de serviço

Construído por Peakenza Software Services. GenieSeo é gratuito durante o beta. A stack auto-hospedada é licenciada sob MIT. Perguntas: support@geniedial.in