Liigu sisu juurde

Kerge vaade: lehed avanevad kiiresti ja ilma 3D-graafikata. Näitame kerget vaadet, sest 3D-graafika oleks selles seadmes aeglane. Sisu on sama.

Lülita 3D sisse

Valmistan graafikat ette. Esimesel külastusel võib see veidi aega võtta.

Henry Lõiv

Veebidisain ja arendus

JuhendTehisintellekt 11 min lugemist

Google Analytics MCP: Claude’i ja Codexi seadistus Macis ja Windowsis

Ühenda GA4 Claude’i või Codexiga Macis ja Windowsis tasuta kohaliku MCP-serveri abil. Lugemisõigusega OAuth, praktilised päringud ja levinud vigade lahendused.

Google Analytics 4 saab Claude Desktopi, Claude Code’i või Codexiga ühendada ilma tasulise MCP-vahendusteenuseta. Google’i avatud lähtekoodiga Analyticsi MCP-server töötab sinu arvutis ning annab AI-abilisele tööriistad sinu GA4 aruannete lugemiseks. Nii saad küsida liikluse, maandumislehtede ja mõõdetud sündmuste kohta, ilma et peaksid iga küsimuse jaoks CSV-faili eksportima. Google’i Analyticsi MCP-juhend

Seadistasin 4. novembril 2026 oma Macis kohalikult nii Analyticsi kui ka Search Console’i MCP. See juhend kirjeldab Analyticsi ühendust ja ka autentimisprobleemi, millega seadistamise käigus kokku puutusin.

Siinne seadistus kasutab ainult Analyticsi lugemisõigust. Vali oma operatsioonisüsteemi juhised ning seejärel AI-klient, mida kasutad. Kõiki kolme klienti pole vaja paigaldada.

Kontrollitud 4. novembril 2026: algne macOS-i ühendus kasutas Python 3.13, paketti analytics-mcp 0.7.0 ja teeki google-auth-oauthlib 1.5.0. Töötasid kontode leidmine ja päris GA4 aruande päring. Windowsi juhiseid on kontrollitud platvormide dokumentatsiooni põhjal, kuid Windowsis pole kogu seadistust läbi testitud. Käsud säilitavad testitud paketiversioonid. Analytics MCP 1.0.0 ilmus 3. novembril; enne juhendis versiooni asendamist tuleb ühendus sellega uuesti läbi proovida.

Mida see võimaldab ja mis on tasuta?

MCP ehk Model Context Protocol võimaldab AI-abilisel kasutada väliseid tööriistu. Siin saavad need tööriistad lugeda Analyticsi kontode, andmevarade ehk property’de ja aruannete andmeid. Esimene kasulik küsimus võib olla näiteks:

Näita viimase seitsme täispäeva sessioone maandumislehtede kaupa. Lisa andmevara ID, selle ajavöönd ja täpne kuupäevavahemik. Märgi ära värsked andmed, mis võivad veel muutuda.

Kohalikul serveril pole kuutasu ning Google Analyticsi tavaversioon ei vaja Analytics 360 tellimust. AI-teenuse pakett või API kasutamine maksab endiselt selle tavahinna järgi ja Google’i API-kvoodid jäävad kehtima. See seadistus ei vaja tasulist MCP-vahendajat, pilveserverit ega BigQuery kasutamist. Google Analytics · Serveri litsents · Data API kvoodid

Server töötab kohalikult, kuid küsitud aruannete tulemused edastatakse AI-abilisele. See pole võrguühenduseta AI-lahendus.

Enne alustamist

Vaja on järgmist:

  • Google’i konto, millel on analüüsitavas GA4 andmevaras vähemalt Viewer-roll.
  • Google Cloudi projekt, milles saad API-sid lubada ja OAuthi klienti luua. Cloudi projekt ja GA4 andmevara on eraldi ressursid.
  • Üks paigaldatud klient: Claude Desktop, Claude Code või kohalik Codexi klient. Allolevad käsurea seadistuskäsud eeldavad vastava CLI olemasolu.
  • macOS: Homebrew ja Terminal. Windows: Windowsi PowerShell ja Python 3.13; allpool paigaldatakse Python WinGetiga.

