Integrasjon med AI-assistent

Hitsteps AI MCP Serverdokumentasjon

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.

Velg AI-klienten din Alle integrasjoner

Før du begynner

En Hitsteps-konto med tilgang til nettstedene du vil undersøke
En MCP-kompatibel AI-klient eller arbeidsområdeinnstilling som støtter eksterne Streamable HTTP-servere
Evne til å logge på med Hitsteps OAuth når AI-klienten spør
En beslutning om hvilke OAuth-scopes assistenten skal tildeles

Velg AI-klienten din

Installer Hitsteps der du allerede bruker AI

Start i katalogen til AI-klienten når den er tilgjengelig. Alle alternativene kobles til den samme administrerte Hitsteps MCP-serveren og fortsetter deretter via Hitsteps OAuth.

GitHub-registeret

VS Code og GitHub Copilot

Åpne GitHubs MCP-register og installer Hitsteps Web Analytics fra din VS Code- eller GitHub Copilot-klient.

Åpne GitHub MCP-registeret
Tilgjengelig nå

Cursor

Åpne Hitsteps Web Analytics-oppføringen i Cursor-katalogen og velg Legg til Cursor. Cursor mottar bare det administrerte Hitsteps MCP-endepunktet; kontotilgangen din gis separat gjennom OAuth.

Åpne Cursor-katalogen
Tilgjengelig nå

Claude AI

Legg til Hitsteps Web Analytics fra Claudes Connector Directory. Logg deretter på Hitsteps og godkjenn bare OAuth-scopene du vil at Claude skal bruke.

Åpne Claude-connectoren
Kommer snart

ChatGPT AI

Hitsteps-katalogoppføringen for ChatGPT kommer snart. For nå, legg til endepunktet nedenfor manuelt som en tilpasset MCP-server, og fullfør deretter Hitsteps OAuth.

https://www.hitsteps.com/mcp/

Installasjonsveiledning

Google Antigravity og andre MCP-klienter

1

Bruk det eksterne MCP-endepunktet

Hitsteps MCP-endepunktet er https://www.hitsteps.com/mcp/. Hvis klienten ber om en transporttype, velger du Streamable HTTP eller HTTP. Det offisielle registernavnet er com.hitsteps/analytics-operations.

2

Velg tilgangsnivå

Før serveren kobles til, må du kontrollere hvilken Hitsteps-bruker som logger på, hvilke nettsteder brukeren har tilgang til, og hvilke OAuth-scopes AI-klienten ber om. Ren analysebruk kan nøye seg med leserettigheter; administrative arbeidsflyter krever de spesifikke scopene for endringer som beskrives nedenfor.

3

Legg til Hitsteps i Google Antigravity

Antigravity bruker serverUrl for eksterne servere i sin egendefinerte eksterne MCP-konfigurasjon.

4

Autentiser med Hitsteps OAuth

Lagre konfigurasjonen, start eller oppdater MCP-serveren i AI-klienten, og følg deretter påloggingsmeldingen. Hitsteps bruker OAuth, så du trenger ikke å lime inn API-nøkkelen for sporing i AI-klienten.

5

Kontroller verktøy og minste nødvendige tilgang

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.

Greit å vite

  • Denne MCP-serveren er for AI-assistenter. Den installerer ikke Hitsteps-sporing på nettstedet ditt.
  • VS Code- og GitHub Copilot-brukere bør starte med GitHubs MCP-register; Cursor- og Claude-brukere kan bruke de dedikerte Hitsteps-katalogoppføringene ovenfor.
  • ChatGPT katalogstøtte kommer snart. Inntil da, legg til https://www.hitsteps.com/mcp/ manuelt som en tilpasset MCP-server.
  • Ikke lim inn din Hitsteps-nettstedsporing API-nøkkel, OAuth-token eller kontopassord i MCP-konfigurasjonen.

Feilsøking

  • En GET-forespørsel fra en nettleser til MCP-endepunktet kan returnere en no-SSE- eller metodemelding. Det er normalt; MCP-klienter kobler til med JSON-RPC over HTTP.
  • Et 401-svar før pålogging er forventet. Klienten bør bruke de publiserte OAuth-metadataene til å starte autorisasjonen.
  • Hvis Hitsteps ikke vises i en offisiell klientkatalog, oppdaterer du katalogen og kontrollerer klientens organisasjonspolicy og MCP-innstillinger.

Hitsteps AI i kontrollpanelet ditt

Bruk AI på din måte: i Hitsteps eller i din egen assistent

Bruk Hitsteps AI direkte i kontrollpanelet, eller koble gratis Hitsteps MCP Plugin til din egen kompatible AI-assistent for samtalebasert webanalyse.

Se ledetekster, eksempelsvar og fordelen med MCP

Sikkerhet og tilgang

Tilkoblingsdetaljer

Bruk disse detaljene for å koble til Hitsteps og forstå hva AI-assistenten kan få tilgang til fra kontoen din.

