Un server MCP per Google Search Console dà a un agente AI come Claude, Claude Code, Codex o Cursor l'accesso all'API di Search Console. L'agente può recuperare clic, impressioni, CTR (percentuale di clic) e posizione media, controllare se una pagina è indicizzata ed elencare le tue sitemap. Tu fai la domanda con parole tue, per esempio «quali pagine sono in prima pagina ma non ricevono clic?», e l'agente esegue le query e analizza le righe. Questa guida mette a confronto i tre modi per configurarne uno, spiega cosa lascia fuori l'API e ti accompagna in un primo audit che puoi verificare da solo in Search Console.
In breve: al 9 novembre 2026, Google non ha un server MCP ufficiale per Search Console. Google ne pubblica uno per Google Analytics, e né la directory di Claude né quella di ChatGPT contengono un connettore Search Console realizzato da Google, Anthropic o OpenAI. Le opzioni sono un server della community gratuito che esegui tu e che richiede un progetto Google Cloud; un server ospitato a cui accedi con Google; oppure un'app con un connettore integrato, come Orkas, dove basta fare clic su Connetti. Tutte e tre leggono la stessa API, e questa non elenca tutte le query: Google esclude le query anonimizzate, che in uno studio di Ahrefs su 887.534 proprietà di Search Console rappresentavano il 46,77% del traffico.
Cosa può e cosa non può fare un MCP per Search Console
Tutti i server MCP per Search Console, della community o commerciali, chiamano la stessa API gratuita di Search Console. Ciò che possono fare dipende da quell'API, riassunta qui sotto in base al riferimento dell'API e ai limiti di utilizzo pubblicati da Google.
| Cosa chiedi | API | Limiti |
|---|---|---|
| Clic, impressioni, CTR e posizione per query, pagina, paese, dispositivo, data o aspetto nella ricerca | Search Analytics | 16 mesi di storico, con circa 2–3 giorni di ritardo; fino a 25.000 righe per richiesta e 50.000 righe al giorno per tipo di ricerca |
| Se un URL è indicizzato, la sua ultima scansione e il canonico scelto da Google | URL Inspection | Un URL per chiamata; 2.000 chiamate al giorno per proprietà |
| Le tue sitemap e i relativi errori | Sitemaps | Leggerle richiede l'accesso in sola lettura; inviarle o eliminarle, l'accesso completo |
| Le proprietà che puoi vedere | Sites | Aggiungere o rimuovere una proprietà richiede l'accesso completo |
Alcune cose di Search Console non hanno un'API, quindi nessun server MCP può ottenerle:
- I dati di AI Overview e AI Mode. Google ha esteso a tutti i siti il report sul rendimento dell'AI generativa il 31 agosto 2026, ma il riferimento dell'API non prevede alcun tipo di ricerca né aspetto nella ricerca corrispondente.
- Le opzioni più recenti dei report. Anche il tipo di ricerca multimodale e il filtro delle query di brand mancano dal riferimento dell'API.
- Testare una pagina pubblicata. Il Controllo URL riporta la versione presente nell'indice di Google. La documentazione dell'API lo dice chiaramente: «non è possibile testare l'indicizzabilità di un URL pubblicato».
- Il pulsante «Request indexing». Esiste solo in Search Console. L'Indexing API di Google, un'API separata che alcuni server chiamano, è ufficialmente riservata alle pagine di offerte di lavoro e di dirette streaming.
Tre modi per collegare Search Console a Claude, Claude Code o Codex
| Opzione | Configurazione | Da dove passano i tuoi dati | Costo |
|---|---|---|---|
| Server della community che esegui tu, come mcp-gsc | Progetto Google Cloud, API, credenziali e una voce di configurazione | Dal tuo computer a Google | Gratis |
| Server ospitato, come mcpsearchconsole.com | Accesso con Google e URL del server da incollare nella tua app di AI | Attraverso i server del fornitore | Piano gratuito, poi abbonamento |
| Connettore integrato in Orkas | Clic su Connetti e accesso con Google | Dal tuo computer a Google | Connettore gratuito |
- I server della community sono gratuiti e i più completi. Il più popolare, AminForou/mcp-gsc, aveva 2151 stelle su GitHub il 9 novembre 2026. Il suo codice include 21 strumenti, tra cui confronti tra periodi, controllo in blocco di massimo 10 URL e, se lo consenti, l'invio delle sitemap. Il prezzo da pagare è la configurazione: devi creare le tue credenziali Google. Un utente di r/TechSEO ha definito Google Cloud «l'unico attrito».
- I server ospitati sono la via più rapida per usarlo su claude.ai o ChatGPT dal browser. Sono server remoti, quindi si aggiungono tramite URL. Il centro assistenza di Claude dice che i connettori personalizzati funzionano con tutti i piani, ma «gli utenti del piano gratuito sono limitati a un solo connettore personalizzato». mcpsearchconsole.com indica un piano gratuito con 40 estrazioni di dati al mese su tre proprietà, poi 4,99 € al mese IVA esclusa. I tuoi dati di Search Console passano dal fornitore, quindi leggi prima la sua informativa sulla privacy.
- Un connettore integrato ti evita la configurazione di Google Cloud. In Orkas accedi con Google e il connettore viene eseguito sul tuo computer. È in sola lettura e ha quattro strumenti, meno dei server della community.
Eseguire da solo un server della community
Questi passaggi seguono il README di mcp-gsc alla versione 0.4.2 (6 novembre 2026). Non abbiamo creato un progetto Google Cloud per questa guida, quindi controlla il README prima di iniziare.
- Crea le credenziali Google. Nella console Google Cloud, crea un progetto, abilita l'API di Search Console e crea un ID client OAuth di tipo Desktop app. Scarica il relativo file JSON. Per l'automazione, crea invece un account di servizio e aggiungi il suo indirizzo email in Search Console, nella sezione Utenti e autorizzazioni delle Impostazioni, con accesso completo.
- Installa uv. Il metodo consigliato dal README avvia il server con
uvx, che gestisce Python al posto tuo. Senza, ti serve Python 3.11 o una versione successiva. - Aggiungi il server al tuo agente. In Claude Code:
In Codex:claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json --transport stdio gsc -- uvx mcp-search-console
Abbiamo verificato entrambi i comandi con Claude Code 2.1.311 e Codex CLI 0.163.0. Per Claude Desktop o Cursor, il README fornisce una configurazione JSON con il percorso completo dicodex mcp add gsc --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json -- uvx mcp-search-consoleuvx, perché le app aperte dal Dock o dal menu Start potrebbero altrimenti non trovarlo. - Accedi una volta. Al primo utilizzo si apre una finestra del browser per l'accesso a Google. Dalla versione 0.4.2, il server chiede solo l'accesso in sola lettura, a meno che tu non imposti
GSC_ALLOW_DESTRUCTIVE=true.
Un dettaglio che le guide della community non citano: se la schermata di consenso OAuth è impostata su External e resta in Testing, la documentazione OAuth di Google dice che il token di aggiornamento scade dopo 7 giorni. Dovresti rifare l'accesso ogni settimana. Per evitarlo, pubblica l'app in produzione o usa un account di servizio. Un'app pubblicata può mostrare l'avviso «app non verificata», che Google consente di superare per le app a uso personale con meno di 100 utenti.
Collegare Search Console in Orkas
Orkas è un'app desktop per macOS e Windows in cui più agenti AI lavorano nella stessa chat. Il suo connettore Google Search Console è integrato, quindi non ti serve un progetto Google Cloud.
- Installa Orkas e accedi. Scaricalo per macOS o Windows. I nuovi account ricevono 500 crediti gratuiti per i modelli integrati di Orkas, quindi per iniziare non ti serve una chiave API.
- Apri Connettori. Fai clic su Connettori nella barra laterale e cerca Google Search Console. Ci arrivi con il filtro Dati o con la casella di ricerca.
- Fai clic su Connetti e accedi con Google. Fai clic su Connetti, usa l'account Google che ha accesso alla tua proprietà e consenti l'accesso in sola lettura. La scheda passa nella sezione Connessi.
- Chiedi quello che ti serve. In una chat, digita @ e scegli il connettore Google Search Console, oppure descrivi semplicemente l'attività. L'agente elenca prima le tue proprietà, poi interroga quella che indichi.
- È in sola lettura. Orkas chiede a Google solo l'ambito
webmasters.readonly. I quattro strumenti elencano le tue proprietà, interrogano i dati sul rendimento, elencano le sitemap e controllano un URL. Poiché si limitano a leggere, Orkas li esegue senza chiederti di approvare ogni chiamata. Non possono inviare sitemap né richiedere l'indicizzazione, e una query restituisce al massimo 25.000 righe. - Le query vanno direttamente a Google. Il connettore viene eseguito sul tuo computer e chiama direttamente l'API di Search Console. Solo l'accesso a Google e il rinnovo del token passano dal server di Orkas, che conserva le credenziali Google dell'app.
- SeoGeoAgent e i tuoi agenti di programmazione possono usarlo. SeoGeoAgent, l'agente SEO integrato in Orkas, usa i tuoi clic, impressioni e posizioni reali nei suoi audit non appena Search Console è collegato. Se hai installato Claude Code, Codex, OpenCode, Hermes o OpenClaw e lo hai collegato in Orkas, raggiunge il connettore tramite il bridge degli strumenti di Orkas, senza bisogno di configurare MCP per conto suo.
- Ti serve l'accesso in scrittura? Usa Aggiungi server MCP nella pagina Connettori per aggiungere un server della community come comando locale. Orkas ha anche un connettore per Bing Webmaster Tools.
Un primo audit che puoi verificare
Una buona prima richiesta punta su numeri che puoi confrontare con Search Console in un minuto e costringe l'agente a dire cosa i dati non coprono. Sostituisci la proprietà e i due URL con i tuoi:
Usa il connettore Google Search Console per sc-domain:example.com. Per gli ultimi 28 giorni di dati completi: 1) totale di clic e impressioni per data, e quale quota ne coprono le righe delle query; 2) le pagine tra la posizione 5 e la 15 con almeno 100 impressioni e un CTR sotto il 2%, ordinate per impressioni; 3) lo stato di indicizzazione di https://example.com/new-page/ e https://example.com/old-page/. Indica l'intervallo di date in ogni tabella e non stimare nulla che i dati non mostrino.
Abbiamo eseguito questa richiesta con Claude Code in Orkas il 9 novembre 2026 e tutti e quattro gli strumenti del connettore hanno funzionato. Non pubblichiamo i numeri di Search Console del nostro sito, quindi i risultati qui sotto sono un esempio sintetico: numeri inventati per un negozio fittizio su example.com, che mostrano come appare una risposta accurata e come verificarne ogni parte.
- Totali per data (dati sintetici): 3480 clic e 151.200 impressioni. Sono questi i numeri di cui fidarsi per l'intero sito. Per verificare i tuoi, apri il report sul rendimento, scegli le stesse date personalizzate e lo stesso tipo di ricerca e confronta i totali. Dovrebbero risultare molto vicini. Una differenza grande di solito significa che l'agente ha sommato invece le righe delle query o delle pagine.
- Righe delle query (dati sintetici): 642 righe che coprono 1670 clic, il 48% del totale. Il resto viene da query che Google rende anonime e che non hanno una riga né nel report né nell'API. Una quota simile è normale: Ahrefs ha rilevato che le query anonimizzate rappresentavano il 46,77% del traffico ad aprile 2025, e di più su molti siti. Un agente che somma le righe delle query e le presenta come il tuo traffico può sbagliare della metà.
- Pagine con CTR basso (dati sintetici): 9 pagine tra la posizione 5 e la 15 con almeno 100 impressioni e un CTR sotto il 2%. Quella con più impressioni,
/blog/linen-care/, ne ha avute 2140 con una posizione media di 6,8 e 21 clic, un CTR dell'1,0%. Sono i primi titoli e descrizioni da rivedere. Se il tuo sito pubblica ogni lingua a indirizzi che finiscono con?lang=, ogni versione ha una sua riga di pagina, quindi chiedile raggruppate. - Controllo URL (dati sintetici): la pagina vecchia è indicizzata, quella nuova non ancora.
https://example.com/old-page/, pubblicata a settembre, risultava «Submitted and indexed», con ultima scansione il 3 ottobre.https://example.com/new-page/, pubblicata due giorni prima del controllo, risultava «Discovered - currently not indexed». Per verificarlo, incolla lo stesso URL nella barra di ricerca del controllo in cima a Search Console.
Cinque errori comuni
- Scambiare le righe delle query per il traffico totale. La guida di Google sui dati sul rendimento spiega che le query anonimizzate non hanno una riga: «se sommi i clic di tutte le righe, non otterrai lo stesso numero di clic dei totali del grafico». Per i totali, chiedi i dati per data senza filtri sulle query.
- Confrontare i totali per pagina con quelli del sito. Raggruppando per pagina, ogni URL che compare in un risultato viene conteggiato separatamente. Raggruppando per proprietà, un risultato conta una sola volta per l'intero sito. Per questo le righe delle pagine possono sommare più impressioni del totale del sito.
- Dimenticare il ritardo. I dati sono «in genere disponibili dopo 2-3 giorni». L'API restituisce dati definitivi, a meno che non le si chiedano dati recenti, quindi «gli ultimi 7 giorni» finiscono qualche giorno prima di oggi.
- Usare il nome sbagliato della proprietà. Una proprietà di dominio si scrive
sc-domain:example.com. Una proprietà con prefisso URL è l'indirizzo completo con la barra finale, comehttps://example.com/. Lascia che l'agente elenchi prima le tue proprietà e copia il nome che restituisce. - Chiedere troppo in una volta. Ogni richiesta restituisce al massimo 25.000 righe, e una suddivisione per query e pagina su 16 mesi esaurisce in fretta quel limite. Chiedi riepiloghi, un filtro o un intervallo di date più breve, e lascia che sia l'agente a elaborare le righe invece di incollarle tutte nella chat.
Quale opzione scegliere?
| La tua situazione | Scegli |
|---|---|
| Usi claude.ai o ChatGPT nel browser | Un server ospitato, aggiunto tramite URL |
| Vuoi tutti gli strumenti, compreso l'invio delle sitemap, e Google Cloud non ti pesa | Un server della community come mcp-gsc |
| Vuoi che Claude Code, Codex e un agente SEO leggano Search Console senza Google Cloud | Il connettore integrato di Orkas |
| Il tuo sito è troppo grande per 25.000 righe per richiesta | L'esportazione collettiva dei dati di Search Console in BigQuery, fuori da MCP |
Domande frequenti
Google ha un server MCP ufficiale per Search Console?
No, non al 9 novembre 2026. Search Console non compare nell'elenco dei server MCP ufficiali di Google né nell'elenco MCP di Google Cloud. Google pubblica un server MCP per Google Analytics, che non include i dati di Search Console.
Un MCP per Search Console è gratuito?
L'API di Search Console è gratuita, così come i server della community, per esempio mcp-gsc, e il connettore di Orkas. I server ospitati di solito hanno un piano gratuito con un limite mensile e un piano a pagamento. L'agente AI che colleghi ha comunque un suo costo, per esempio un piano Claude o i crediti Orkas.
Un server MCP può inviare sitemap o richiedere l'indicizzazione?
Può inviare o eliminare sitemap se ha l'accesso completo a Search Console, cosa che alcuni server della community offrono. L'API di Search Console non ha una funzione Request indexing, quindi nessun server può farlo per le pagine normali. Il connettore di Orkas è in sola lettura e non fa né l'una né l'altra cosa.
Perché i numeri dell'MCP non corrispondono a Search Console?
Di solito perché l'agente ha sommato le righe delle query, che escludono le query anonimizzate, o ha mescolato totali per pagina e totali per proprietà. Chiedi i totali per data senza filtri sulle query, con le stesse date e lo stesso tipo di ricerca del report. A quel punto i totali dovrebbero risultare molto vicini.
Funziona con Claude Code e Codex?
Sì. Aggiungi un server della community con claude mcp add o codex mcp add, oppure aggiungi un server ospitato tramite URL. In Orkas, Claude Code e Codex usano il connettore Search Console integrato tramite il bridge degli strumenti di Orkas, senza alcuna configurazione in nessuno dei due.
Che cos'è l'Agentic SEO? offre il quadro generale: un agente svolge il lavoro SEO su dati reali e aggiornati, e una persona approva ciò che va online.