La connessione GA4 di Claude Code aiuta gli sviluppatori a verificare se la strumentazione degli eventi corrisponde ai dati che raggiungono Analytics. Aggiunge strumenti di reporting a una sessione di codifica senza richiedere le credenziali Google nel repository. Usalo per controllare il contratto di un evento, quindi decidere se l'attività successiva appartiene al codice, alla configurazione Tag Manager o GA4.
Di cosa hai bisogno prima di connetterti?
Utilizza Claude Code installato sul computer su cui eseguirai questi comandi. Il suo CLI supporta server HTTP MCP remoti e browser OAuth. Questa route registra un server esplicito con ambito utente da utilizzare nei tuoi progetti; la configurazione del team nell'ambito del progetto è una scelta separata. Non è necessario eseguire un server Google API locale.
- Un login Google con accesso alla proprietà GA4 che desideri analizzare.
- Un account LoomaScale e una connessione Google Analytics; il collegamento di Google Ads da solo non autorizza Analytics.
- L'ID numerico della proprietà o l'autorizzazione a rilevarla dall'elenco degli account. Un ID misurazione G identifica un flusso web e non è l'ID della proprietà di reporting.
Come si collega Claude Code a GA4?
1. Collegare GA4 a LoomaScale
Crea o accedi al tuo account LoomaScale, quindi apri Connessioni. Scegli Google Analytics, accedi con l'e-mail Google che ha accesso ai dati richiesti ed esamina le autorizzazioni richieste. L'accesso a LoomaScale con Google non sostituisce la connessione a questa origine dati. Puoi connettere questo servizio senza connettere un account pubblicitario.
2. Registrare il server MCP remoto in Claude Code
Esegui questo comando nel terminale di sistema, al di fuori di una conversazione Claude Code. L'ambito utente rende la connessione disponibile tra i tuoi progetti. L'URL seleziona gli strumenti di questo servizio Google.
claude mcp add --transport http --scope user loomascale-ga4 https://api.loomascale.com/mcp/ga4Se utilizzi già il plug-in completo dell'agente LoomaScale, controlla i suoi strumenti prima di aggiungere una seconda connessione. Il percorso del plugin è documentato nella guida all'installazione di Claude Code; questo articolo utilizza la configurazione diretta di MCP.
3. Autenticarsi dal menu MCP di Claude Code
Apri Claude Code e inserisci /mcp. Selezionare loomascale-ga4 e completare il flusso di autenticazione nel browser. Utilizza l'account LoomaScale con la sorgente Google connessa. Torna a Claude Code e conferma che il server è connesso. È possibile controllare il server salvato dal terminale di sistema con claude mcp get loomascale-ga4 o claude mcp list. Un comando di aggiunta riuscito salva la configurazione; non dimostra che la ricerca dell'account Google sia riuscita.
4. Verifica l'accesso con una ricerca effettiva dell'account
Utilizzare LoomaScale per chiamare ga4_get_account_summaries. Elenca le mie proprietà GA4 accessibili con i relativi nomi e ID proprietà numerici. Chiedimi quale proprietà utilizzare. Leggi il fuso orario e la valuta dei rapporti. Non modificare alcuna impostazione.
La risposta dovrebbe contenere proprietà dal tuo login Google, con una risorsa come properties/123456789. Seleziona la proprietà per nome e ID, quindi mantieni la selezione nelle richieste successive. Una descrizione di GA4 o un dashboard di esempio non dimostrano che il connettore abbia recuperato i dati. Un elenco di account vuoto può essere una risposta valida da un accesso senza proprietà accessibili.
Come si controlla il contratto di un evento con Claude Code e GA4?
Inizia con un evento che puoi identificare nel repository, ad esempio generate_lead. Chiedi a Claude Code di registrare l'ortografia e le condizioni in cui il sito la emette. Quindi confronta il contratto con i nomi degli eventi osservati di GA4 e i conteggi recenti. Un evento assente è una pista da indagare, non una prova automatica che il codice non è mai stato eseguito.
Utilizza LoomaScale con la proprietà GA4 che ho selezionato. Leggi la strumentazione degli eventi del modulo lead di questo repository senza modificare i file. Identificare i nomi degli eventi previsti e il momento in cui vengono attivati. Segnala eventCount di eventName per gli ultimi 7 giorni completi e controlla i nomi attesi. Se utile, interroga separatamente gli eventi in tempo reale. Spiega cosa verifica il report e cosa necessita di un test del browser. Non creare eventi o modificare le impostazioni.
Separare una mancata corrispondenza del nome evento da un errore di raccolta. Un evento recente può essere assente da un report datato mentre l'elaborazione è ancora in corso; un risultato in tempo reale risponde a una domanda su una finestra temporale diversa. Controlla la proprietà e lo streaming desiderati prima di modificare il codice. Se è necessario un test del browser, eseguirlo nell'apposito ambiente di test del sito e verificarne le effettive richieste emesse.
Quale endpoint MCP utilizza questa guida?
https://api.loomascale.com/mcp/ga4L'endpoint specifico del servizio espone gli strumenti GA4 e gli helper dell'account LoomaScale. Il plug-in o connettore della directory completa utilizza https://api.loomascale.com/mcp e può raggiungere tutte le sorgenti collegate separatamente. Scegli la connessione completa per lavorare attraverso i servizi; utilizza l'endpoint specifico quando desideri che il set di strumenti di questa origine sia impostato. La scelta di un endpoint limita gli strumenti esposti, non i ruoli Google detenuti dal tuo accesso.
Cosa può leggere o modificare Claude Code in GA4?
LoomaScale può recuperare rapporti su traffico, coinvolgimento, eventi chiave, entrate, attività in tempo reale e canalizzazione. Inizia con i report e specifica date, dimensioni e metriche. Gli strumenti di configurazione, se abilitati per il tuo account, necessitano del ruolo Google appropriato e dell'autorizzazione analytics.edit; Il solo accesso al report non garantisce la modifica. Il collegamento di un assistente non installa un tag del sito web, non crea eventi storici né rende l'attribuzione GA4 identica all'attribuzione di una piattaforma pubblicitaria.
Perché mancano la connessione o i dati?
Se il server necessita di autenticazione, apri /mcp e accedi nuovamente. Se mancano strumenti, controlla claude mcp list, l'endpoint di origine e se un criterio dell'organizzazione limita il server. Se necessario, riavviare la sessione dopo una modifica della configurazione. Un connettore Web Claude e un server CLI esplicito possono sovrapporsi; controlla gli strumenti attivi prima di aggiungere connessioni duplicate.
Se la proprietà manca, conferma l'e-mail Google e l'accesso alla proprietà, quindi controlla la connessione Analytics in LoomaScale. Se un report è vuoto, controlla la proprietà, le date, i filtri e se il sito invia effettivamente eventi. Confronta periodi equivalenti nel fuso orario della struttura. In caso di mancata corrispondenza delle metriche, conservare i nomi esatti delle metriche e le definizioni di attribuzione prima di trarre conclusioni. Utilizza l'ID della proprietà di reporting anziché l'identificatore G-stream.
Guide di connessione correlate e riferimenti ufficiali
Usa GA4 in un altro assistente
- Come collegare ChatGPT a GA4
- Come collegare Claude a GA4
- Come collegare Codex a GA4
- Come collegare Grok Build a GA4
Collega un'altra sorgente Google a Claude Code
Riferimenti di installazione ufficiali
- Claude Code MCP di Anthropic, ambiti e guida all'autenticazione
- Riferimento ID proprietà GA4 di Google
Riferimenti di installazione controllati il 12 novembre 2026. Le etichette dei menu e le policy dell'area di lavoro possono cambiare; utilizza la guida del fornitore collegata per il tuo account. Per i flussi di lavoro supportati da LoomaScale, vedere l'hub della documentazione.