Windowsi juhised on mõeldud otse Windowsis töötavatele klientidele. WSL-i paigaldatud server asub eraldi keskkonnas ja selle Linuxi failiteed ei sobi Windowsi Claude Desktopi seadistusse.

1. Paigalda Python, pipx ja Analyticsi MCP-⁠server

pipx hoiab serveri sõltuvused eraldi Pythoni keskkonnas. Järgi ainult oma platvormi alajaotust. Kui pipx teatab, et Analytics MCP on juba paigaldatud, vaata enne töötava seadistuse asendamist käsu pipx list tulemust.

macOS

Paigalda Python 3.13 ja pipx:

brew install python@3.13 pipx
pipx ensurepath

Ava uus Terminali aken ning paigalda juhendis kasutatud versioonid:

pipx install --python "$(brew --prefix python@3.13)/bin/python3.13" analytics-mcp==0.7.0
pipx inject analytics-mcp google-auth-oauthlib==1.5.0
command -v analytics-mcp

Windows PowerShell

Kui Python 3.13 pole paigaldatud, käivita:

winget install --id Python.Python.3.13 --exact --source winget

Ava pärast paigaldamist PowerShell uuesti. Paigalda pipx ja lisa selle käsud oma kasutaja PATH-i:

py -3.13 --version
py -3.13 -m pip install --user pipx
py -3.13 -m pipx ensurepath

Sulge terminalirakendus ja ava see uuesti. Paigalda MCP-server, kasutades Python 3.13 tegelikku käivitatavat faili:

$GaBasePython = (py -3.13 -c "import sys; print(sys.executable)").Trim()
pipx install --python "$GaBasePython" "analytics-mcp==0.7.0"
pipx inject analytics-mcp "google-auth-oauthlib==1.5.0"
(Get-Command analytics-mcp -CommandType Application).Source

Jäta mõlemal platvormil viimase käsu väljastatud täielik failitee alles. Töölauarakendus ei pruugi kasutada terminali PATH-i, seega läheb seda teed seadistusfailis vaja. Pythoni virtuaalkeskkonda ei pea eraldi aktiveerima. pipx paigaldamine · PyPA Windowsi juhised · Python Windowsis

2. Luba Google’i API-⁠d ja loo Desktop app tüüpi OAuthi klient

Kasuta järgmistes sammudes Google Cloud Console’is sama projekti:

  1. Loo või vali projekt. Pane kirja selle project ID. See erineb projekti kuvatavast nimest ja numbrilisest projektinumbrist.
  2. Ava APIs & Services → Library ning luba Google Analytics Admin API ja Google Analytics Data API.
  3. Ava Google Auth Platform. Kui rakendus pole veel seadistatud, vali Get started ja sisesta selle nimi, toe e-posti aadress ning kontaktandmed.
  4. Vali sobiv sihtrühm. Isikliku Google’i konto puhul kasuta valikut External. Kui rakendus jääb olekusse Testing, lisa sisselogimiseks kasutatav Google’i konto jaotises Audience → Test users.
  5. Ava Data Access ja lisa nupuga Add or remove scopes õigus https://www.googleapis.com/auth/analytics.readonly.
  6. Ava Clients → Create client, vali Desktop app ja loo klient. Laadi selle JSON-fail alla, kui seda pakutakse.

Kontol, millega loa annad, peab olema ligipääs ka GA4 andmevarale. API lubamine seda õigust ei anna. Neid seadeid kirjeldavad Google’i Auth Platformi sissejuhatus, OAuthi kliendi juhend ja õiguste seadistamise juhend.

External-tüüpi rakenduse Testing-olekus aeguvad Analyticsi õigusega antud load seitsme päevaga, sealhulgas offline-juurdepääsu värskendustokenid. Testimise ajal saad loa uuesti anda. Pikemaajaliseks kasutamiseks vaata üle Google’i avaldamis- ja kinnitamisnõuded; avaldamisoleku muutmine ei tee tokeneid igaveseks. Google’i sihtrühma ja Testing-oleku reeglid

Salvesta allalaaditud kliendi JSON

Loo kaust väljaspool koodihoidlaid.

macOS:

mkdir -p "$HOME/.config/google-analytics-mcp"
chmod 700 "$HOME/.config/google-analytics-mcp"

