Docs di GSC Magic

Cos’è GSC Magic

GSC Magic è un server MCP in cloud. Accedi una volta, aggiungi un URL al tuo client AI e l’agente può leggere direttamente i tuoi dati di ricerca, invece di lavorare con export CSV e screenshot.

Nel frattempo la dashboard su app.gscmagic.com mostra gli stessi dati in forma di grafici, conserva uno storico più lungo dei 16 mesi di Google, invia avvisi e registra tutto ciò che fanno i tuoi agenti.

Guida rapida

1. Crea il tuo account. Apri la dashboard e continua con Google, oppure crea un account con e-mail e password (confermerai l’indirizzo via e-mail). Usa l’account Google proprietario delle tue proprietà di Search Console.
2. Consenti l’accesso. Il primo accesso chiede a Google, una sola volta, Search Console (lettura e scrittura) e Google Analytics 4 in sola lettura. I tool di scrittura sono disponibili solo su Pro e Agency e puoi disattivarli in Settings → Write access.
3. Importa i tuoi siti. Nella schermata Welcome scegli le proprietà da aggiungere. GSC Magic mostra prima le più trafficate e rispetta il limite di siti del tuo piano. I siti Bing e le proprietà GA4 con lo stesso host vengono associati automaticamente.
4. Collega il tuo client AI. Segui Client AI qui sotto. L’endpoint è https://mcp.gscmagic.com/mcp.
5. Chiedi qualcosa. Parti da «Elenca i miei siti in GSC Magic.» Poi prova un prompt tra i Prompt di esempio.

La pagina Connect della dashboard ha le stesse istruzioni, con pulsanti a un clic e un test di connessione.

Client AI

L’endpoint è lo stesso ovunque:

https://mcp.gscmagic.com/mcp

I client che supportano OAuth ti fanno accedere tramite una pagina di GSC Magic. Per quelli che non lo supportano, usa un token di accesso.

Claude (claude.ai, desktop e mobile)

1. Usa Add to Claude: apre GSC Magic nella directory dei connettori di Claude. Oppure apri Customize → Connectors → Add custom connector, chiamalo GSC Magic e incolla l’endpoint.
2. Clicca Connect accanto a GSC Magic, continua con Google (o e-mail) e consenti l’accesso.
3. In una nuova chat attiva GSC Magic da + → Connectors e chiedi «Elenca i miei siti in GSC Magic.»

Sui piani Team ed Enterprise solo un Owner può aggiungere il connettore (Organization settings → Connectors → Add → Custom); i membri poi cliccano Connect da soli. I connettori aggiunti sul web compaiono nelle app desktop e mobile.

ChatGPT

1. Su chatgpt.com apri Plugins, fai clic su + e scegli Add custom MCP server. Non serve la modalità sviluppatore.
2. Chiamalo GSC Magic, incolla l’URL del server indicato sopra e scegli OAuth. Lascia vuoti client ID e secret, accetta l’avviso sui rischi e fai clic su Create.
3. Accedi con Google (o con e-mail e password di GSC Magic) quando ChatGPT apre la pagina di GSC Magic, poi digita @ in una nuova chat e scegli GSC Magic.

I server MCP personalizzati richiedono un piano ChatGPT a pagamento; su Business solo i proprietari e gli admin del workspace possono aggiungerne uno. ChatGPT non ha un campo per un’intestazione personalizzata, quindi non può usare un token di accesso. Se il tuo account mostra ancora il vecchio flusso <em>Settings → Apps → Create app</em>, usa lì lo stesso nome, lo stesso URL e le stesse impostazioni OAuth.

Claude Code

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Poi digita /mcp, scegli gsc-magic e seleziona Authenticate. Con un token invece dell’accesso dal browser:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Cursor

Aggiungi questo a ~/.cursor/mcp.json, poi clicca Connect accanto a gsc-magic in Settings → MCP:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp"
    }
  }
}

Le versioni più vecchie di Cursor concludono l’accesso su cursor://, che GSC Magic non accetta. Lì usa un token:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp",
      "headers": {
        "Authorization": "Bearer gsm_YOUR_TOKEN"
      }
    }
  }
}

VS Code, Windsurf e altri

Funziona qualsiasi client che parli MCP remoto su Streamable HTTP. Dagli l’endpoint e, se non supporta OAuth, questa intestazione di richiesta:

Authorization: Bearer gsm_YOUR_TOKEN

La pagina Connect della dashboard elenca snippet già pronti per VS Code, Windsurf, Hermes Agent, OpenClaw, Grok e DeepSeek.

Token di accesso

Un token di accesso (gsm_…) permette a un client di collegarsi senza accedere dal browser. È adatto a script, strumenti di automazione e client senza OAuth.

• Creane uno nella dashboard da Connect → Access tokens (proprietario o admin del workspace). Il token completo viene mostrato una sola volta. Conservalo nella configurazione del client, mai in una chat.
• I token scadono dopo 365 giorni per impostazione predefinita. Puoi scegliere una durata diversa fino a 730 giorni, oppure nessuna scadenza.
• Spunta Read-only per rendere un token incapace di scrivere, qualunque cosa consenta il tuo piano.
• Un token funziona solo sull’endpoint MCP, non sull’API della dashboard, e può essere revocato in qualsiasi momento. La revoca ha effetto immediato.
• Il pulsante Test connection nella pagina Connect verifica che un endpoint e un token funzionino.