Offentlig endepunkt

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.

Dataoverføring

Hitsteps bruker ekstern Streamable HTTP med JSON-RPC. Det er ingen lokal Node.js-pakke, skrivebordsbro, SSE-arbeider eller separat kundevertsbasert prosess å installere.

Registeridentitet

Registeret/servernavnet er com.hitsteps/analytics-operations og den viste tittelen er Hitsteps Analytics and Operations.

Autentisering

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.

Ingen delte hemmeligheter i konfigurasjonen

MCP-konfigurasjonen inneholder bare endepunkt-URLen. Ikke lim inn et Hitsteps-passord, sporing av API-nøkkel, nettstedkode eller OAuth-token i en AI-klientkonfigurasjonsfil.

Avgrenset tilgang

Hver forespørsel kontrolleres på nytt mot den innloggede Hitsteps-kontoen, underbrukerrettigheter, synlige nettsteder, lisensstatus, funksjonsgrenser og OAuth-scopene klienten har fått tildelt.

Autorisasjon

OAuth-scopes

Hitsteps publiserer en OAuth-erklæring for hvert verktøy. En AI-klient kan, avhengig av ønsket arbeidsflyt, be om avgrenset skrivebeskyttet tilgang eller en bredere operativ tillatelse.

analytics:read
Les analyserapporter, nettstedslister, nettstedskontekst, sporingsstatus, aggregerte atferdsoversikter, øyeblikksbilder i sanntid og konto- eller lisensstatus.
sites:write
Opprett nettsteder og oppdater tillatte nettstedinnstillinger etter eksplisitt bekreftelse.
goals:write
Opprett, oppdater eller slett mål- og kampanjekonfigurasjon etter eksplisitt bekreftelse.
labels:write
Create, update, or delete Segments after explicit confirmation. The MCP API keeps its legacy label identifiers for compatibility.
uptime:write
Opprett, oppdater eller slett oppetidskontakter, monitorer, vedlikeholdsplaner og gjenopprettingshandlinger etter eksplisitt bekreftelse.
alerts:read
Les varslingslister og varslingsstatus for den autoriserte kontoen.
alerts:write
Merk varsler som leste eller slette varsler etter eksplisitt bekreftelse.
chat:read
Les autoriserte chattelister, søkeresultater, samtalesammendrag og utvalgte chattedetaljer.
chat:write
Opprett billetter, svar på chatter, legg til interne notater, oppdater chatstatus, navngi besøkende, merk chatter som lest, eller slett logisk chatter etter eksplisitt bekreftelse.
mentions:read
Read active Mentions queries and combined Web Search/X results.
mentions:write
Add, rename, or remove active Mentions keyword queries after explicit confirmation.

Verktøydekning

Hva assistenten kan be Hitsteps om å gjøre

MCP-serveren tilbyr leseverktøy for analyse, skriveverktøy med bekreftelse, autentiserte ressurser, en ressursmal og ledetekster. Mentions-lesinger bruker en hurtigbuffer på én time; endring av en Mentions-spørring krever uttrykkelig bekreftelse.

Analyse og rapportering

Tilkoblingsinformasjon, synlige nettsteder, nettstedskontekst, katalog over målinger og dimensjoner, oversiktsrapporter, utfylte tidsserier, fordelinger, avviksdeteksjon, forklaringer på trafikkendringer, ledelsesoppsummeringer og dataminimal MCP-bruk.

Nettstedstrafikk og trafikkanskaffelse

Trafikksammendrag, periodesammenligninger, kilder, sosiale henvisninger, trafikk per time, toppsider, inngangs-/utgangssider, sidedetaljer, sidehastighet, nedlastinger, utgående lenker, henvisninger, land, målgruppeteknologi, søkemotorer, nøkkelord, AI-henvisninger, bottrafikk og besøkende i sanntid.

Konverteringer og oppførsel

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.

Konfigurasjon og drift

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.

Sikkerhetskrav for endringer

  • Alle endringsverktøy krever OAuth og nøyaktig det scopet som er angitt for verktøyet. Eldre API-nøkler for nettsteder og private mobiltokener kan bare lese analysedata.
  • Hver endring krever confirm=true etter at brukeren uttrykkelig har bekreftet handlingen i samtalen med AI-klienten.
  • Hver endring krever en idempotency_key på 8 til 128 tegn. Brukes samme nøkkel på nytt med samme argumenter, returneres det forrige resultatet; med andre argumenter returneres HTTP 409.
  • Endringer utføres i databasetransaksjoner. Før data endres, kontrolleres kontostatus, eierskap til nettstedet, underbrukerrollen, tilgjengelige abonnementsfunksjoner, objektkvoter og målets gjeldende tilstand på nytt.
  • Revisjonsposter for endringer lagrer driftsmetadata som konto, nettsted, verktøy, mål, status, hasher og tidspunkt. De lagrer ikke fullstendige prompter, modelltokener, rå kundedatarader eller store payloads.

