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

JuhendArendus 6 min lugemist

Kuidas luua privaatne ChatGPT MCP-⁠plugin

Ehita ChatGPT-le privaatne MCP-plugin, mis loeb Google Analytics 4 ja Search Console’i andmeid. Seadista OAuth, majuta server ja testi ühendust.

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ööriistSisendidAruande andmed
GA4 aruanneSait, algus- ja lõppkuupäev, jaotus ja ridade piirarvSessioonid, kasutajad, vaatamised ja kaasatud sessioonid
Search Console’i otsingutulemusedSait, algus- ja lõppkuupäev, jaotus ja ridade piirarvKlikid, 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

  1. Ava ChatGPT veebiversioonis Plugins ja vali plussmenüüst Add custom MCP server.
  2. Sisesta nimi ja täielik HTTPS-aadress koos /mcp teega. Vali OAuth. Vali CIMD, kui autoriseerimisserver toetab kliendi ID metaandmete dokumente (Client ID Metadata Documents) ja ühenduse seadetes on see valik olemas.
  3. 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.
  4. Vali Create as a plugin. Paigalda plugin isiklike pluginate loendist ja logi sisse Google’i kontoga, mille server on lubanud.
  5. 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.

Kirjutanud Henry Lõiv

  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.