Gemini legge i tuoi dati di Search Console tramite lo stesso endpoint MCP usato da ogni altro assistente. Incolla mcp.gscwizard.com nell'app Gemini (USA, account personali), in Antigravity CLI, in Gemini Enterprise o nella Gemini API, e Gemini lavora su clic, impressioni, posizione e CTR reali.
Endpoint: https://mcp.gscwizard.com/mcp
La risposta breve
Aggiungi il server MCP di GSC Wizard alla versione di Gemini che usi:
https://mcp.gscwizard.com/mcp. Google la offre agli adulti negli USA con account Google personali.serverUrl in mcp_config.json.tools con il Google Gen AI SDK, oppure chiama direttamente l'interfaccia REST su /v1.Non sai quale puoi usare? La tabella qui sotto mostra a chi è destinata ogni via.
È Google a decidere chi ottiene quale versione, non GSC Wizard. I requisiti qui sotto vengono dalle pagine di aiuto di Google.
| Via | Chi può usarla | Accesso | Configurazione |
|---|---|---|---|
| App Gemini | Adulti (18+) negli USA, account Google personale, inglese, Keep Activity attivo. Non account di lavoro o scuola. | OAuth, automatico. Nessuna chiave da copiare. | Incolla un solo URL. Circa un minuto. |
| Antigravity CLI e IDE | Sviluppatori, ovunque. La stessa Gemini CLI ora è disponibile solo per clienti enterprise e utenti con chiave API a pagamento. | Header con chiave API, oppure OAuth. | Una voce JSON. |
| Gemini Enterprise | Organizzazioni. Un admin del team o del cloud aggiunge il server. | Solo OAuth 2.0. Le chiavi API non sono accettate. | Crea un client OAuth, poi compila il modulo del connettore. |
| Gemini API | Sviluppatori che creano il proprio agente. | Header con chiave API. | Poche righe con il Gen AI SDK. |
Una dimostrazione dello stesso server MCP a cui si collega Gemini: aggiunta, autenticazione e richieste di vera analisi di Search Console in linguaggio naturale.
Gemini ora permette di aggiungere il tuo server MCP come app personalizzata. GSC Wizard supporta la registrazione dinamica del client, quindi Gemini si registra da solo e non c'è nessuna chiave API o client secret da copiare.
Secondo la pagina di aiuto di Google per le app personalizzate, devi avere almeno 18 anni ed essere negli USA, aver effettuato l'accesso con un account Google personale (gli account di lavoro e scuola per ora non sono supportati), usare Gemini in inglese e avere Keep Activity attivo. L'app si aggiunge nella web app su gemini.google.com e poi funziona anche nell'app mobile. Se non vedi Add a custom app, una di queste condizioni non è soddisfatta: usa Antigravity CLI, Gemini Enterprise o l'API qui sotto.
Accedi su tool.gscwizard.com con l'account Google che ha accesso alle tue proprietà di Search Console. Gemini leggerà esattamente le proprietà che colleghi lì.
Vai su gemini.google.com da un computer, clicca Settings in basso, poi Connected Apps. Sotto Custom apps clicca Add a custom app e inserisci https://mcp.gscwizard.com/mcp. Mantieni /mcp alla fine: il dominio senza percorso non risponde alle richieste MCP.
Clicca Next e segui i passaggi. Gemini ti porta a una schermata di accesso e consenso di GSC Wizard. Puoi lasciare vuote le credenziali sotto Advanced features, perché servono solo per i server che non possono registrare un client automaticamente.
In una nuova chat scrivi @, scegli l'app GSC Wizard e chiedi qualcosa come “Quali pagine di example.com hanno perso più clic negli ultimi 28 giorni?”. Gemini ti chiede conferma prima di eseguire qualsiasi azione di scrittura.
Google precisa di non controllare, monitorare né proteggere i server MCP di terze parti e che Gemini può condividere il contenuto delle chat con un'app collegata. GSC Wizard restituisce solo i dati di Search Console, GA4 e Bing che hai collegato al tuo account. Puoi disattivare, scollegare o rimuovere l'app in qualsiasi momento in Settings → Connected Apps.
Antigravity è l'ambiente per agenti di Google e il successore di Gemini CLI per gli account individuali. Legge i server MCP remoti da un file JSON e funziona ovunque funzioni Antigravity, senza restrizioni solo-USA lato MCP.
Accedi su tool.gscwizard.com, collega le tue proprietà di Search Console, poi crea una chiave in Account → API keys. Preferisci OAuth a una chiave salvata? Salta questo passaggio e vedi la nota sotto la configurazione.
Modifica ~/.gemini/config/mcp_config.json per tutti i progetti, oppure .agents/mcp_config.json dentro un repository per limitarlo a quello. I server remoti usano la chiave serverUrl: la documentazione di Google dice che le chiavi più vecchie url e httpUrl lì non sono supportate.
Scrivi /mcp nel pannello del prompt per confermare che il server sia connesso e vederne gli strumenti, poi fai domande sul tuo sito in linguaggio naturale.
~/.gemini/config/mcp_config.json
{
"mcpServers": {
"gsc-wizard": {
"serverUrl": "https://mcp.gscwizard.com/mcp",
"headers": {
"Authorization": "Bearer gscw_live_..."
}
}
}
}Per accedere invece di salvare una chiave, ometti il blocco headers. Poiché GSC Wizard supporta la registrazione dinamica del client, Antigravity esegue il flusso OAuth quando clicchi Authenticate accanto al server in Agent settings → Customizations.
Google ha smesso di servire Gemini CLI agli account individuali gratuiti, Google AI Pro e Ultra il 18 giugno 2026 e indirizza quegli utenti ad Antigravity CLI. I clienti Enterprise e gli utenti con chiave API a pagamento mantengono Gemini CLI e per loro l'endpoint si inserisce con un header bearer.
gemini mcp add --transport http \
--header "Authorization: Bearer gscw_live_..." \
gsc-wizard https://mcp.gscwizard.com/mcpOppure aggiungi una voce a ~/.gemini/settings.json con "httpUrl": "https://mcp.gscwizard.com/mcp" e lo stesso oggetto headers. Fai riferimento a una variabile d'ambiente come $GSCW_KEY invece di incollare la chiave, così resta fuori dal controllo di versione.
Gemini Enterprise supporta server MCP personalizzati, quindi un admin può rendere disponibili i dati di Search Console agli agenti di tutta l'organizzazione. Google documenta solo due opzioni di accesso per questi server, No authentication e OAuth 2.0, quindi un header statico con chiave API qui non funziona. GSC Wizard si connette tramite OAuth 2.0 con un client che crei tu.
Gemini Enterprise riporta sempre gli utenti a https://vertexaisearch.cloud.google.com/oauth-redirect, quindi registra un client per quell'URL di redirect. La risposta contiene un client ID (che inizia con gscwc_) e un client secret mostrato una sola volta, quindi salvalo prima di continuare.
Nella Business edition accedi su business.gemini.google, apri Settings & help, scegli il tuo team, poi Manage team → Connected apps → Add MCP Server. Con la Google Cloud console apri Gemini Enterprise, vai su Data stores → Create data store, cerca Custom MCP Server e clicca Add MCP server.
Scegli OAuth 2.0, compila la tabella qui sotto e clicca Verify Auth. Poi scegli una location, dai un nome al connettore e crealo.
Google lascia disattivate le nuove connessioni MCP personalizzate. Nella Business edition abilita la connessione nella pagina Connectors. Nella Cloud console apri il data store, scegli Actions → Reload custom actions, seleziona gli strumenti che vuoi e clicca Enable actions.
Passaggio 1: registra il client
curl -X POST https://tool.gscwizard.com/api/oauth/register \
-H "Content-Type: application/json" \
-d '{
"client_name": "Gemini Enterprise",
"redirect_uris": ["https://vertexaisearch.cloud.google.com/oauth-redirect"],
"token_endpoint_auth_method": "client_secret_post",
"grant_types": ["authorization_code", "refresh_token"]
}'Passaggio 3: i valori
| Campo di Gemini Enterprise | Valore |
|---|---|
| URL del server MCP | https://mcp.gscwizard.com/mcp |
| Autenticazione | OAuth 2.0 |
| URL di autorizzazione | https://tool.gscwizard.com/oauth/authorize |
| URL del token | https://tool.gscwizard.com/api/oauth/token |
| Client ID e secret | Dalla risposta del passaggio 1 (gscwc_ e il secret) |
| Scope | mcp:read per l'accesso in sola lettura, oppure mcp:read mcp:write |
| PKCE | Attivalo ovunque il modulo offra l'opzione: il server di autorizzazione di GSC Wizard richiede PKCE |
L'URL di autorizzazione non contiene /api/ e l'URL del token sì; entrambi sono corretti. Sul percorso Cloud console, un amministratore ha inoltre bisogno del ruolo Discovery Engine Editor, deve derogare alla policy dell'organizzazione che per impostazione predefinita blocca i data store MCP personalizzati e deve consentire i domini mcp.gscwizard.com e tool.gscwizard.com. Le pagine di configurazione di Google coprono entrambi i percorsi: la guida alla Cloud console e la guida alla Business edition.
Stai creando un agente invece di chattare? Il Google Gen AI SDK può passare una sessione client MCP direttamente nell'elenco tools, così Gemini chiama direttamente gli strumenti di GSC Wizard.
Python: google-genai con una sessione MCP
from google import genai
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
URL = "https://mcp.gscwizard.com/mcp"
HEADERS = {"Authorization": "Bearer gscw_live_..."}
MODEL = "gemini-3.1-pro" # or whichever Gemini model you use
async with streamablehttp_client(URL, headers=HEADERS) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
response = await genai.Client().aio.models.generate_content(
model=MODEL,
contents="Which pages on example.com lost the most clicks in the last 28 days?",
config=genai.types.GenerateContentConfig(tools=[session]),
)
print(response.text)Se preferisci non parlare MCP, le stesse chiavi, gli stessi scope e gli stessi rate limit servono un'interfaccia REST semplice su https://mcp.gscwizard.com/v1, con un documento OpenAPI 3,1 generato su /v1/openapi.json che puoi dare a Gemini come specifica per il function calling.
Al momento Google offre le app personalizzate nell'app Gemini solo agli adulti negli USA con account Google personali, quindi l'opzione potrebbe non comparire per te. Antigravity CLI, Gemini Enterprise e la Gemini API non sono legati a questa regola. Se vuoi solo passare i numeri a un collega, un link a un report condiviso o un export CSV di GSC Wizard funziona in qualsiasi chat.
Chiedi a Gemini come collegare Search Console e spesso nomina piattaforme di connettori dati come Windsor.ai e Supermetrics. Risolvono un problema diverso, quindi la scelta dipende da ciò che ti serve.
Per un confronto diretto tra strumenti di reporting e pipeline, vedi la nostra raccolta dei migliori strumenti di reporting SEO e la guida ai connettori per i dati di Search Console.
Ogni analisi viene eseguita lato server sul data warehouse, quindi l'assistente legge un risultato finito invece di fare calcoli su righe grezze.
Una sola connessione a Search Console, tutti gli assistenti. Scegli il tuo client e segui la guida passo passo.
L'app GSC Wizard, un connettore personalizzato o la Responses API.
Leggi la guidaUn connettore personalizzato nell'app, o un solo comando in Claude Code.
Leggi la guidaUn connettore MCP personalizzato su grok.com/connectors, oppure la xAI API.
Leggi la guidaL'endpoint, entrambe le modalità di autenticazione e una configurazione per ogni client.
Leggi la guidaVedi anche la panoramica del 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 la guida 2026 ai connettori di ChatGPT per i dati di Search Console.
Sì, se rispetti i requisiti di Google: hai almeno 18 anni e sei negli USA, hai effettuato l'accesso con un account Google personale (non di lavoro o scuola), usi l'inglese e hai Keep Activity attivo. Apri gemini.google.com, vai su Settings, poi Connected Apps, clicca Add a custom app e inserisci https://mcp.gscwizard.com/mcp. Gemini si registra da solo sul server e ti porta attraverso un accesso a GSC Wizard. Fuori da questi requisiti, usa Antigravity CLI, Gemini Enterprise o la Gemini API.
Al momento Google offre le app personalizzate solo agli adulti negli USA, solo con account Google personali, solo in inglese e solo con Keep Activity attivo, e si aggiungono nella web app su gemini.google.com. Se sei fuori dagli USA o usi un account di lavoro o scuola, l'opzione non compare. Usa invece Antigravity CLI, Gemini Enterprise o la Gemini API.
No. Google documenta due opzioni di autenticazione per un server MCP personalizzato in Gemini Enterprise, No authentication e OAuth 2.0, e nessuna accetta un header Authorization statico. Collega GSC Wizard con OAuth 2.0 usando un client ID e un secret creati per l'URL di redirect di Gemini Enterprise.
Sì. Aggiungi una voce con serverUrl e un oggetto headers a ~/.gemini/config/mcp_config.json (o a .agents/mcp_config.json dentro un progetto). Per i server che supportano la registrazione dinamica del client, come GSC Wizard, puoi omettere gli headers e autenticarti con OAuth dalle impostazioni dell'agente.
Solo per alcuni account. Google ha smesso di servire Gemini CLI agli account individuali gratuiti, Google AI Pro e Ultra il 18 giugno 2026 e indirizza quegli utenti ad Antigravity CLI. Gemini CLI resta disponibile per i clienti enterprise e per gli utenti con chiave API a pagamento, e per loro gemini mcp add con --transport http e --header registra ancora GSC Wizard.
No. Le letture arrivano da un warehouse ClickHouse che contiene l'intero set di righe, quindi non ci sono limiti di righe dell'export né paginazione dell'API di GSC. Il warehouse è in ritardo di circa due giorni e ogni risposta indica la data fino a cui i dati sono consolidati.
Tutto ciò che espone l'MCP: search analytics, query e pagine principali, variazioni di ranking, decay e cannibalizzazione, curve del CTR, punteggio delle opportunità, ispezione URL in blocco, tracciamento dell'indicizzazione, invii IndexNow, dati di Bing Webmaster, metriche GA4 e report SEO completi.
Le chiavi API sono gratuite per ogni account GSC Wizard e il piano gratuito funziona tramite l'API di GSC. Gli abbonati ottengono query veloci basate sul warehouse, ciò che rende pratica l'analisi dell'intero dataset. Vedi la pagina dei prezzi per i dettagli.
Crea una chiave API gratuita, aggiungi una voce alla configurazione di Gemini e fai domande sul tuo sito in linguaggio naturale.
Workflow pratici per GSC e GA4, aggiornamenti del prodotto ed esperimenti SEO. Niente spam, puoi annullare l'iscrizione quando vuoi.