GSC Search Insights

npx add-mcp 'https://api.gscmcpserver.com/mcp'

Antes de começar

Você precisa de três coisas: acesso a pelo menos uma propriedade verificada no Google Search Console ou no Bing Webmaster Tools, um aplicativo de IA que suporte servidores MCP remotos e uma conta GSC MCP Server para ficar entre eles.

• Acesso ao Search Console. Qualquer nível de permissão funciona para ler dados. Se você consegue abrir o relatório de Performance de uma propriedade, o servidor consegue lê-lo em seu nome.
• Um cliente compatível com MCP. Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex, Gemini CLI, Windsurf e Cline são todos compatíveis. Workspaces Business e Enterprise às vezes precisam que um administrador permita conectores personalizados.
• Seu endpoint do servidor. Após fazer login, a página Configuração do cliente no seu painel mostra sua URL MCP e a configuração exata para cada cliente.

Novo no conceito? Leia primeiro o que é um servidor MCP do Search Console. Ele explica as partes envolvidas em linguagem simples.

Etapa 1: Conectar Google e Bing

1. Faça login com Google ou GitHub.
2. Abra Fontes de dados e escolha Conectar Google ou Conectar Bing.
3. Aprove a tela de consentimento somente leitura. Você será redirecionado ao painel com suas propriedades listadas.
4. Dê um rótulo à conexão que você reconhecerá em conversas, como "Cliente – Acme" ou "Blog pessoal". Os rótulos facilitam dizer ao assistente qual site você quer usar.

Você pode testar a conexão imediatamente no Playground do painel, que executa as mesmas ferramentas que seu assistente usará, antes de configurar qualquer cliente.

Claude (web e desktop)

O Claude suporta servidores MCP remotos como conectores personalizados e faz login via OAuth, então você não precisa colar nenhuma chave.

1. No Claude, abra Personalizar → Conectores, selecione + e depois Adicionar conector personalizado.
2. Dê o nome gscmcpserver e cole sua URL MCP do painel.
3. Conclua a solicitação de login e escolha Permitir para acesso de leitura.
4. Em uma nova conversa, ative o conector no menu de ferramentas e faça sua primeira pergunta.

[!note] Nota Por que localhost falha no Claude O Claude conecta-se a servidores MCP pela nuvem da Anthropic, mesmo no aplicativo desktop. Um servidor rodando na sua própria máquina é inacessível, então use o endpoint hospedado ou uma implantação HTTPS pública.

ChatGPT

O ChatGPT conecta-se a servidores MCP remotos como plugins personalizados (também chamados de conectores), usando OAuth com registro dinâmico de clientes.

1. Abra Personalizar → Plugins → Adicionar e escolha criar um plugin personalizado. Se a opção não aparecer, o administrador do seu workspace pode precisar ativá-la.
2. Digite gscmcpserver como nome, cole sua URL MCP HTTPS pública e selecione OAuth. Deixe a descoberta ativada; o escopo somente leitura é search:read.
3. Faça login na sua conta GSC MCP Server e escolha Permitir acesso de leitura.
4. Adicione o plugin a uma conversa e pergunte sobre seu desempenho de busca.

Você pode revogar o acesso do ChatGPT a qualquer momento em Clientes de IA conectados na página de configuração, sem afetar outros assistentes.

Cursor

O Cursor lê servidores MCP de um arquivo JSON. Use .cursor/mcp.json para um projeto ou ~/.cursor/mcp.json para todos os projetos.

1. Crie uma chave de API na página de configuração do painel. Trate-a como uma senha e nunca a envie para um repositório.
2. Adicione uma entrada gscmcpserver ao objeto mcpServers com seu endpoint como url e a chave como um cabeçalho Authorization: Bearer. A página de configuração gera esse trecho para você.
3. Abra as configurações de MCP do Cursor, verifique se o servidor está verde e ative suas ferramentas para o agente.

Desenvolvedores aproveitam melhor o Cursor quando os dados de busca ficam ao lado do código que gera as páginas. Nosso guia SEO técnico no Cursor e VS Code cobre esse fluxo de trabalho.

VS Code com GitHub Copilot

1. Abra a Paleta de Comandos e execute MCP: Add Server.
2. Escolha HTTP, cole seu endpoint e dê o nome gscmcpserver.
3. Salve nas configurações do usuário ou no .mcp.json do workspace.
4. Adicione sua chave de API como um cabeçalho Authorization: Bearer, execute MCP: List Servers para iniciá-lo e ative as ferramentas no seletor de ferramentas do Copilot Chat.

