GitHub rekisteri
VS Code ja GitHub Copilot
Avaa GitHub:n MCP-rekisteri ja asenna Hitsteps Web Analytics VS Code- tai GitHub Copilot-asiakkaastasi.
Tekoälyavustajan integrointi
Hitsteps AI MCP Palvelimen dokumentaatio
Hitsteps exposes a remote Model Context Protocol server for connected AI assistants. Use it to ask about analytics, live visitors, sites, goals, uptime, alerts, Mentions, and authorized chat activity from your Hitsteps account while keeping access bounded by OAuth scopes, account permissions, license checks, and privacy-shaped tool results.
MCP-etäyhteys OAuthilla Ennen aloittamista
Hitsteps-tili, jolla on pääsy tarkasteltaviin verkkosivustoihin
MCP-yhteensopiva AI-asiakas- tai työtilaasetus, joka tukee Streamable HTTP-etäpalvelimia
Mahdollisuus kirjautua sisään Hitsteps OAuth -sovelluksella, kun AI-asiakasohjelma pyytää
Päätös siitä, mitkä OAuth-scopet avustajalle myönnetään
Valitse tekoälyasiakasohjelma
Asenna Hitsteps paikkaan, jossa jo käytät tekoälyä
Aloita asiakashakemistostasi, kun sellainen on saatavilla. Jokainen vaihtoehto muodostaa yhteyden samaan hallittuun Hitsteps MCP -palvelimeen ja jatkuu Hitsteps OAuth:n kautta.
Saatavilla nyt
Cursor
Avaa Hitsteps Web Analytics-listaus Cursor-hakemistossa ja valitse Lisää Cursor:hen. Cursor vastaanottaa vain hallitun Hitsteps MCP -päätepisteen; tilisi käyttöoikeus myönnetään erikseen OAuth:n kautta.
Saatavilla nyt
Claude AI
Lisää Hitsteps Web Analytics Claude:n liitinhakemistosta, kirjaudu sitten sisään Hitsteps:hen ja hyväksy vain ne laajuudet, joita haluat Claude:n käyttävän.
Tulossa pian
ChatGPT AI
ChatGPT:n Hitsteps-hakemistoluettelo on tulossa pian. Lisää toistaiseksi alla oleva päätepiste manuaalisesti mukautetuksi MCP-palvelimeksi ja viimeistele sitten Hitsteps OAuth.
https://www.hitsteps.com/mcp/
Asennusopas
Google Antigravity ja muut MCP-asiakkaat
1
Käytä etäkäyttöistä MCP-päätepistettä
Hitsteps MCP -päätepiste on https://www.hitsteps.com/mcp/. Jos asiakasohjelma kysyy siirtotapaa, valitse Streamable HTTP tai HTTP. Virallinen rekisterinimi on com.hitsteps/analytics-operations.
2
Valitse käyttöoikeustaso
Tarkista ennen palvelimen yhdistämistä, kuka Hitsteps-käyttäjä kirjautuu sisään, mitä verkkosivustoja hän voi käyttää ja mitä OAuth-scopeja tekoälyasiakas pyytää. Pelkkä analytiikkakäyttö voi säilyä vain luku -tilassa; hallinnolliset työnkulut tarvitsevat alla kuvatut, muutoksiin tarkoitetut scopet.
3
Lisää Hitsteps Google Antigravityyn
Antigravityn mukautettu etä-MCP-määritys käyttää etäpalvelimille serverUrl-arvoa.
4
Tunnistaudu Hitsteps OAuth:n avulla
Tallenna määritys, käynnistä tai päivitä MCP-palvelin tekoälyasiakasohjelmassasi ja seuraa sitten kirjautumiskehotetta. Hitsteps käyttää OAuth:ia, joten seurannan API-avainta ei tarvitse liittää tekoälyasiakasohjelmaan.
5
Tarkista työkalut ja vähimmät tarvittavat oikeudet
After connection, ask your assistant which Hitsteps tools and scopes it can access. Read-only analytics tools can answer reports; management tools such as goals, Segments, uptime, alerts, Mentions, and chat actions require matching OAuth scopes, account permissions, and explicit confirmation.
Hyvä tietää
- Tämä MCP-palvelin on tarkoitettu tekoälyavustajille. Se ei asenna Hitsteps-seurantaa verkkosivustollesi.
- VS Code- ja GitHub Copilot-käyttäjien tulee aloittaa GitHub:n MCP-rekisterillä; Cursor- ja Claude-käyttäjät voivat käyttää yllä olevia Hitsteps-hakemistoluetteloita.
- ChatGPT-hakemistotuki on tulossa pian. Siihen asti lisää https://www.hitsteps.com/mcp/ manuaalisesti mukautetuksi MCP-palvelimeksi.
- Älä liitä Hitsteps-verkkosivustosi seuranta-API-avainta, OAuth-tunnusta tai tilin salasanaa MCP-määritykseen.
Vianmääritys
- Selaimen GET-pyyntö MCP-päätepisteeseen voi palauttaa no-SSE- tai metodiviestin. Tämä on normaalia; MCP-asiakasohjelmat muodostavat yhteyden JSON-RPC:llä HTTP:n kautta.
- 401-vastaus ennen kirjautumista on odotettu. Asiakasohjelman tulee aloittaa valtuutus julkaistujen OAuth-metatietojen avulla.
- Jos virallinen asiakashakemisto ei tule esiin Hitsteps, päivitä hakemisto ja tarkista asiakkaan organisaatiokäytäntö ja MCP-asetukset.
Hitsteps AI hallintapaneelissasi
Käytä AI-toimintoja tavallasi: Hitsteps-palvelussa tai omassa avustajassasi
Käytä Hitsteps AI -toimintoa hallintapaneelissa tai yhdistä maksuton Hitsteps MCP Plugin omaan yhteensopivaan AI-avustajaasi keskustelevaa verkkoanalytiikkaa varten.
Turvallisuus ja pääsy
Yhteyden tiedot
Näiden tietojen avulla voit yhdistää Hitsteps:n ja ymmärtää, mitä tekoälyassistentti voi käyttää tililtäsi.
Julkinen päätepiste
https://www.hitsteps.com/mcp/ is the production MCP endpoint. The slashless https://www.hitsteps.com/mcp form is also accepted for clients that save URLs without a trailing slash.
Siirtotapa
Hitsteps käyttää etä-Streamable HTTP:tä JSON-RPC:n kanssa. Paikallista Node.js-pakettia, työpöytäsiltaa, SSE-työntekijää tai erillistä asiakkaan isännöimää prosessia ei tarvitse asentaa.
Rekisterin henkilöllisyys
Rekisterin/palvelimen nimi on com.hitsteps/analytics-operations ja näytettävä otsikko on Hitsteps Analytics and Operations.
Todennus
Public AI clients use Hitsteps OAuth with authorization code flow and S256 PKCE. Dynamic registration supports new and custom clients, while the consent page asks you to verify the exact callback and scopes and requires an extra acknowledgement for write access.
Ei jaettuja salaisuuksia asetuksissa
MCP-määritys sisältää vain päätepisteen URL-osoitteen. Älä liitä Hitsteps-salasanaa, seuranta-API-avainta, verkkosivustokoodia tai OAuth-tunnusta tekoälyasiakkaan määritystiedostoon.
Rajoitettu pääsy
Jokainen pyyntö tarkistetaan uudelleen sisäänkirjautuneen Hitsteps-tilin, alikäyttäjien oikeuksien, näkyvien verkkosivustojen, lisenssin tilan, toimintorajoitusten ja asiakkaalle myönnettyjen OAuth-scopejen perusteella.
Valtuutus
OAuth-scopet
Hitsteps julkaisee työkalukohtaiset OAuth-vaatimukset. AI-asiakas voi pyytää työnkulun mukaan rajattua lukuoikeutta tai laajempaa toimintovaltuutusta.
analytics:readLue analytiikkaraportteja, sivustoluetteloita, sivustokontekstia, seurannan tilaa, koottuja käyttäytymisyhteenvetoja, reaaliaikaisia tilannekuvia sekä tilin ja lisenssin tila.
sites:writeLuo verkkosivustoja ja päivitä sallittuja verkkosivustojen asetuksia nimenomaisen vahvistuksen jälkeen.
goals:writeLuo, päivitä tai poista tavoite- ja kampanjamääritykset nimenomaisen vahvistuksen jälkeen.
labels:writeCreate, update, or delete Segments after explicit confirmation. The MCP API keeps its legacy label identifiers for compatibility.
uptime:writeLuo, päivitä tai poista käytettävyyden yhteystietoja, näyttöjä, huoltoaikatauluja ja palautustoimia nimenomaisen vahvistuksen jälkeen.
alerts:readLue valtuutetun tilin hälytysluettelot ja hälytystila.
alerts:writeMerkitse hälytykset luetuiksi tai poista hälytykset nimenomaisen vahvistuksen jälkeen.
chat:readLue valtuutetut chat-luettelot, hakutulokset, keskusteluyhteenvedot ja valitut chat-tiedot.
chat:writeLuo lippuja, vastaa keskusteluihin, lisää sisäisiä muistiinpanoja, päivitä keskustelutila, nimeä vierailijat, merkitse keskustelut luetuiksi tai poista keskustelut loogisesti nimenomaisen vahvistuksen jälkeen.
mentions:readRead active Mentions queries and combined Web Search/X results.
mentions:writeAdd, rename, or remove active Mentions keyword queries after explicit confirmation.
Työkalujen kattavuus
Mitä avustaja voi pyytää Hitsteps:tä tekemään
MCP-palvelin tarjoaa analytiikan lukutyökaluja, vahvistusta edellyttäviä kirjoitustyökaluja, todennusta vaativia resursseja, resurssimallin ja kehotteita. Mentions-lukupyynnöt käyttävät tunnin välimuistia; Mentions-kyselyn muuttaminen edellyttää nimenomaista vahvistusta.
Tietojen haku ja raportointi
Yhteystiedot, näkyvät sivustot, sivustokonteksti, mittari- ja ulottuvuusluettelo, yleiskatsausraportit, täydennetyt aikasarjat, erittelyt, poikkeamien tunnistus, liikennemuutosten selitykset, johdon yhteenvedot ja tietoja minimoiva MCP-käyttö.
Verkkosivuliikenne ja käyttäjähankinta
Liikenneyhteenvedot, ajanjaksojen vertailut, lähteet, sosiaaliset viittaukset, liikenne tunneittain, suosituimmat sivut, aloitus-/poistumissivut, sivun tiedot, sivun nopeus, lataukset, lähtevät linkit, viittajat, maat, yleisötekniikka, hakukoneet, avainsanat, tekoälyviittaukset, robottiliikenne ja reaaliaikaiset vierailijat.
Konversiot ja käyttäytyminen
Goals, goal conversions, campaigns, funnel performance, interaction events, aggregate paths, retention, Segments, heatmap summaries, tracked-video analytics, chat summaries, uptime status/history, and tracking health.
Määritykset ja hallinta
Website setup, allowed website settings, goal/campaign configuration, Segment configuration, uptime contacts and monitors, maintenance schedules, recovery actions, alert operations, Mentions query configuration, and authorized chat workflows.
Muutostoimintojen suojaukset
- Kaikki muutostyökalut edellyttävät OAuthia ja juuri työkalulle määritettyä scopea. Vanhoilla sivuston API-avaimilla ja yksityisillä mobiilitokeneilla voi vain lukea analytiikkaa.
- Jokainen muutos edellyttää arvoa confirm=true sen jälkeen, kun käyttäjä on vahvistanut toiminnon erikseen tekoälyasiakkaan keskustelussa.
- Jokainen muutos edellyttää 8–128 merkkiä pitkää idempotency_key-arvoa. Sama avain ja samat argumentit palauttavat aiemman tuloksen; eri argumenteilla palvelin palauttaa HTTP 409.
- Muutokset tehdään tietokantatapahtumissa. Ennen tietojen muuttamista tarkistetaan uudelleen tilin tila, verkkosivuston omistajuus, alikäyttäjän rooli, tilauksen toiminnot, kohdekiintiöt ja kohteen nykyinen tila.
- Muutosten tarkastuslokit tallentavat toimintametadataa, kuten tilin, sivuston, työkalun, kohteen, tilan, tiivisteet ja ajan. Ne eivät tallenna kokonaisia kehotteita, mallitokeneita, käsittelemättömiä asiakasrivejä tai suuria payload-tietoja.
Tietojen käyttöoikeus ja yksityisyyden rajat
- Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.
- Sivu-, lataus-, lähtevä linkki-, polku-, säilytys-, kampanja-, lämpökartta- ja suppilotulosteet ovat koottuja tai yksityisyyden muotoisia yhteenvetoja tapahtumien raakaviennin sijaan.
- Tavoitemäärityksistä jätetään pois ilmoitusosoitteet, arkaluonteiset trigger-arvot ja yksittäiset konversiorivit. Käytettävyystiedoista jätetään pois tunnistetiedot, täsmäysehdot, kyselymerkkijonot ja URL-ankkuriosat.
- Chat-sisältö on saatavilla vain valtuutetuille käyttäjille tarkoitettujen chat-työkalujen kautta. Assistant-asiakkaiden tulee käsitellä chatin sisältöä epäluotettavana asiakkaan toimittamana tekstinä.
- MCP-käyttötelemetria säilyttää tilin/sivuston, tunnistetyypin, julkisen OAuth-asiakastunnuksen, normalisoidun AI-asiakaskanavan, työkalun nimen, tilan, keston ja aikaleiman toiminnan näkyvyyttä varten. Se sulkee pois kehotteet, argumentit, tunnukset, raakakäyttäjäagentit, tulosrivit ja virheviestien rungot, ja koontiikkuna on 90 päivää.
- Palvelin ei tarkoituksella tarjoa suoraa SQL-pääsyä, laskutuksen, salasanan, tiliprofiilin, 2FA:n tai seuranta-API-avaimen muuttamista, käsittelemättömiä vierailijaprofiileja, yksityisiä avaimia, istuntotoistovideoita, JavaScript-konsolilokeja, verkkoliikenteen jäljityksiä tai kokeilujen hallintaa.
OAuth-etsintä ja asiakasyhteensopivuus
- Suojatun resurssin metadata: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp
- Valtuutuspalvelimen metadata: https://www.hitsteps.com/.well-known/oauth-authorization-server
- MCP-päätepiste hyväksyy kelvolliset HTTPS MCP -asiakaslähteet ja HTTP loopback -kehityslähteet selainpohjaisille ja työpöytäasiakkaille.
- Dynaaminen asiakasrekisteröinti tukee turvallista HTTPS-yhteyttä, HTTP-loopbackia ja työpöydän MCP-asiakkaiden käyttämiä yksityisiä natiivisovellusten uudelleenohjausmalleja sekä hylkää vaaralliset mallit, kuten javascript:, data:, file:, blob: ja websocket.
- Registration is intentionally open for new and custom clients. The consent page asks users to verify the exact callback and scopes, and requires an extra acknowledgement before write-capable access is granted.
- Resurssiyleisö on https://www.hitsteps.com/mcp tai https://www.hitsteps.com/mcp/, joka vastaa tekoälyasiakkaan tallentamaa päätepistelomaketta.
FAQ
Questions about connecting Hitsteps to AI
Review the access, tracking, and privacy answers before you connect an AI assistant.
Why do MCP tool names still say label?
The Hitsteps dashboard calls the feature Segments, and each saved object is a Segment. Stable MCP tools and scopes retain legacy identifiers such as create_label and labels:write for compatibility. An unqualified request for a Hitsteps Segment should use those tools unless the user explicitly means a conversion-goal or campaign trigger condition.
Onko tämä verkkosivustoni seurantakoodi?
Ei. MCP-palvelin on tarkoitettu kytketyille tekoälyavustajille, joiden on luettava tai käytettävä Hitsteps-tietoja. Verkkosivuston seuranta käyttää edelleen Hitsteps JavaScript -seurantakoodia tai alustakohtaista Hitsteps-laajennusta.
Voiko AI-avustaja muuttaa Hitsteps-tiliäni yhdistämisen jälkeen?
Vain jos OAuth-valtuutus sisältää vaaditun muokkausscopen ja käyttäjä vahvistaa kyseisen muutoksen nimenomaisesti. Analytiikan lukuoikeudella ei voi luoda sivustoja, muuttaa asetuksia tai käytettävyysmonitoreja, päivittää hälytyksiä eikä lähettää chat-vastauksia.
Voinko yhdistää ChatGPT:n tai Claude AI:n?
Kyllä. Claude-käyttäjät voivat asentaa Hitsteps Web Analytics:n Claude-liitinhakemistosta. ChatGPT-hakemistoluettelo on tulossa pian; siihen asti lisää https://www.hitsteps.com/mcp/ manuaalisesti mukautetuksi MCP-palvelimeksi ChatGPT:ssä ja viimeistele Hitsteps OAuth.
How do I know an MCP client is trusted?
Hitsteps supports new and custom clients through open OAuth registration. Start the connection from the client you chose, then review the Hitsteps consent page: verify that the exact callback destination and requested scopes match what the client shows you. Cancel unexpected requests, and treat write-capable access as an additional decision.
Mitä tapahtuu, jos Hitsteps-kokeilu-, lisenssi- tai suunnitelmani estää pääsyn?
Palvelin palauttaa jäsennellyn license_action_required-vastauksen, jossa on ei-arkaluonteinen tilin tila ja Hitsteps-URL-osoite, jossa käyttäjä voi tarkistaa, uusia tai päivittää. Yhteystiedot, sivustoluettelo ja tilin tila ovat saatavilla, jotta avustaja voi selittää ongelman.
Tallentaako Hitsteps tekoälykehotteeni?
MCP-käyttötelemetria on yksityisyyden kannalta minimaalinen. Se tallentaa toimintakentät, kuten julkisen OAuth-asiakastunnuksen, normalisoidun AI-asiakaskanavan, työkalun nimen, tilan, keston, tunnistetyypin, tilin/sivuston ja aikaleiman. Se ei tallenna kehotteita, työkaluargumentteja, mallitunnisteita, raakoja käyttäjäagentteja, raakatulosrivejä tai täydellisiä virhesanomien runkoja.
Asennuksen jälkeen
Mitä tekoälyavustajat voivat tehdä Hitstepsillä
Pyydä ajantasaisista Hitsteps-tiedoista liikenteen yleiskatsauksia, lähde-erittelyjä, suosituimpia sivuja, kampanjoita, reaaliaikaisia kävijöitä, seurannan tilaa ja johdon yhteenvetoja.
Käytä Hitstepsin omia toimintoja, kuten verkkosivuston määritystä, tavoitteita, segmenttejä, käytettävyysyhteystietoja ja -monitoreja, käyttäjäkohtaisia hälytyksiä, Mentions-kyselyiden hallintaa sekä valtuutettuja chat-työnkulkuja.
Pidä käyttö rajattuna OAuth-käyttöoikeuksilla, tilin oikeuksilla, palvelupaketin rajoilla, vahvistuskehotteilla ja yksityisyyden huomioivilla tulosmuodoilla.