Google Search Console, Bing e GA4 in Windsurf

L’agente Cascade di Windsurf supporta i server MCP remoti. GSC Magic si collega con un token di accesso in un’intestazione.

Ultimo aggiornamento: 2026-10-30

In breve

Crea un token di accesso in sola lettura nella dashboard di GSC Magic, aggiungi il server a mcp_config.json di Windsurf con serverUrl https://mcp.gscmagic.com/mcp e un’intestazione Authorization: Bearer, ricarica i server MCP e Cascade potrà interrogare i tuoi dati di Search Console, Bing e GA4.

Configurazione in 3 passaggi

  1. Crea un account GSC Magic, collega Google, poi crea un token di accesso in Connect → Access tokens (va bene anche in sola lettura).
  2. Aggiungi lo snippet qui sotto alla configurazione MCP di Windsurf (mcp_config.json).
  3. Ricarica i server MCP in Cascade e chiedi le tue proprietà di Search Console.
mcp_config.json
{
  "mcpServers": {
    "gsc-magic": {
      "serverUrl": "https://mcp.gscmagic.com/mcp",
      "headers": { "Authorization": "Bearer gsm_YOUR_TOKEN" }
    }
  }
}

Da sapere

  • I token possono essere in sola lettura e scadere dopo un certo numero di giorni. Revocali quando vuoi dalla dashboard.
  • Sul Free il tuo agente può solo leggere. Su Pro e Agency i tool di scrittura sono disponibili e il proprietario può disattivare la modalità scrittura in «Settings» con un clic.

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

Cascade elenca il server ma ogni chiamata restituisce 401.

Il token è stato revocato, è scaduto o è stato incollato con uno spazio. Creane uno nuovo e sostituisci l’intero valore di Bearer.

Il server non compare dopo la modifica di mcp_config.json.

Usa il pulsante Refresh nel pannello MCP o riavvia Windsurf, e controlla che il JSON sia valido.

Troppi tool per il limite del client.

Windsurf limita il numero totale di tool tra i server. Disattiva i server che non usi; GSC Magic espone solo i tool consentiti dal tuo piano e dalle tue chiavi.

Domande su Windsurf

Perché un token e non OAuth?

L’indirizzo di ritorno OAuth di Windsurf non è ancora nella allow-list di GSC Magic. Un token in sola lettura è l’alternativa sicura e si crea in un minuto.

Altri client

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