Google Search Console, Bing e GA4 para qualquer cliente MCP

O GSC Magic fala o Model Context Protocol padrão via Streamable HTTP. Qualquer cliente compatível com servidores remotos pode se conectar: Hermes Agent, OpenClaw, Grok, Zed, frameworks de agentes e o seu próprio código.

Última atualização: 2026-10-30

Em resumo

O GSC Magic é um servidor MCP remoto padrão em https://mcp.gscmagic.com/mcp (Streamable HTTP) com registro dinâmico de clientes do OAuth 2.1 e bearer tokens, de modo que qualquer cliente do Model Context Protocol, framework de agentes ou script pode se conectar e chamar suas 70 ferramentas de Search Console, Bing, GA4 e relatórios.

Configuração em 3 passos

  1. Endpoint: https://mcp.gscmagic.com/mcp (POST para JSON-RPC, transporte Streamable HTTP).
  2. Autenticação: OAuth 2.1 com registro dinâmico de clientes (descoberta em /.well-known/oauth-protected-resource) ou um token de acesso bearer criado no painel.
  3. Chame tools/list para ver o que o seu plano e as suas permissões permitem e, depois, tools/call.
curl com um token de acesso
curl -X POST https://mcp.gscmagic.com/mcp \
  -H "Authorization: Bearer gsm_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Bom saber

  • Cada ferramenta declara readOnlyHint, destructiveHint e openWorldHint, para que os clientes possam mostrar o que é seguro.
  • Os esquemas das ferramentas evitam unions, $ref e additionalProperties para carregar em qualquer cliente, inclusive nos mais rígidos.
  • Os resultados são JSON compacto com indicadores explícitos de truncamento; exportações grandes nunca são gravadas em disco no serviço hospedado.

O que perguntar depois de conectar

  • “Liste minhas propriedades do Search Console e a que teve mais cliques nos últimos 28 dias.”
  • “Quais consultas estão nas posições 4–10 com mais impressões? Sugira mudanças de título.”
  • “Compare os cliques deste mês com os do mês passado por página e diga o que mudou.”
  • “Quais URLs do meu sitemap não estão indexadas e o que diz a inspeção?”
  • “Quantas sessões vieram do ChatGPT, do Perplexity e do Claude no mês passado, e para quais páginas?”

Mais em 25 prompts de SEO para agentes de IA; a lista completa de ferramentas está na página de ferramentas.

Solução de problemas

POST /mcp retorna 401 antes de eu conseguir me registrar.

Isso é esperado: o 401 traz um cabeçalho WWW-Authenticate apontando para /.well-known/oauth-protected-resource/mcp. Siga-o para descobrir o servidor de autorização, registre-se em /register e autorize com PKCE. Ou pule o OAuth e envie um token de acesso do painel como Bearer.

O cliente não consegue se registrar: redirect_uri rejeitado.

O registro dinâmico aceita endereços de loopback e as origens de callback conhecidas do Claude e do ChatGPT. Para outros clientes hospedados, use um token de acesso ou fale com o suporte para incluir a origem na lista de permitidos.

tools/list retorna menos ferramentas do que o catálogo.

A lista é calculada por conta: plano, escopos do Google concedidos, chaves do Bing e do IndexNow, modo de escrita e grupo de clientes a filtram. Uma conta Free com apenas o Google conectado vê as ferramentas de Search Console, relatórios e GA4.

Erros de SSE ou de streaming.

Envie Accept: application/json, text/event-stream e mantenha o cabeçalho Mcp-Session-Id se o seu cliente usa sessões. O servidor não guarda estado, então reconectar é sempre seguro.

Perguntas sobre Qualquer cliente MCP

Existe uma versão local (stdio)?

Sim. O mesmo servidor roda localmente com as suas próprias credenciais do Google, para quem prefere assim; o serviço hospedado é o caminho recomendado porque não exige projeto no Google Cloud.

Quais são os limites de taxa?

Os limites do plano valem por conta (Free: 200 chamadas por mês, 10 por dia). O endpoint também tem um limite por IP generoso, dimensionado para os endereços compartilhados do Claude e do ChatGPT.

Outros clientes

Claude · ChatGPT · Claude Code · Cursor · Windsurf · VS Code · Gemini CLI · Zed · Cline · Continue · n8n · LibreChat · goose · Warp · Raycast · OpenClaw · Hermes Agent · Grok