Datatilgang og personverngrenser

  • Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.
  • Side, nedlasting, utgående kobling, bane, oppbevaring, kampanje, varmekart og traktutdata er samlede eller personvernformede sammendrag i stedet for rå hendelseseksporter.
  • Målkonfigurasjonen utelater varslingsadresser, sensitive utløserverdier og individuelle konverteringsrader. Oppetidsdata utelater legitimasjon, samsvarsbetingelser, spørringsstrenger og URL-fragmenter.
  • Chat-innhold er kun tilgjengelig via chat-omfattende verktøy for autoriserte brukere. Assistent-klienter bør behandle chatinnhold som upålitelig kundelevert tekst.
  • MCP brukstelemetri beholder konto/nettsted, legitimasjonstype, offentlig OAuth klient-ID, normalisert AI-klientkanal, verktøynavn, status, varighet og tidsstempel for operasjonell synlighet. Den ekskluderer forespørsler, argumenter, tokens, rå brukeragenter, resultatrader og feilmeldingstekster, og sammendragsvinduet er 90 dager.
  • Serveren gir bevisst ikke direkte SQL-tilgang, mulighet til å endre fakturering, passord, kontoprofiler, 2FA eller tracking-API-nøkler, ubehandlede besøksprofiler, private nøkler, video fra øktavspilling, JavaScript-konsolllogger, nettverksspor eller administrasjon av eksperimenter.

OAuth oppdagelse og klientkompatibilitet

  • Metadata for den beskyttede ressursen: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp
  • Metadata for autorisasjonsserveren: https://www.hitsteps.com/.well-known/oauth-authorization-server
  • MCP-endepunktet godtar gyldige HTTPS MCP-klientopprinnelser og HTTP loopback-utviklingsopprinnelser for nettleserbaserte og stasjonære klienter.
  • Dynamisk klientregistrering støtter sikre HTTPS-, HTTP-loopback- og private omdirigeringsskjemaer for native apper som brukes av MCP-klienter på datamaskiner, og avviser usikre skjemaer som javascript:, data:, file:, blob: og 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.
  • Ressurspublikummet er https://www.hitsteps.com/mcp eller https://www.hitsteps.com/mcp/, som samsvarer med endepunktskjemaet som er lagret av AI-klienten.

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.

Er dette sporingskoden for nettstedet mitt?

Nei. MCP-serveren er for tilkoblede AI-assistenter som trenger å lese eller operere på Hitsteps-data. Nettstedsporing bruker fortsatt Hitsteps JavaScript-sporingskoden eller en plattformspesifikk Hitsteps-plugin.

Kan en AI-assistent endre Hitsteps-kontoen min etter at jeg har koblet den til?

Bare hvis OAuth-tillatelsen inneholder scopet som kreves for endringen, og brukeren uttrykkelig bekrefter den konkrete handlingen. Analysetilgang med bare leserettigheter kan ikke opprette nettsteder, endre innstillinger eller oppetidsmonitorer, oppdatere varsler eller sende chatsvar.

Kan jeg koble til ChatGPT eller Claude AI?

Ja. Claude-brukere kan installere Hitsteps Web Analytics fra Claude Connector Directory. ChatGPT-katalogoppføringen kommer snart; Inntil da, legg til https://www.hitsteps.com/mcp/ manuelt som en tilpasset MCP-server i ChatGPT og fullfør 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.

Hva skjer hvis prøveversjonen, lisensen eller planen min Hitsteps begrenser tilgang?

Serveren returnerer et strukturert license_action_required-svar med ikke-sensitiv kontostatus og en Hitsteps URL der brukeren kan sjekke, fornye eller oppgradere. Tilkoblingsinformasjon, nettstedoppføring og kontostatus forblir tilgjengelig slik at assistenten kan forklare problemet.

Lagrer Hitsteps mine AI-meldinger?

MCP brukstelemetri er personvernminimal. Den registrerer operasjonelle felt som offentlig OAuth klient-ID, normalisert AI-klientkanal, verktøynavn, status, varighet, påloggingstype, konto/side og tidsstempel. Den lagrer ikke forespørsler, verktøyargumenter, modelltokens, rå brukeragenter, råresultatrader eller fullstendige feilmeldingstekster.

Etter installasjon

Hva AI-assistenter kan gjøre med Hitsteps

Be om trafikkoversikter, kildefordelinger, toppsider, kampanjer, sanntidsbesøkende, sporingsstatus og ledelsesoppsummeringer fra oppdaterte Hitsteps-data.
Work with Hitsteps-native operations such as website setup, goals, Segments, uptime contacts and monitors, per-user alerts, Mentions query management, and authorized chat workflows.
Avgrens tilgangen med OAuth-scopes, kontorettigheter, abonnementsgrenser, bekreftelser og personverntilpassede resultater.
Se Hitsteps-funksjoner Hvorfor Hitsteps