zaDojoGoogle Analytics MCP: dati GA4 per agenti AI
Collega Google Analytics 4 a Claude, ChatGPT, Cursor o Codex senza progetto Google Cloud. Tredici strumenti in sola lettura e letture GA4 senza crediti.
Il server MCP di zaDojo permette al tuo agente AI di leggere la tua proprietà Google Analytics 4: visitatori, sessioni, visualizzazioni di pagina, frequenza di rimbalzo, eventi chiave e entrate, suddivisi per canale, pagina, paese, città, dispositivo o browser, più chi è sul sito in questo momento. Colleghi GA4 dentro zaDojo con un normale accesso Google, quindi non servono un progetto Google Cloud, API da attivare o file di credenziali. Leggere Google Analytics non consuma crediti, e gli stessi dati compaiono come dashboard nell'app di zaDojo.
Collegalo in tre passaggi
- Crea un account zaDojo e un progetto per il tuo sito. Per registrarti non serve una carta.
- Nel progetto apri My Site > Analytics e collega Google Analytics. Accedi con un account Google che vede la proprietà GA4, approva l'accesso in sola lettura e scegli la proprietà.
- Aggiungi l'URL del server qui sotto al tuo client AI e approva l'accesso a zaDojo la prima volta che si collega.
https://app.zadojo.com/mcpClaude Code
claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcpCodex CLI
codex mcp add zadojo --url https://app.zadojo.com/mcpCursor: aggiungi questo a mcp.json in Settings > Tools & Integrations > MCP Tools.
{
"mcpServers": {
"zadojo": {
"url": "https://app.zadojo.com/mcp"
}
}
}Claude Desktop: apri Customize > Connectors, scegli Add custom connector e incolla l'URL.
ChatGPT richiede una connessione personalizzata; la guida per ChatGPT elenca i passaggi e i piani che la supportano. Gli altri client che supportano server MCP remoti usano lo stesso URL, e la guida alla configurazione MCP copre ogni client.
Cosa può leggere il tuo agente
Ogni strumento risponde a un tipo di domanda, così l'agente sceglie il report giusto partendo dalla tua domanda invece di costruire da zero una query GA4.
| La tua domanda | Strumento |
|---|---|
| Come va l'intero sito rispetto al periodo precedente? | get_google_analytics_traffic_overview |
| Quali paesi, regioni, città, browser o sorgenti sono in testa? | get_google_analytics_breakdown |
| Quante persone sono sul sito in questo momento? | get_google_analytics_realtime_users |
| Il traffico da ricerca organica sta crescendo? | get_google_analytics_organic_overview |
| Quali pagine portano visitatori organici? | get_google_analytics_organic_landing_pages |
| Quali pagine vengono lette, e per quanto tempo? | get_google_analytics_page_performance |
| Quali canali, sorgenti o campagne portano sessioni? | get_google_analytics_traffic_acquisition |
| Quali eventi chiave avvengono, e dopo quali pagine di destinazione? | get_google_analytics_key_events |
| Quali prodotti e pagine di destinazione generano entrate? | get_google_analytics_ecommerce_performance |
| Cosa cercano i visitatori sul sito? | get_google_analytics_site_search |
| Quali dispositivi e paesi, e quanti visitatori di ritorno? | get_google_analytics_audience_breakdown |
| Il tracciamento è configurato correttamente? | get_google_analytics_measurement_health |
| Quali pagine vicine alla prima pagina vale la pena migliorare? | get_search_opportunities |
Panoramica del traffico e suddivisioni
La panoramica del traffico copre tutti i canali. Restituisce visitatori (gli utenti attivi di GA4), sessioni, visualizzazioni di pagina, frequenza di rimbalzo, durata media della sessione, eventi chiave e entrate da acquisti, ciascuno confrontato con il periodo precedente della stessa lunghezza, più un andamento giorno per giorno.
La panoramica e la suddivisione accettano gli stessi filtri: canale, sorgente, campagna, pagina di destinazione, pagina, paese, regione, città, dispositivo, browser e sistema operativo. I filtri si combinano, quindi una sola domanda può restringere i numeri ai "visitatori da mobile dalla Germania arrivati da Google". La suddivisione elenca i primi 50 valori di una di queste dimensioni, ed è così che un agente scende dai paesi alle città di un singolo paese.
Search Console e GA4 insieme
Se il progetto ha anche Search Console collegata, get_search_opportunities unisce le due fonti. Prende le pagine in posizione da 4 a 20 in Search Console, le abbina alle loro sessioni ed eventi chiave in GA4 e assegna un punteggio in base a domanda, valore per il business e vicinanza alla prima pagina. Le pagine senza dati in GA4 restano nella lista, senza punteggio.
Gli stessi dati come dashboard
Non ti serve un agente per vedere i numeri. Una volta collegato GA4, My Site > Analytics nell'app di zaDojo mostra:
- sette numeri principali (visitatori, sessioni, visualizzazioni di pagina, frequenza di rimbalzo, sessione media, eventi chiave ed entrate), ciascuno con la variazione rispetto al periodo precedente;
- un grafico giornaliero del numero che scegli;
- quattro pannelli: Sources (canale, sorgente, campagna), Pages (pagina di destinazione, pagina), Locations (paese, regione, città) e Devices (dispositivo, browser, sistema operativo);
- un conteggio in tempo reale dei visitatori sul sito negli ultimi 30 minuti, aggiornato ogni minuto.
Clicca una riga qualsiasi, per esempio un paese o un browser, e tutta la pagina si restringe su quel valore. I filtri si sommano, e puoi scegliere gli ultimi 7, 28 o 90 giorni, gli ultimi 12 mesi o date a tua scelta. Visualizzare la dashboard non consuma crediti.
Domande da fare
- "Come è cambiato il traffico da mobile dalla Germania negli ultimi 7 giorni rispetto alla settimana prima?"
- "Quali città degli Stati Uniti hanno portato più visitatori questo mese?"
- "Quali pagine di destinazione portano visitatori organici che poi si iscrivono?"
- "C'è qualcuno sul sito in questo momento?"
- "Quali pagine sono in seconda pagina in Search Console e convertono già in GA4?"
- "Il tracciamento della ricerca interna è attivo, e quali eventi chiave sono configurati?"
Quanto costa
Le letture di Google Analytics non consumano crediti, a prescindere da quante domande fai, e la dashboard è gratuita. Puoi collegare GA4 su un nuovo account senza inserire una carta.
La stessa connessione MCP serve anche gli strumenti di ricerca a pagamento di zaDojo, come la keyword research (circa 0,07 € a ricerca), i backlink e il rank tracking. Questi consumano crediti: il piano costa 10 € al mese e include 10 € di utilizzo. La descrizione di ogni strumento dice se consuma crediti, così il tuo agente distingue i due casi.
In sola lettura per scelta
zaDojo chiede a Google lo scope analytics.readonly. Il tuo agente può leggere i report. Non può cambiare impostazioni, modificare eventi chiave, aggiungere utenti o toccare il codice di tracciamento. Puoi disconnetterti in zaDojo in qualsiasi momento, oppure revocare l'accesso di zaDojo dalle impostazioni del tuo account Google.
Il confronto con il server MCP di Google
Google pubblica un server MCP open source per Google Analytics, indicato come sperimentale. Gira sul tuo computer con Python e lo configuri da solo:
- Crea o scegli un progetto Google Cloud.
- Attiva la Google Analytics Admin API e la Data API.
- Configura le credenziali con lo scope
analytics.readonly, tramite un client OAuth o un service account. - Indica al server il file delle credenziali e l'ID del progetto.
| zaDojo MCP | Server MCP di Google per Analytics | |
|---|---|---|
| Dove gira | Ospitato, un solo URL | Sul tuo computer (Python) |
| Configurazione Google Cloud | Nessuna, accedi con Google | Progetto, due API e un file di credenziali |
| Strumenti | 13 strumenti, ognuno per un tipo di domanda | Strumenti generici come run_report |
| Tempo reale | Visitatori degli ultimi 30 minuti | Sì, tramite run_realtime_report |
| Unione con Search Console | Sì | No |
| Costo | Le letture GA4 non consumano crediti | Gratuito e open source |
Il server di Google è la scelta migliore se vuoi tenere tutto sulla tua macchina o ti servono report che zaDojo non offre, come i funnel o le dimensioni personalizzate. zaDojo è adatto a chi vuole i dati GA4 nell'agente da subito, accanto a Search Console, keyword e strumenti di posizionamento, senza installare nulla.
Limiti da conoscere
- I report coprono solo giorni completi. Gli intervalli finiscono a ieri, nel fuso orario della proprietà.
- Google nasconde o campiona alcuni dati per motivi di privacy. Quando succede, gli strumenti segnalano il report come limitato, e le righe mancanti sono sconosciute, non pari a zero.
- Le suddivisioni restituiscono i primi 50 valori. Gli intervalli di date personalizzati possono coprire fino a 366 giorni.
- I filtri richiedono una corrispondenza esatta. I paesi usano codici di due lettere come DE, e i valori più sicuri da filtrare sono quelli restituiti da una suddivisione.
- Il conteggio in tempo reale copre l'intero sito e non accetta filtri.
- Non ci sono dati demografici, dati a livello di utente o dimensioni personalizzate.
- Solo proprietà GA4. L'account Google che colleghi deve avere accesso alla proprietà.
- Google limita quanti report ogni proprietà può eseguire all'ora e al giorno. I report mostrano la quota rimanente quando Google la invia. Se la quota finisce, gli strumenti restituiscono un errore invece di numeri parziali, con un orario per riprovare quando Google lo fornisce.
FAQ
Mi serve un progetto Google Cloud?
No. Accedi con Google dentro zaDojo e approvi l'accesso in sola lettura. Alla connessione con le API pensa zaDojo.
Leggere Google Analytics consuma crediti?
No. Le letture di Google Analytics e Search Console non consumano crediti, né nell'app né tramite il tuo agente.
L'agente può modificare qualcosa in Google Analytics?
No. zaDojo richiede lo scope analytics.readonly, quindi l'agente può leggere i report ma non può cambiare impostazioni, eventi o utenti.
Quali client AI possono usarlo?
Claude Code, Claude Desktop, Cursor, Codex CLI, Codex nell'app desktop di ChatGPT, ChatGPT con una connessione personalizzata e gli altri client che supportano server MCP remoti.
Funziona con Universal Analytics?
No. Legge solo proprietà GA4.