Windows PowerShell:

$GaRoot = Join-Path $HOME ".config\google-analytics-mcp"
New-Item -ItemType Directory -Force -Path $GaRoot | Out-Null
$GaRoot

Salvesta allalaaditud fail sellesse kausta nimega oauth_client.json. Windowsis kontrolli, et nimeks poleks saanud oauth_client.json.txt.

macOS-is piira ka failile ligipääsu:

chmod 600 "$HOME/.config/google-analytics-mcp/oauth_client.json"

oauth_client.json määratleb sinu OAuthi rakenduse. Järgmine samm loob eraldi faili credentials.json, mis sisaldab sinu Google’i konto autoriseerimisandmeid. Ära aja neid faile segamini ega lisa neid Giti. Windowsis hoia kausta enda kasutajaprofiilis; Unixi õigusekäsud ei määra Windowsi ligipääsureegleid.

3. Anna ainult lugemisõigus

Järgmine abiskript kasutab Google’i OAuthi teeki ja loob eraldi ADC-vormingus autentimisfaili. See ei asenda mõne teise rakenduse Google’i vaikeloginit. Skript on selle juhendi abivahend; Google’i ametlikud juhised kirjeldavad ka autentimist gcloud abil.

Salvesta järgmine kood failina authorize.py samasse kausta, kus asub oauth_client.json. Kasuta lihttekstiredaktorit, näiteks VS Code’i. Windowsis jälgi, et failinimi oleks authorize.py, mitte authorize.py.txt.

Võid ka sama OAuthi abiskripti alla laadida, nimetada selle ümber failiks authorize.py ja sellesse kausta salvestada.

import json
import os
from pathlib import Path

from google_auth_oauthlib.flow import InstalledAppFlow

if os.name != "nt":
    os.umask(0o077)

root = Path.home() / ".config" / "google-analytics-mcp"
root.mkdir(parents=True, exist_ok=True)
if os.name != "nt":
    root.chmod(0o700)

client = json.loads(
    (root / "oauth_client.json").read_text(encoding="utf-8-sig")
)
if "installed" not in client:
    raise SystemExit("Use an OAuth client JSON created for a Desktop app.")
project = client["installed"].get("project_id")
if not project:
    raise SystemExit("The OAuth client JSON is missing project_id.")

flow = InstalledAppFlow.from_client_config(
    client,
    scopes=["https://www.googleapis.com/auth/analytics.readonly"],
)
credentials = flow.run_local_server(
    port=0, prompt="consent", access_type="offline"
)
if not credentials.refresh_token:
    raise SystemExit("Google did not return a refresh token. Authorise again.")

data = json.loads(credentials.to_json())
data.update(type="authorized_user", quota_project_id=project)
path = root / "credentials.json"
path.write_text(json.dumps(data, indent=2), encoding="utf-8")
if os.name != "nt":
    path.chmod(0o600)

print("Credentials:", path)
print("Project:", project)

Käivita see paketi pipx-keskkonna Pythoniga. PIPX_HOME küsimine väldib oletamist, millises kaustas pipx sinu arvutis faile hoiab. pipx failiteede seadistamine

macOS:

GA_PYTHON="$(pipx environment --value PIPX_HOME)/venvs/analytics-mcp/bin/python"
"$GA_PYTHON" "$HOME/.config/google-analytics-mcp/authorize.py"

Windows PowerShell:

$GaPipxHome = (pipx environment --value PIPX_HOME).Trim()
$GaPython = Join-Path $GaPipxHome "venvs\analytics-mcp\Scripts\python.exe"
& $GaPython (Join-Path $HOME ".config\google-analytics-mcp\authorize.py")

Logi brauseris sisse kontoga, millel on GA4 andmevarale ligipääs. Vaata küsitav Analyticsi lugemisõigus üle ja kinnita see. Jäta järgmise sammu jaoks alles väljastatud autentimisfaili tee ja projekti ID. Skript ei väljasta ligipääsu- ega värskendustokeneid. Google’i kohaliku rakenduse OAuthi teek

4. Ühenda Claude Desktop, Claude Code või Codex

Vali üks kliendi alajaotus. Kui kasutad mitut klienti, seadista igaüks eraldi; kõik võivad lugeda sama autentimisfaili.