Fonti di dati

Connesso non significa associato. L’accesso a GA4 o a una chiave Bing rende le proprietà soltanto individuabili. Per vedere i dati nella pagina Overview, associa una proprietà GA4 e un sito Bing a ogni sito in Sites. Sources mostra quanti siti sono associati.

Ogni fonte ha Reconnect e Disconnect. Scollegare GA4 interrompe la lettura da parte di GSC Magic ed elimina le righe GA4 che abbiamo conservato; la tua connessione Google e Search Console restano invariate.

Dashboard

Storico. Dopo aver aggiunto un sito, GSC Magic recupera fino a 16 mesi di dati giornalieri (14 giorni su Free), poi li aggiorna ogni sei ore. Passando a un piano superiore si recuperano anche i mesi più vecchi. Puoi esportare o eliminare il tuo storico conservato in qualsiasi momento.

Avvisi e riepilogo

Su Pro e Agency, GSC Magic controlla i tuoi siti dopo ogni sincronizzazione e ti avvisa quando qualcosa richiede attenzione. Gli avvisi arrivano via e-mail al proprietario del workspace. Ogni messaggio ha un link per annullare l’iscrizione.

• Calo di traffico: una pagina ha perso una grande quota dei suoi clic (30% per impostazione predefinita).
• Indicizzazione: una pagina che aveva traffico ha smesso di comparire.
• Cannibalizzazione: due tue pagine hanno iniziato a dividersi una query.
• Posizionamento: una query importante è scesa di diverse posizioni.
• Traffico AI: le sessioni da assistenti AI sono schizzate in alto (richiede GA4).

Puoi modificare le soglie, disattivare le regole ed eliminarle (con un Annulla disponibile per qualche secondo). Un riepilogo settimanale sintetizza i tuoi siti. Su Free, la scheda What changed della Overview mostra in anteprima cosa troverebbero queste regole. Ogni rilevamento viene segnalato una volta a settimana.

Prompt di esempio

Sostituisci example.com con il tuo sito. Il tuo agente sceglie da solo i tool giusti.

Altre idee nella libreria di prompt.

Riferimento dei tool

I tool contrassegnati da scrittura cambiano qualcosa in Google, Bing o IndexNow. Vengono offerti all’agente solo su Pro e Agency mentre la modalità scrittura è attiva in Settings (si attiva non appena, all’accesso, Google concede i permessi completi per Search Console) e la fonte lo permette. Tutto il resto è in sola lettura.

Piani e limiti

• 7 giorni di prova Pro sui nuovi account, senza bisogno di carta. Alla scadenza l’account torna a Free. Una prova per indirizzo e-mail.
• Ogni chiamata a un tool conta, comprese quelle fallite. Il limite giornaliero si azzera a mezzanotte UTC.
• Se un piano termina e hai più siti di quelli consentiti dal nuovo piano, la dashboard ti chiede quali tenere e l’endpoint MCP resta in pausa finché non scegli.
• Pagamenti e fatture sono gestiti da Polar. Puoi annullare in qualsiasi momento; il piano resta attivo fino alla fine del periodo pagato.

Team e ruoli

Il piano Agency include cinque posti, proprietario compreso. Tutti lavorano sul workspace, sui dati e sul piano del proprietario.

I gruppi cliente limitano una persona a siti selezionati. Un membro o un admin di un gruppo vede solo quei siti nella dashboard, negli avvisi e tramite MCP, e nient’altro. I sottodomini contano come siti separati, quindi puoi dare a.com a un cliente e blog.a.com a un altro. Gli inviti arrivano via e-mail e restano validi sette giorni.

Sicurezza e privacy

• Le credenziali Google e Bing sono cifrate a riposo. I token di accesso sono conservati solo come hash.
• Il tuo agente vede solo i dati degli account che hai collegato, limitati al tuo workspace e al tuo ruolo.
• Gli account Free sono in sola lettura. Su Pro e Agency i tool di scrittura sono disponibili finché il proprietario non disattiva la modalità scrittura in Settings; i membri sono sempre in sola lettura e ogni token può essere forzato in sola lettura.
• Le sessioni scadono dopo 14 giorni di inattività. Le azioni sensibili, come l’eliminazione dell’account, richiedono un accesso recente.
• Esporta tutto ciò che conserviamo su di te da Settings, oppure elimina lì il tuo account e i tuoi dati. Gli abbonamenti a pagamento attivi vanno prima annullati.

I dettagli sono nell’informativa sulla privacy e nei termini. Per segnalare una vulnerabilità scrivi a support@gscmagic.com.

Risoluzione dei problemi

Sei ancora bloccato? Scrivi a support@gscmagic.com indicando il client che usi e il messaggio di errore. Non includere mai un token di accesso.

Risposte rapide