Google Search Console, Bing e GA4 per qualsiasi client MCP

GSC Magic parla il Model Context Protocol standard su Streamable HTTP. Qualsiasi client che supporti i server remoti può collegarsi: Hermes Agent, OpenClaw, Grok, Zed, framework di agenti e il tuo codice.

Ultimo aggiornamento: 2026-10-30

In breve

GSC Magic è un server MCP remoto standard su https://mcp.gscmagic.com/mcp (Streamable HTTP) con registrazione dinamica del client OAuth 2.1 e token bearer, quindi qualsiasi client Model Context Protocol, framework di agenti o script può collegarsi e chiamare i suoi 70 tool per Search Console, Bing, GA4 e report.

Configurazione in 3 passaggi

  1. Endpoint: https://mcp.gscmagic.com/mcp (POST per JSON-RPC, trasporto Streamable HTTP).
  2. Autenticazione: OAuth 2.1 con registrazione dinamica del client (discovery su /.well-known/oauth-protected-resource), oppure un token di accesso bearer creato nella dashboard.
  3. Chiama tools/list per vedere cosa consentono il tuo piano e i tuoi permessi, poi tools/call.
curl con un token di accesso
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"}'

Da sapere

  • Ogni tool dichiara readOnlyHint, destructiveHint e openWorldHint, così i client possono mostrare cosa è sicuro.
  • Gli schemi dei tool evitano union, $ref e additionalProperties per caricarsi in ogni client, compresi i più rigidi.
  • I risultati sono JSON compatto con flag di troncamento espliciti; i grandi export non vengono mai scritti su disco nel servizio in cloud.

Cosa chiedere una volta collegato

  • «Elenca le mie proprietà di Search Console e quella con più clic negli ultimi 28 giorni.»
  • «Quali query sono in posizione 4–10 con più impressioni? Suggerisci modifiche ai title.»
  • «Confronta i clic di questo mese con quelli del mese scorso per pagina e dimmi cosa si è mosso.»
  • «Quali URL della mia sitemap non sono indicizzati e cosa dice il controllo?»
  • «Quante sessioni sono arrivate da ChatGPT, Perplexity e Claude il mese scorso, e su quali pagine?»

Altri nei 25 prompt SEO per agenti AI; l’elenco completo dei tool è nella pagina dei tool.

Risoluzione dei problemi

POST /mcp restituisce 401 prima che io possa registrarmi.

È previsto: il 401 include un’intestazione WWW-Authenticate che punta a /.well-known/oauth-protected-resource/mcp. Seguila per scoprire il server di autorizzazione, registrati con /register, poi autorizza con PKCE. Oppure salta OAuth e invia come Bearer un token di accesso della dashboard.

Il client non riesce a registrarsi: redirect_uri rifiutato.

La registrazione dinamica accetta indirizzi loopback e le origini di callback note di Claude e ChatGPT. Per altri client in cloud usa un token di accesso, oppure contatta il supporto per inserire l’origine nella allow-list.

tools/list restituisce meno tool del catalogo.

L’elenco viene calcolato per account: piano, scope Google concessi, chiavi Bing e IndexNow, modalità scrittura e gruppo cliente lo filtrano tutti. Un account Free con solo Google collegato vede i tool di Search Console, dei report e di GA4.

Errori SSE o di streaming.

Invia Accept: application/json, text/event-stream e mantieni l’intestazione Mcp-Session-Id se il tuo client usa le sessioni. Il server è stateless, quindi riconnettersi è sempre sicuro.

Domande su Qualsiasi client MCP

Esiste una versione locale (stdio)?

Sì. Lo stesso server gira in locale con le tue credenziali Google per chi lo preferisce; il servizio in cloud è la strada consigliata perché non richiede un progetto Google Cloud.

Quali sono i rate limit?

I limiti del piano si applicano per account (Free: 200 chiamate al mese, 10 al giorno). L’endpoint ha anche un limite per IP generoso, dimensionato sugli indirizzi condivisi di Claude e ChatGPT.

Altri client

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