Codexi ja Claude Code’i käsureakäskude jaoks määra kõigepealt järgmised muutujad terminalis, kus käsu käivitad. Asenda YOUR_PROJECT_ID abiskripti väljastatud projekti ID-ga.

macOS:

GA_COMMAND="$(command -v analytics-mcp)"
GA_CREDENTIALS="$HOME/.config/google-analytics-mcp/credentials.json"
GA_PROJECT="YOUR_PROJECT_ID"

Windows PowerShell:

$GaCommand = (Get-Command analytics-mcp -CommandType Application).Source
$GaCredentials = Join-Path $HOME ".config\google-analytics-mcp\credentials.json"
$GaProject = "YOUR_PROJECT_ID"

Codex

macOS:

codex mcp add google-analytics \
  --env "GOOGLE_APPLICATION_CREDENTIALS=$GA_CREDENTIALS" \
  --env "GOOGLE_CLOUD_PROJECT=$GA_PROJECT" \
  -- "$GA_COMMAND"

Windows PowerShell:

codex mcp add google-analytics --env "GOOGLE_APPLICATION_CREDENTIALS=$GaCredentials" --env "GOOGLE_CLOUD_PROJECT=$GaProject" -- "$GaCommand"

See kasutab Codexi kasutajapõhist seadistust, mida jagavad kohalikud Codexi kliendid. Hoidla sees asuv .codex/config.toml on projektipõhine. Kontrolli kirje olemasolu käsuga codex mcp list ning ava uus seanss. Codexi MCP-seadistus

Claude Code

macOS:

claude mcp add \
  --env "GOOGLE_APPLICATION_CREDENTIALS=$GA_CREDENTIALS" \
  --env "GOOGLE_CLOUD_PROJECT=$GA_PROJECT" \
  --scope user --transport stdio \
  google-analytics -- "$GA_COMMAND"

Windows PowerShell:

claude mcp add --env "GOOGLE_APPLICATION_CREDENTIALS=$GaCredentials" --env "GOOGLE_CLOUD_PROJECT=$GaProject" --scope user --transport stdio google-analytics -- "$GaCommand"

--scope user teeb serveri kättesaadavaks selle arvuti eri projektides. Alusta uut Claude Code’i seanssi ja kontrolli ühendust käsuga /mcp. Claude Code’i MCP-seadistuse ulatus

Claude Desktop

Ava Claude Desktopi arendajaseadistus ning lisa allolev serverikirje olemasolevasse mcpServers objekti. Säilita teised serverid ja seaded. Ära loo kahte sama taseme mcpServers võtit.

PlatvormSeadistusfail
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

Windowsis saab %APPDATA% sisestada File Exploreri aadressiribale; PowerShellis on sama asukoht muutujas $env:APPDATA. Vajaduse korral ava või loo seadistusfail Claude Desktopi arendajaseadete kaudu.

macOS-i näide:

{
  "mcpServers": {
    "google-analytics": {
      "command": "/ABSOLUTE/PATH/analytics-mcp",
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/Users/YOUR_NAME/.config/google-analytics-mcp/credentials.json",
        "GOOGLE_CLOUD_PROJECT": "YOUR_PROJECT_ID"
      }
    }
  }
}

Windowsi näide:

{
  "mcpServers": {
    "google-analytics": {
      "command": "C:/Users/YOUR_NAME/.local/bin/analytics-mcp.exe",
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "C:/Users/YOUR_NAME/.config/google-analytics-mcp/credentials.json",
        "GOOGLE_CLOUD_PROJECT": "YOUR_PROJECT_ID"
      }
    }
  }
}

Asenda käivitatava faili tee 1. sammus saadud tegeliku teega ning muuda kasutajanimi ja projekti ID. Kasuta täielikke failiteid: $HOME, %APPDATA% ja ~ ei asendu nendes JSON-näidistes automaatselt. Windowsi teedes aitavad kaldkriipsud vältida langkriipsude paotamise vigu. Salvesta fail UTF-8 vormingus, sulge Claude Desktop täielikult ja ava uuesti. Google’i Claude’i seadistusnäited

5. Kontrolli päris GA4 aruannet

Küsi kõigepealt:

