Collega GSC tramite MCP

Come posso collegare i dati di Google Search Console tramite un MCP?

Punta qualsiasi assistente compatibile con MCP a https://mcp.gscwizard.com/mcp, autenticati con un accesso o una chiave API e leggerà i tuoi veri dati di Search Console. Le analisi girano lato server, quindi l'assistente riceve risposte finite invece di righe grezze.

Funziona con ChatGPT, Claude, Grok, Gemini CLI, Cursor, VS Code, Windsurf e qualsiasi altro client MCP.

La risposta breve

Bastano tre cose per collegarti, qualunque sia il client:

  1. Collega Search Console una volta sola dentro GSC Wizard. L'autorizzazione vive lì, non nell'assistente.
  2. Aggiungi l'endpoint https://mcp.gscwizard.com/mcp al tuo client.
  3. Autenticati: accedi con OAuth 2.1 dove il client lo supporta, oppure invia Authorization: Bearer gscw_live_...

Il server parla streamable HTTP, quindi la maggior parte dei client non richiede installazione locale, processo Node né bridge stdio.

Endpoint streamable HTTP

https://mcp.gscwizard.com/mcp

Accesso con OAuth 2.1

Per ChatGPT, l'interfaccia Claude Connectors, i connettori di Grok e Gemini CLI. Il client si registra da solo e ti guida in un accesso con Google. Niente da copiare o salvare.

Header con chiave API

Per i client con file di configurazione come Claude Code, Cursor, VS Code e Windsurf, e per Meta Muse: invia Authorization: Bearer gscw_live_...

Video

Guarda la configurazione dall'inizio alla fine

Configurazione e una prima domanda, dall'inizio alla fine: il connettore aggiunto, l'accesso fatto e un'analisi finita che torna al posto delle righe grezze.

Configurazione

Tre passaggi per collegarti

