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
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
- Endpoint: https://mcp.gscmagic.com/mcp (POST per JSON-RPC, trasporto Streamable HTTP).
- 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.
- Chiama tools/list per vedere cosa consentono il tuo piano e i tuoi permessi, poi tools/call.
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