Kasuta Google Analyticsi MCP-tööriistu ning loetle kontod ja andmevarad, millele mul on ligipääs. Näita iga andmevara nime ja numbrilist ID-d. Oota, kuni valin neist ühe.

Kui andmevara on valitud, küsi:

Küsi selle andmevara viimase seitsme täispäeva sessioonid, lähtudes andmevara aruandluse ajavööndist. Näita täpseid kuupäevi ja iga päeva väärtusi. Selgita, kas värskeimad andmed võivad veel puudulikud olla.

Õnnestunud aruandepäring tagastab valitud andmevara tabeli. Ebaõnnestumise korral vaata tegelikku API veateadet. Ainult rohelisest MCP-ühenduse tähisest ei piisa: protsessi käivitumine, autentimine ja andmevara lugemine on eri kontrollid. Võrdle väikest aruannet GA4-ga, kasutades sama andmevara, kuupäevi, filtreid ja mõõdikuid. See lühivastus selgitab, miks Search Console’i klikid ja GA4 sessioonid erinevad.

Esimene kasulik analüüs: millised külastused viivad tegevuseni?

Kui ühendus töötab, proovi järgmist:

  1. Võrdle liiklust: „Võrdle 28 täispäeva, mille viimane päev oli kolm päeva tagasi, sellele eelnenud 28 päevaga. Kasuta andmevara ajavööndit ja näita mõlemat täpset kuupäevavahemikku. Too kanalite kaupa välja sessioonid, kaasatud sessioonid ja kaasamismäär. Erista mõõdetud muutused võimalikest selgitustest.”
  2. Uuri maandumislehti: „Näita nende perioodide kümmet suurima sessioonide arvuga maandumislehte. Lisa sessioonide arv ja kaasamismäär. Enne muudatuste soovitamist märgi ära väikesed valimid.”
  3. Kontrolli sündmusi: „Loetle sel perioodil registreeritud sündmuste nimed. Kui vormi saatmise või müügivihje sündmus on olemas, lase mul enne maandumislehtede võrdlust valida õige sündmus. Kui seda ei mõõdeta, selgita, mis on puudu.”

Ühendus ei taasta sündmusi, mida veebileht pole kunagi mõõtnud. Samuti ei muutu AI tõlgendus automaatselt õigeks. Palu näidata iga järelduse aluseks olevat aruannet.

Värsked GA4 andmed võivad töötlemise käigus muutuda. Google’i sõnul võib töötlemine võtta 24–48 tundi. Täpsed kuupäevad ja sobiv viivitus aruandluses muudavad võrdluse lihtsamini kontrollitavaks. GA4 andmete värskus

Otsingupäringute, Google’i näitamiste ja klikkimise määra uurimiseks lisa Google Search Console’i MCP-ühendus. GA4 ja Search Console vastavad küsimuse eri osadele ning nende sessioone ja klikke ei saa käsitleda ühe ja sama loendusena.

Google Analyticsi MCP levinud vead

invalid_grant või aegunud ligipääsuluba

Käivita authorize.py uuesti ja taaskäivita MCP-kliendid, et need loeksid uued autentimisandmed. Kontrolli, kas OAuthi rakendus on endiselt Testing-olekus, kas ligipääs on tühistatud või kas konto reeglid nõuavad uut sisselogimist. Algses macOS-i seadistuses tekkis vana loa kasutamisel viga invalid_grant; pärast autentimisfaili asendamist tuli ka kliendid taaskäivitada. Google’i värskendustokenite reeglid. Vaata, miks võib Google’i OAuth-ühendus seitsme päeva järel katkeda.

403, lubamata API või puuduvad andmevarad

Kontrolli, et mõlemad Analyticsi API-d oleksid lubatud OAuthi kliendi projektis ja GOOGLE_CLOUD_PROJECT viitaks sellele projektile. Vaata üle sisselogimisel kasutatud konto ning selle õigused GA4 andmevaras. Puuduva OAuthi õiguse vea korral anna luba abiskriptiga uuesti; ära asenda faili mõne teise Google’i autentimisfailiga.

Windows ei leia käsku pipx, py või serveri faili