Claude Code, Codex e Gemini CLI

Agentes de terminal registram servidores remotos com um único comando. Seu painel gera o comando exato com seu endpoint preenchido. O formato é:

• Claude Code: claude mcp add --transport http --scope user gscmcpserver <url>, depois execute /mcp para verificar.
• Codex: codex mcp add gscmcpserver --url <url>, depois codex mcp list.
• Gemini CLI: gemini mcp add --transport http --scope user gscmcpserver <url>, depois /mcp.

Cada um precisa da sua chave de API configurada como cabeçalho bearer nas configurações de MCP. Windsurf e Cline seguem o mesmo padrão pelos painéis de configuração de MCP.

Seus cinco primeiros prompts

Execute-os em ordem. Eles confirmam que a conexão funciona e dão um panorama útil do site em poucos minutos.

Experimente este prompt

Liste minhas propriedades de busca conectadas e diga a qual conta cada uma pertence.

Experimente este prompt

Dê-me uma visão geral de busca dos últimos 28 dias: cliques, impressões, CTR e posição média, além da variação em relação aos 28 dias anteriores.

Experimente este prompt

Quais são minhas 20 principais consultas e 20 principais páginas de destino por cliques neste mês? Sinalize qualquer coisa que caiu mais de 20%.

Experimente este prompt

Encontre oportunidades de distância de destaque: consultas nas posições 8–20 com impressões relevantes. Quais três páginas devo melhorar primeiro?

Experimente este prompt

Verifique meus sitemaps no Google e no Bing. Há erros e quantas URLs enviadas estão indexadas?

O prompt quatro é o início de um fluxo de trabalho maior. Nosso guia de palavras-chave em distância de destaque transforma isso em um processo repetível.

Solução de problemas

Sintoma	Causa provável	Correção
"Não foi possível alcançar o servidor" no Claude ou ChatGPT	URL localhost ou HTTP simples	Use o endpoint HTTPS público do painel
401 Não autorizado em um editor	Cabeçalho bearer ausente ou digitado errado	Copie novamente a chave de API; o cabeçalho deve ser Authorization: Bearer <key>
Ferramentas carregam, mas não retornam propriedades	Nenhuma conta Google ou Bing conectada, ou ela está desativada	Conecte ou reative em Fontes de dados
Uma propriedade está ausente	A conta Google conectada não tem acesso a ela	Adicione essa conta como usuário no Search Console e reconecte
"Limite de uso atingido"	Cota mensal de chamadas de ferramentas esgotada	Aguarde a reinicialização ou faça upgrade na seção preços
Opção de conector personalizado ausente	Política do workspace	Peça ao administrador do workspace para permitir

Trabalha com agência? Quando a conexão funcionar, o fluxo de trabalho de relatórios com clientes de IA mostra como usar várias contas de clientes em uma única conversa.

Perguntas frequentes

Posso conectar o Google Search Console ao ChatGPT gratuitamente?

Sim. O plano gratuito do GSC MCP Server conecta uma conta Google ou Bing e inclui 30 chamadas de ferramentas por mês. Seu plano e as configurações do workspace do ChatGPT determinam se conectores personalizados estão disponíveis para você.

Por que o ChatGPT ou o Claude rejeitam minha URL localhost?

Claude e ChatGPT conectam-se pela própria nuvem, então não conseguem alcançar um servidor rodando no seu laptop. Use o endpoint hospedado, implante seu servidor auto-hospedado em um endereço HTTPS público ou use um túnel.

Preciso de uma chave de API?

Claude e ChatGPT fazem login via OAuth, então nenhuma chave é necessária. Editores de código e agentes de terminal como Cursor, VS Code, Claude Code e Codex geralmente usam uma chave de API enviada como cabeçalho Authorization: Bearer, que você cria na página de configuração do seu painel.

Posso conectar várias contas do Search Console?

Sim. Cada conta Google ou Bing que você conecta conta como uma conexão, e toda propriedade verificada dentro dela fica disponível. O plano Pro suporta 5 contas e o plano Agency suporta 20.

Meus dados são usados para treinar modelos de IA?

O GSC MCP Server não treina modelos com seus dados. Se o seu provedor de IA usa o conteúdo das conversas para treinamento depende das configurações desse provedor e do seu plano, então verifique os controles de dados deles.