Gli stessi tre passaggi valgono per ogni client. Cambia solo la sintassi della configurazione.

  1. 1

    Collega le tue proprietà

    Accedi su tool.gscwizard.com con Google e scegli le proprietà di Search Console che vuoi rendere disponibili. È l'unico posto in cui si concede l'autorizzazione.

  2. 2

    Crea una chiave API, oppure prevedi di accedere

    Crea una chiave in Account → API keys per i client con file di configurazione. I client che supportano OAuth remoto (ChatGPT, l'interfaccia Claude Connectors, i connettori di Grok, Gemini CLI) hanno bisogno solo dell'URL.

  3. 3

    Aggiungi il server al tuo client

    Punta il client a https://mcp.gscwizard.com/mcp. I nomi delle chiavi cambiano da un client all'altro, ma l'URL e l'header bearer restano sempre gli stessi.

Copia e incolla

Configurazione per ogni client

Sostituisci gscw_live_... con la chiave che hai creato in Account → API keys.

Claude Code

Un comando, header con chiave API.

claude mcp add --transport http gsc-wizard \
  https://mcp.gscwizard.com/mcp \
  --header "Authorization: Bearer gscw_live_..."

Claude web e desktop

Settings → Connectors → Add custom connector. Incolla l'URL e lascia vuoti OAuth client ID e secret: Claude si registra da solo e ti fa accedere.

https://mcp.gscwizard.com/mcp

ChatGPT

Settings → Apps, modalità sviluppatore, aggiungi un'app con Authentication impostata su OAuth. Richiede un piano a pagamento. Non c'è un campo per la chiave API: ChatGPT non può inviare bearer token statici. Oppure salta tutto e installa l'app GSC Wizard dall'App Store di ChatGPT.

https://mcp.gscwizard.com/mcp

Grok

Vai su grok.com/connectors, clicca New Connector e scegli Custom. Incolla l'URL e completa l'accesso: Grok si registra da solo tramite OAuth 2.1, quindi non c'è nessun client ID o secret da compilare. Poi Grok scopre gli strumenti e li offre nelle tue conversazioni. Guida completa: collega GSC a Grok.

https://mcp.gscwizard.com/mcp

Microsoft Copilot Studio

Aggiungi al tuo agente uno strumento Model Context Protocol con OAuth 2.0 e tipo di configurazione Manual. Crea client ID e secret in Account → MCP API keys → Microsoft Copilot Studio, dove trovi anche tutti gli URL da incollare, poi salva l'URL di redirect che Copilot Studio ti dà su quella connessione. Guida completa: dati SEO in Microsoft Copilot Studio.

https://mcp.gscwizard.com/mcp

Meta Muse

Muse non ha una schermata di impostazioni per i connettori personalizzati: chiedigli in una conversazione di creare un'integrazione personalizzata verso l'URL qui sotto, HTTP remoto con autenticazione Bearer token. Crea una chiave API di sola lettura e incollala nel prompt sicuro delle credenziali di Muse, mai nella chat. Guide complete: il connettore SEO Muse per Search Console e il connettore Muse per Google Analytics.

URL:  https://mcp.gscwizard.com/mcp
Auth: Bearer gscw_live_... (read-only key)

Gemini CLI

Aggiungi a ~/.gemini/settings.json. Gemini CLI usa httpUrl per lo streamable HTTP.

{
  "mcpServers": {
    "gsc-wizard": {
      "httpUrl": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

OpenAI Codex

Aggiungi a ~/.codex/config.toml (condiviso da Codex CLI, estensione IDE e app) con la chiave in una variabile d'ambiente, oppure esegui codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp e accedi con codex mcp login gsc-wizard. Guida completa: GSC MCP per Codex.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"

Cursor

Aggiungi a ~/.cursor/mcp.json (globale) o .cursor/mcp.json in un progetto.

{
  "mcpServers": {
    "gsc-wizard": {
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

VS Code (modalità agente Copilot)

Aggiungi a .vscode/mcp.json. VS Code usa servers, non mcpServers, e può chiedere la chiave così resta fuori dal controllo di versione.

{
  "inputs": [
    { "id": "gscw-key", "type": "promptString", "description": "GSC Wizard MCP key", "password": true }
  ],
  "servers": {
    "gsc-wizard": {
      "type": "http",
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer ${input:gscw-key}" }
    }
  }
}

Windsurf

Aggiungi la configurazione a ~/.codeium/windsurf/mcp_config.json. Windsurf usa serverUrl per i server remoti.

{
  "mcpServers": {
    "gsc-wizard": {
      "serverUrl": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

Qualsiasi altro client MCP

Punta all'endpoint HTTP streamable e invia la tua chiave come bearer token. I nomi delle chiavi variano (transport oppure type, url oppure serverUrl), ma l'URL e l'header restano gli stessi.

URL:    https://mcp.gscwizard.com/mcp
Header: Authorization: Bearer gscw_live_...

Guide passo passo: ChatGPT, Claude, Gemini, Grok, Meta Muse. ChatGPT ha regole tutte sue (solo server remoti, OAuth al posto delle chiavi API, modalità sviluppatore dietro un piano a pagamento), tutte spiegate in connettori ChatGPT per i dati di Search Console nel 2026. Per Claude in particolare, il riferimento al server MCP di Search Console per Claude approfondisce i dettagli del protocollo che questa pagina riassume.

Autenticazione e scope

Ogni chiave ha uno scope scelto al momento della creazione, quindi decidi tu quanto può fare l'assistente.

Solo lettura

Interroga i dati ed esegui report. Una chiave di sola lettura non può fisicamente invocare uno strumento di scrittura, quindi la connessione è di sola lettura per costruzione. È la scelta giusta per un agente condiviso o per un'installazione rivolta ai clienti.

Lettura e scrittura

Tutto ciò che può fare una chiave di sola lettura, più le modifiche: aggiungere siti, inviare URL a IndexNow, gestire topic cluster, gruppi di contenuti e annotazioni. Ogni modifica viene registrata nel log di audit del tuo account.

Le chiavi vengono mostrate una sola volta alla creazione, si possono revocare in qualsiasi momento e raggiungono soltanto le proprietà di Search Console già collegate al tuo account GSC Wizard.

Perché questo MCP è diverso

L'analisi viene eseguita prima che il modello veda i dati

La maggior parte dei server MCP per la SEO restituisce all'assistente le righe grezze. I modelli linguistici non sono fatti per l'aritmetica su tabelle di grandi dimensioni: è lento, consuma token e gli errori sono difficili da individuare.

Molti meno token

Una sola chiamata allo strumento restituisce una risposta compatta e già elaborata, invece di decine di migliaia di righe che il modello deve leggere, tenere nel contesto e pagare.

Molto più veloce

Le aggregazioni girano sul data warehouse in millisecondi: un report SEO completo su un dataset da 4 GB in circa 4,4 secondi, invece di scorrere l'API di GSC un batch alla volta.

Niente errori

I calcoli sono deterministici. I numeri arrivano da query reali, quindi non c'è il rischio che il modello conti male o inventi i totali.

Dataset più grandi a portata di mano

Poiché il lavoro pesante non entra mai nella finestra di contesto, il server può analizzare mesi di dati e milioni di righe che non entrerebbero mai in un prompt.

Cosa può chiamare l'assistente

Il catalogo completo, con argomenti di esempio per ogni strumento, si trova su mcp.gscwizard.com.

Analisi della ricerca Query e pagine principali Variazioni di ranking Cannibalizzazione delle keyword Rilevamento del content decay Striking distance / page poaching Analisi della curva del CTR Punteggio delle opportunità Controllo URL in blocco Tracker dell'indicizzazione Invii IndexNow Gruppi di contenuti e topic cluster Suddivisioni per paese e dispositivo Rendimento delle sitemap Report SEO automatici Suddivisione brand vs non-brand Distribuzione delle posizioni Confronto migrazioni Report condivisibili per i clienti Google Analytics 4 Core Web Vitals (CrUX) Previsioni e rilevamento delle anomalie Bing Webmaster Tools

Se non si connette

Gli strumenti non compaiono

La maggior parte dei client legge le impostazioni MCP solo all'avvio. Dopo aver modificato un file di configurazione, chiudi e riapri completamente l'app (non solo la finestra).

401 non autorizzato

Controlla che l'header sia esattamente Authorization: Bearer gscw_live_..., che la chiave non sia stata revocata e che l'account abbia ancora un abbonamento o una prova attivi.

Claude Desktop segnala la configurazione come non valida

Il suo file di configurazione avvia solo server stdio locali, quindi una voce "type": "http" viene rifiutata. Usa l'interfaccia Connettori, oppure fai da ponte con mcp-remote: vedi la guida per Claude o il riferimento MCP di Search Console per Claude per capire perché il file di configurazione rifiuta una voce HTTP.

Uno strumento di scrittura restituisce 403

La chiave è di sola lettura. Crea una chiave di lettura e scrittura se l'assistente ha davvero bisogno di modificare i dati, oppure tieni la chiave di sola lettura e fai la modifica nell'app.

Manca una proprietà

L'MCP vede solo le proprietà già collegate in GSC Wizard. Aggiungila prima nell'app, poi chiedi all'assistente di elencare di nuovo i siti. Le proprietà di dominio hanno il prefisso sc-domain:.

Stessi dati, altri assistenti

Vuoi collegare un altro strumento AI?

Una sola connessione a Search Console, tutti gli assistenti. Scegli il tuo client e segui la guida passo passo.

Vedi anche la panoramica su Google Search Console MCP, il GA4 MCP, lo Yandex Webmaster MCP, il Merchant Center MCP, l'app ChatGPT (installala in ChatGPT), i connettori Meta Muse per Search Console e Google Analytics, la nostra rassegna dei migliori server MCP per la SEO e perché GSC Wizard è il miglior MCP per Search Console nel 2026.

Domande frequenti

Cos'è un server MCP?

Un server MCP (Model Context Protocol) è un connettore standard che permette a un assistente AI di leggere dati in tempo reale e chiamare strumenti. Un MCP per Google Search Console espone all'assistente le tue proprietà di Search Console, così può estrarre cifre reali di clic, impressioni, posizione e CTR invece di inventarle.

Quali client possono connettersi?

Qualsiasi client che supporti i server MCP remoti: ChatGPT, Claude e Claude Code, Grok, Gemini CLI, Cursor, VS Code in modalità agente Copilot, Windsurf, Gemini Enterprise e agenti personalizzati costruiti sugli SDK di OpenAI, Anthropic o Google. L'endpoint parla HTTP streamable.

Chiave API o OAuth: quale mi serve?

I client basati su file di configurazione (Claude Code, Cursor, VS Code, Windsurf, Gemini CLI) inviano una chiave API come header Authorization: Bearer. I client con un'interfaccia per i connettori (ChatGPT, l'app web e desktop di Claude, Grok) usano OAuth 2.1 e la registrazione dinamica del client, quindi basta accedere e lasciare vuoti client ID e secret.

Posso rendere la connessione di sola lettura?

Sì. Ogni chiave API ha uno scope scelto alla creazione. Una chiave di sola lettura non può invocare alcuno strumento di scrittura, quindi la connessione è di sola lettura per costruzione. Le chiavi di lettura e scrittura aggiungono modifiche come aggiungere siti, inviare URL a IndexNow e gestire i cluster, e ognuna di queste viene registrata nel log di audit.

Quanto sono aggiornati i dati?

Le letture dal warehouse restano indietro di circa due giorni rispetto a Search Console stessa, e ogni risposta indica la data fino a cui i dati sono consolidati. Le richieste che il warehouse non può soddisfare passano automaticamente all'API live di GSC, e ogni risposta dice da quale fonte proviene.

Perché non lasciare che il modello legga direttamente l'API grezza di GSC?

La maggior parte degli MCP per Search Console scorre l'API di GSC un batch lento alla volta e riversa le righe grezze nel contesto del modello, il che è lento, incappa nel campionamento e nei limiti di righe e lascia spazio alle allucinazioni. GSC Wizard calcola ogni analisi in SQL lato server e restituisce il risultato finito: un report SEO completo su un dataset da 4 GB in circa 4,4 secondi.

Uno strumento non compare nel mio client. E adesso?

Riavvia completamente il client dopo aver modificato la configurazione, perché la maggior parte dei client legge le impostazioni MCP solo all'avvio. Poi controlla che la chiave sia ancora valida e non revocata, che tu abbia usato il percorso /mcp nell'URL e che lo strumento che vuoi non sia uno strumento di scrittura bloccato da una chiave di sola lettura.

Esiste un'opzione HTTP semplice?

Sì. Lo stesso server espone una superficie REST su https://mcp.gscwizard.com/v1 con le stesse chiavi, gli stessi scope, gli stessi limiti di frequenza e lo stesso log di audit, con un documento OpenAPI 3,1 su /v1/openapi.json generato dagli stessi schemi con cui il server valida le richieste.

Collega i tuoi dati di Search Console a qualsiasi client AI

Un solo endpoint, due modi di autenticarsi e risposte già elaborate invece di righe grezze. Lo configuri in circa due minuti.

Consigli su Search Console nella tua casella di posta

Workflow pratici per GSC e GA4, aggiornamenti del prodotto ed esperimenti SEO. Niente spam, puoi annullare l'iscrizione quando vuoi.