Kui py -3.13 pole saadaval, kontrolli Pythoni paigaldust ja käivitajat ning ava terminal uuesti. Kui pipx pole saadaval, käivita py -3.13 -m pipx ensurepath ja ava terminalirakendus täiesti uuesti. Töölauarakenduse käivitusvea korral kasuta Get-Command analytics-mcp tagastatud täielikku failiteed; macOS-is annab selle command -v analytics-mcp.

Server töötab ainult ühes koodihoidlas

Kontrolli, et Claude Code’i serverikirje oleks ulatusega user. Codexis vaata üle nii kasutajapõhine kui ka hoidla seadistus. Sama nimega projektipõhine kirje võib muuta seda, millised seaded kasutusele võetakse. Pärast muudatust alusta uut kliendiseanssi.

JSON-faili ei saa lugeda

Kasuta failina oauth_client.json allalaaditud Desktop app kliendi JSON-i ja failina credentials.json abiskripti väljundit. Kontrolli tegelikke faililaiendeid ja täielikke teid. Claude Desktopi JSON-is kasuta Windowsi failiteedes kaldkriipse või paota iga langkriips kujul \\; ära lisa shelli muutujaid ega kommentaare.

Kas ühendus saab Analyticsi muuta või töötab igas veebivestluses?

See seadistus küsib õigust analytics.readonly ega luba kirjutamistööriistu. Säilita see eristus ka uuendamisel: serveri uuemad versioonid võivad pakkuda valikulisi muutmisvõimalusi.

Juhend seadistab kohalikud MCP-kliendid. Kohalikku seadistusse lisatud server ei loo automaatselt ühendust Claude’i veebilehele ega igasse ChatGPT vestlusse. Kontrolli ühendust rakenduses või CLI-s, mille seadistasid.

Ametlikud allikad

Tahad AI oma veebilehel tööle panna?

Mudeli valimine on vaid üks osa toimivast lahendusest. Kui sinu ettevõte vajab klienditoe assistenti, sisutöövoogu või ühendust olemasoleva süsteemiga, aitan kavandada ja ehitada vajaliku kasutajaliidese, liidestused ning kontrollid.

Vaata AI-liidestusi veebilehtedele ja rakendustele⁠

Kirjutanud Henry Lõiv

Seotud juhendid

  1. Kuidas leida Search Console’i, GA4 ja AI abil veebilehe järgmised parandused Leia Search Console’i, GA4 ja AI abil veebilehe järgmised parandused. Väljamõeldud näide, tööleht ja päringud, millega kontrollida andmeid ning tulemust. JuhendSEO ja AI-otsing 3 min lugemist
  1. Parimad AI-agendid 2026: Grok Bot, Dots ja ligipääs Eestis Milline AI-agent sobib sinu tööks ja milliseid neist saab Eestis kasutada? Võrdlus koos kehtivate ligipääsutingimustega. Tehisintellekt 4 min lugemist
  2. AI-agent, vestlusrobot või automatiseerimine: mida sinu ettevõte vajab? Vestlusrobot on kasutajaliides; agent on üks viis selle taga olevat tööd korraldada. Kliendipäringu näide aitab valida ettevõttele sobiva lahenduse. Tehisintellekt 6 min lugemist
  3. Claude Code või Codex frontendi arenduses: praktiline võrdlus Dokumentatsioonil põhinev võrdlus, korratav frontendi harjutus ja tühi hindamisleht. Mõõdetud võitjat ei väideta. Tehisintellekt 6 min lugemist

Hei!

Ma armastan väga merd, jahte, päikeseloojanguid ja tähistaevast.

Läbi selle väikese 3D-maailma saan Sinuga jagada tükikest endast.

Aitäh, et selle pudeli avasid ja mu kirja lugesid.

Henry

Räägime sinu projektist

Kirjelda oma projekti

Räägi, mida soovid luua või paremaks teha. Valmis lähteülesannet pole vaja — täpsustame töömahu ja järgmised sammud koos.

01 Millega saan aidata?
02 Mitu lehte on vaja?
03 Milliseid lisasid veebileht vajab? Vali kõik sobivad
04 Millal peab töö valmis olema?
05 Projekti üksikasjad
06 Sinu kontaktandmed

Päring on vastu võetud

Aitäh!

Päring on vastu võetud. Vastan e-posti teel tavaliselt 2 tööpäeva jooksul.