Meta Pixel
Torniamo al blog
Guida alla connessione6 minuti di lettura12 nov 2026Di Andrii Pasika· Fondatore, LoomaScale

Come collegare Claude Code a GA4 (Google Analytics 4)

Risposta breve

Per connettere Claude Code a GA4, connettere Google Analytics in LoomaScale e registrare l'endpoint GA4 con claude mcp add utilizzando il trasporto HTTP. Apri Claude Code, autenticati tramite /mcp e chiedi a LoomaScale di elencare le tue proprietà. Seleziona una proprietà prima di confrontare la strumentazione dell'evento con i relativi dati sugli eventi segnalati.

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/ga4

Se 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/ga4

L'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

Collega un'altra sorgente Google a Claude Code

Riferimenti di installazione ufficiali

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.

Domande frequenti

Il collegamento di Claude Code a GA4 installa il monitoraggio sul mio sito web?

No. La connessione MCP fornisce alla sessione l'accesso agli strumenti di Analytics autorizzati. Non installa un tag Google né modifica il tuo repository. Ispezionare la strumentazione esistente e verificare prima i dati osservati; qualsiasi modifica al codice o al monitoraggio è un'attività separata.

Ho bisogno di un ID misurazione GA4 o di una proprietà?

Il reporting utilizza l'ID proprietà numerico, spesso restituito come properties/123456789. Un ID di misurazione G appartiene a un flusso di dati web. Chiedi prima a LoomaScale di elencare le tue proprietà, quindi seleziona la proprietà corretta anziché indovinare un ID.

Dove posso eseguire claude mcp add e /mcp?

Esegui claude mcp add nel terminale di sistema. Quindi apri Claude Code e inserisci /mcp nella sua interfaccia di conversazione per ispezionare il server ed autenticarti. Il comando con ambito utente in questa guida rende il server disponibile tra i tuoi progetti su quel computer.

Chi ha scritto questo

Andrii Pasika, fondatore di LoomaScale

Andrii Pasika

Fondatore, LoomaScale

Andrii ha fondato LoomaScale e dietro di esso ha scritto il server Google Ads MCP. Attraverso di esso gestisce le proprie campagne e la posta a team@loomascale.com lo raggiunge.

Collegare GA4 a Claude Code

Crea il tuo account LoomaScale, collega la sorgente Google e utilizza la richiesta di verifica sopra per recuperare i dati del tuo account.

Inizia con LoomaScale

Collega il tuo assistente alla piattaforma pubblicitaria

LoomaScale funziona nell’assistente che usi già. Scegli la tua combinazione: ogni guida richiede circa cinque minuti.

ChatGPT
Google Ads

Collega ChatGPT a Google Ads. Analizza campagne, termini di ricerca e budget, poi prepara le modifiche entro il limite di spesa impostato.

Leggi la guida
Claude
Google Ads

Collega Claude a Google Ads. Analizza campagne, termini di ricerca e budget, poi prepara le modifiche entro il limite di spesa impostato.

Leggi la guida
Claude Code
Google Ads

Collega Claude Code a Google Ads. Analizza campagne, termini di ricerca e budget, poi prepara le modifiche entro il limite di spesa impostato.

Leggi la guida
Codex
Google Ads

Collega Codex a Google Ads. Analizza campagne, termini di ricerca e budget, poi prepara le modifiche entro il limite di spesa impostato.

Leggi la guida
ChatGPT
Meta Ads

Collega ChatGPT a Meta Ads. Analizza campagne Facebook e Instagram, gruppi di inserzioni, creatività e posizionamenti.

Leggi la guida
Claude
Meta Ads

Collega Claude a Meta Ads. Analizza campagne Facebook e Instagram, gruppi di inserzioni, creatività e posizionamenti.

Leggi la guida
Claude Code
Meta Ads

Collega Claude Code a Meta Ads. Analizza campagne Facebook e Instagram, gruppi di inserzioni, creatività e posizionamenti.

Leggi la guida
Codex
Meta Ads

Collega Codex a Meta Ads. Analizza campagne Facebook e Instagram, gruppi di inserzioni, creatività e posizionamenti.

Leggi la guida
ChatGPT
TikTok Ads

Gestisci le campagne TikTok da ChatGPT: report, completamento dei video, suddivisioni del pubblico, e pause, budget e offerte su richiesta. La stessa installazione con un clic.

Leggi la guida
Claude
TikTok Ads

Gestisci le campagne TikTok da Claude: analisi, report su video e pubblico, e pause, budget e offerte entro il limite di spesa che imposti.

Leggi la guida
Manus
Google Ads

Collega Manus a Google Ads. Analizza campagne, termini di ricerca e budget, poi prepara le modifiche entro il limite di spesa impostato.

Leggi la guida
Slack
Google Ads

Chiedi a Slackbot di Google Ads in un messaggio diretto: analisi, termini di ricerca e andamento del budget con dati in tempo reale. Un’installazione per spazio di lavoro.

Leggi la guida
Manus
Meta Ads

Collega Manus a Meta Ads. Analizza campagne Facebook e Instagram, gruppi di inserzioni, creatività e posizionamenti.

Leggi la guida
Slack
Meta Ads

Chiedi a Slackbot di Facebook e Instagram in un messaggio diretto: pubblicazione, andamento del budget e spese per gruppo di inserzioni, direttamente da Meta Ads.

Leggi la guida