Mul olid Google Analytics ja Search Console juba Macis Codexiga ühendatud. Tahtsin Design by HLi veebide kohta samu küsimusi küsida ka brauseris ChatGPT kaudu, isegi kui Mac on välja lülitatud. Panin kaks lugemisõigusega aruandlustööriista pidevalt töötavasse serverisse ja ühendasin need isikliku ChatGPT pluginana.
Valin ChatGPT vestluses plugina ja palun võrrelda põhisaidi ning andmelaua andmeid. Server korraldab sisselogimise, valib õiged Google’i andmevarad ja tagastab aruanderead. Sama lahendust saab kasutada teiste API-dega, millele sul on juurdepääs.
Võrdle põhisaidi ja andmelaua GA4 sessioone viimasel lõppenud nädalal
ning sellele eelnenud nädalal. Võrdle ka Search Console’i lõplikke
andmeid klikkide ja näitamiste kohta. Näita kummagi andmeallika
täpset kuupäevavahemikku.
Juhendis lood esmalt väikese kohaliku serveri ja seejärel ühendad oma serveri ChatGPT veebiversiooniga. Kui vajad aruandeid kohalikus Codexis, leiad ühendamise juhised eraldi artiklitest. Google Analyticsi MCP seadistus · Google Search Console’i MCP seadistus
Alusta tööriistast, mis tagastab kindla vastuse
MCP ehk Model Context Protocol võimaldab ChatGPT-l leida serveri tööriistu ja neid kindlate sisenditega käivitada. Vaja läheb Pythonit, HTTPS-i toega majutust, mis hoiab protsessi töös, ja ChatGPT töökeskkonda, mis lubab lisada enda MCP-servereid. Alusta oma arvutis funktsiooniga, mille vastus on ette teada. Nii saad tööriista leidmist ja käivitamist proovida enne Google’i ligipääsu seadistamist. OpenAI juhend enda MCP-serveri ühendamiseks
Salvesta näide failina server.py.
from fastmcp import FastMCP
mcp = FastMCP("Reporting demo")
@mcp.tool(annotations={"readOnlyHint": True})
def report_status() -> dict[str, str]:
"""Check that the demo server is responding."""
return {"status": "ready"}
if __name__ == "__main__":
mcp.run(transport="http", host="127.0.0.1", port=8000)
python3 -m venv .venv
.venv/bin/python -m pip install 'fastmcp==4.1.8'
.venv/bin/python server.py
Ava samas kaustas teine terminal ja käivita tööriist FastMCP kliendiga.
.venv/bin/python - <<'PY'
import asyncio
from fastmcp import Client
async def main():
async with Client("http://127.0.0.1:8000/mcp") as client:
result = await client.call_tool("report_status", {})
print(result.data)
asyncio.run(main())
PY
Vastuseks peaksid saama {'status': 'ready'}. Näidis kuulab ainult sinu arvuti kohalikul aadressil 127.0.0.1 ja tagastab etteantud vastuse. Lisa autentimine enne, kui teed aruandlustööriistad võrgu kaudu kättesaadavaks. FastMCP HTTP-serveri seadistus
Tee Google’i aruannetest kaks tööriista
Design by HLi seadistuses saab valida põhisaidi või andmelaua, mida tähistavad main ja dashboard. Mõlemal on oma GA4 andmevara. Search Console’i andmevara on ühine, nii et server kasutab lehefiltrit. Andmelaua aruandesse lähevad ainult andmelaua lehed ja põhisaidi aruandest jäävad need välja. ChatGPT saab küsida kuupäevavahemikku ja valida aruande jaotuse. Andmevara, API otspunkti ning filtrid määrab server.
| Tööriist | Sisendid | Aruande andmed |
|---|---|---|
| GA4 aruanne | Sait, algus- ja lõppkuupäev, jaotus ja ridade piirarv | Sessioonid, kasutajad, vaatamised ja kaasatud sessioonid |
| Search Console’i otsingutulemused | Sait, algus- ja lõppkuupäev, jaotus ja ridade piirarv | Klikid, näitamised, klikkimismäär (CTR) ja keskmine positsioon |
Kasuta GA4 Data API meetodit runReport ja Search Console’i meetodit searchAnalytics.query. Kontrolli serveris kuupäevi, lubatud jaotusi ja ridade piirarvu. Lõplike Search Console’i andmete võrdlemiseks määra dataState: final. Lisa tulemusele kasutatud kuupäevad ja ajavöönd. GA4 kuupäevad lähtuvad andmevara ajavööndist ning Search Console kasutab USA Vaikse ookeani ajavööndit. Kui hiljutise kuupäeva päring annab tühja vastuse, võib andmete töötlemine veel kesta. GA4 aruandemeetod · Search Console’i päringumeetod
readOnlyHint annab ChatGPT-le märku, et tööriist on mõeldud lugemiseks. Tegelikud ligipääsupiirangud määra serveris. Piira OAuthi õigused lugemisega, kasuta kindlaid aruandemeetodeid ja määra iga saidi jaoks andmevara. Google’i kontol võib olla ligipääs rohkematele andmevaradele. Serveri lubatud andmevarade loend määrab, mida tööriist pärida saab.
Seadista Google OAuth ja ChatGPT ühendus
Lülita Google Cloudis sisse Google Analytics Data API ja Search Console API. Loo majutatud teenusele Web application tüüpi OAuthi klient. Registreeri oma serveri täpne tagasisuunamisaadress, näiteks https://mcp.example.com/auth/callback. Kaks esimest õigust aitavad tuvastada sisseloginud konto ja kaks viimast lubavad lugeda aruandeid. Google’i veebi-OAuthi juhend · Google OAuthi õigused
openid
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/webmasters.readonly
OAuthi voos on kaks eraldi ühendust. Google saadab sisselogimise tulemuse MCP-serverisse. MCP-server annab seejärel ChatGPT-le õiguse tööriistu kasutada. Selle voo jaoks sobib näiteks FastMCP OAuth Proxy. Seadista OAuthi metaandmete automaatne leidmine, PKCE meetod S256 ja ligipääsutõendid, mis kehtivad /mcp ressursile. Lisa MCP-serveri OAuthi seadistuses lubatud aadresside loendisse täpne ChatGPT tagasisuunamisaadress, mida näed ühenduse seadetes. FastMCP OAuth Proxy · ChatGPT MCP autentimine
Minu seadistuses kontrollib server enne ligipääsu andmist ja iga tööriistapäringu ajal, et Google’i kinnitatud e-posti aadress kuulub lubatud omanikule. Hoian Google’i OAuthi kliendi salasõna ja allkirjastamisvõtit serveris. Krüpteeritud OAuthi olekut hoian veebijuurest väljaspool. Üks sisselogimine ebaõnnestus alguses, sest Google tagastas sama õiguse kahel kujul, email ja userinfo.email. Kui server hakkas mõlemat kuju sama õigusena käsitlema, läbis oodatud õiguste komplekt kontrolli.
Kui väline Google’i OAuthi rakendus on olekus Testing, kehtib nende aruandlusõigustega väljastatud värskendustõend (refresh token) seitse päeva. Püsivaks kasutuseks vali In production. Google’i verifitseerimine on eraldi protsess, milles kehtib isikliku kasutuse erand. Ligipääsu aruandlustööriistadele piirab serveri omanikukontroll. Pane kirja, kuidas Google’i andmeid kasutad ja mida MCP-server ChatGPT-le saadab. Google OAuthi avaldamisolek · Isikliku kasutuse erand · Google’i API andmekasutuse reeglid
Majuta MCP-server eraldi HTTPS-alamdomeenil
Käivita autentimisega server majutuses, mis suudab Pythoni protsessi pidevalt töös hoida. Suuna rakendusele alamdomeen, näiteks mcp.example.com, ning määra seadistuses avalik HTTPS-aadress. Näites on otspunkt https://mcp.example.com/mcp ja transpordiks Streamable HTTP. Teenus töötab majutuses ka siis, kui sinu arvuti on välja lülitatud.
Veebimajutuses lülita alamdomeenile sisse sertifikaat ja HTTPS-ile suunamine. Käivita rakendus PM2 abil Pythoni virtuaalkeskkonnast ning pane see kuulama majutuse aadressil ELKDATA_APP_IP ja vabal pordil. Vali iseteeninduses Portide suunamine ja suuna kogu MCP alamdomeen sellele pordile. Nii on /mcp kõrval kättesaadavad ka OAuthi metaandmete, autoriseerimise ja tagasisuunamise aadressid. Kui rakendus töötab, salvesta PM2 protsesside loend, et majutus saaks teenuse hoolduse järel taastada. Veebimajutuse portide suunamine · Veebimajutuse PM2 juhend
Enne ChatGPT-ga ühendamist proovi otspunkti ilma autentimiseta.
curl -i 'https://mcp.example.com/mcp' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Oodatud vastus on 401 Unauthorized. Selle päis WWW-Authenticate viitab kaitstud ressursi metaandmetele. Ava päises toodud link ja kontrolli, et ressursi ning autoriseerimisserveri URL-id vastavad sinu avalikule seadistusele. Kui saan siin vastuseks 502, kontrollin esmalt protsessi olekut, kuulamisaadressi ja vaheserveri porti. OpenAI ühenduse testimise juhend
Paigalda isiklik plugin ChatGPT veebiversioonis
- Ava ChatGPT veebiversioonis Plugins ja vali plussmenüüst Add custom MCP server.
- Sisesta nimi ja täielik HTTPS-aadress koos
/mcpteega. Vali OAuth. Vali CIMD, kui autoriseerimisserver toetab kliendi ID metaandmete dokumente (Client ID Metadata Documents) ja ühenduse seadetes on see valik olemas. - Kontrolli autoriseerimisserveri identifikaatorit (issuer), tagasisuunamisaadressi ja õigusi. CIMD puhul kasutab ChatGPT kliendi metaandmete URL-i ning Google’i OAuthi kliendi salasõna jääb sinu serverisse.
- Vali Create as a plugin. Paigalda plugin isiklike pluginate loendist ja logi sisse Google’i kontoga, mille server on lubanud.
- Vali uues vestluses
@abil plugin ja küsi aruannet kuupäeva kohta, mille andmeid saad kontrollida. OpenAI juhend enda MCP-serveri ühendamiseks
Kontrolli mõlemat aruandlustööriista
Tegin ChatGPT veebiversioonis neli proovipäringut. Küsisin nii põhisaidi kui ka andmelaua kohta ühe GA4 aruande ja ühe Search Console’i aruande. Kõik neli päringut tagastasid andmed. Võrdle tulemusi Google’i kasutajaliidestes samade kuupäevadega. Nii märkad kiiresti, kui aruandesse satub vale andmevara, andmelaua filter hõlmab põhisaidi lehti või Search Console’i andmed on veel esialgsed.
Proovi päringut tundmatu saiditähisega ja sisselogimist kontoga, mis puudub lubatud kontode loendist. Kontrolli, et ilma ligipääsutõendita päring saab endiselt vastuseks 401. Taaskäivita teenus ja veendu, et sama ChatGPT ühenduse kaudu saab pärast seda aruannet lugeda. Kui muudad tööriista nime või sisendeid, värskenda enne uut katset ChatGPT ühenduse seadetes tööriista metaandmeid. OpenAI plugina testimise juhend
Kui ühendus töötab, võrdle alustuseks viimast lõppenud nädalat sellele eelnenud nädalaga. Anna ette täpsed kuupäevad ja küsi, millised lehed selgitavad kõige suuremat muutust. Kuidas võrdlen GA4 ja Search Console’i andmeid
Arendad oma veebirakendusele uut võimalust?
Tehnilise lahenduse väärtus selgub kasutaja töös. Ehitan kasutajaliideseid, ühendan need olemasolevate API-dega ja aitan tootetiimidel funktsioone täiendada, arvestades ka laadimise, tühja vaate ja vigadega.
Vaata veebirakenduste kasutajaliideste arendust
Seotud tööd ja näited
Dashboard
COVIDi andmevaatest kasvas isiklik töölaud ja praktiliste veebitööriistade kogu. Pikaajaline Reacti projekt, kus õppisin siduma kasutajaliidest, interaktiivseid graafikuid ja päris andmeid.