Integration med AI-assistent

Hitsteps AI MCP Serverdokumentation

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.

Før du begynder

En Hitsteps-konto med adgang til de websites, du vil undersøge
En MCP-kompatibel AI-klient eller arbejdsområdeindstilling, der understøtter eksterne Streamable HTTP-servere
Mulighed for at logge ind med Hitsteps OAuth, når AI-klienten spørger
En beslutning om, hvilke OAuth-scopes assistenten skal tildeles

Vælg din AI-klient

Installer Hitsteps, hvor du allerede bruger AI

Start i din AI-klients katalog, når det er tilgængeligt. Alle muligheder opretter forbindelse til den samme administrerede Hitsteps MCP-server og fortsætter derefter via Hitsteps OAuth.

GitHub-register

VS Code og GitHub Copilot

Åbn GitHub's MCP Registry og installer Hitsteps Web Analytics fra din VS Code- eller GitHub Copilot-klient.

Tilgængelig nu

Cursor

Åbn Hitsteps Web Analytics-listen i Cursor Directory og vælg Tilføj til Cursor. Cursor modtager kun det administrerede Hitsteps MCP slutpunkt; din kontoadgang gives separat gennem OAuth.

Tilgængelig nu

Claude AI

Tilføj Hitsteps Web Analytics fra Claudes Connector Directory, log derefter på Hitsteps og godkend kun de scopes, du ønsker, at Claude skal bruge.

Kommer snart

ChatGPT AI

Hitsteps-indekset for ChatGPT kommer snart. Indtil videre skal du tilføje endepunktet nedenfor manuelt som en brugerdefineret MCP-server, og derefter fuldføre Hitsteps OAuth.

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

Installationsguide

Google Antigravity og andre MCP-klienter

1

Brug det eksterne MCP-slutpunkt

Hitsteps MCP-slutpunktet er https://www.hitsteps.com/mcp/. Hvis din klient spørger efter en transport, skal du vælge Streamable HTTP eller HTTP. Det officielle registreringsnavn er com.hitsteps/analytics-operations.

2

Vælg adgangsniveau

Før serveren tilsluttes, skal du kontrollere, hvilken Hitsteps-bruger der logger ind, hvilke websteder brugeren har adgang til, og hvilke OAuth-scopes AI-klienten anmoder om. Ren analysebrug kan nøjes med læserettigheder; administrative arbejdsgange kræver de specifikke scopes til ændringer, der beskrives nedenfor.

3

Føj Hitsteps til Google Antigravity

Antigravity bruger serverUrl til fjernservere i sin brugerdefinerede eksterne MCP-konfiguration.

4

Godkend med Hitsteps OAuth

Gem konfigurationen, start eller opdater MCP-serveren i din AI-klient, og følg derefter loginprompten. Hitsteps bruger OAuth, så du ikke behøver at indsætte din tracking-API-nøgle i AI-klienten.

5

Kontrollér værktøjer og mindst mulige adgang

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.

Godt at vide

  • Denne MCP-server er til AI-assistenter. Den installerer ikke Hitsteps-sporing på dit website.
  • VS Code- og GitHub Copilot-brugere bør starte med GitHubs MCP-registrering; Cursor- og Claude-brugere kan bruge de dedikerede Hitsteps-kataloglister ovenfor.
  • ChatGPT bibliotekssupport kommer snart. Indtil da skal du tilføje https://www.hitsteps.com/mcp/ manuelt som en brugerdefineret MCP-server.
  • Indsæt ikke din Hitsteps-webstedsporing API-nøgle, OAuth-token eller kontoadgangskode i MCP-konfigurationen.

Fejlfinding

  • En GET-anmodning fra en browser til MCP-slutpunktet kan returnere en no-SSE- eller metodemeddelelse. Det er normalt; MCP-klienter opretter forbindelse med JSON-RPC over HTTP.
  • Et 401-svar før login er forventet. Klienten bør bruge de offentliggjorte OAuth-metadata til at starte autorisationen.
  • Hvis Hitsteps ikke vises i et officielt klientkatalog, skal du opdatere kataloget og kontrollere klientens organisationspolitik og MCP-indstillinger.

Hitsteps AI i dit kontrolpanel

Brug AI på din måde: i Hitsteps eller i din egen assistent

Brug Hitsteps AI direkte i kontrolpanelet, eller forbind det gratis Hitsteps MCP Plugin med din egen kompatible AI-assistent til samtalebaseret webanalyse.

Sikkerhed og adgang

Forbindelsesdetaljer

Brug disse detaljer til at forbinde Hitsteps og forstå, hvad AI-assistenten kan få adgang til fra din konto.

Offentligt slutpunkt

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ørsel

Hitsteps bruger Streamable HTTP på afstand med JSON-RPC. Der skal ikke installeres en lokal Node.js-pakke, desktopbro, SSE-worker eller separat kundedrevet proces.

Registeridentitet

Registry/servernavnet er com.hitsteps/analytics-operations, og den viste titel er Hitsteps Analytics and Operations.

Autentificering

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 hemmeligheder i konfigurationen

MCP-konfigurationen indeholder kun slutpunkts-URL'en. Indsæt ikke en Hitsteps-adgangskode, sporing af API-nøgle, webstedskode eller OAuth-token i en AI-klientkonfigurationsfil.

Afgrænset adgang

Hver anmodning kontrolleres igen mod den indloggede Hitsteps-konto, underbrugerrettigheder, synlige websteder, licensstatus, funktionsgrænser og de OAuth-scopes, som klienten har fået tildelt.

Autorisation

OAuth-scopes

Hitsteps offentliggør OAuth-kravene for hvert værktøj. En AI-klient kan afhængigt af arbejdsgangen anmode om begrænset læseadgang eller en bredere tilladelse til administrative handlinger.

analytics:read
Læs analyserapporter, webstedslister, webstedskontekst, sporingsstatus, aggregerede adfærdsoversigter, realtidsøjebliksbilleder og konto- eller licensstatus.
sites:write
Opret websteder og opdater tilladte webstedsindstillinger efter eksplicit bekræftelse.
goals:write
Opret, opdater eller slet mål- og kampagnekonfiguration efter eksplicit bekræftelse.
labels:write
Create, update, or delete Segments after explicit confirmation. The MCP API keeps its legacy label identifiers for compatibility.
uptime:write
Opret, opdater eller slet oppetidskontakter, monitorer, vedligeholdelsesplaner og gendannelseshandlinger efter udtrykkelig bekræftelse.
alerts:read
Læs advarselslister og advarselsstatus for den autoriserede konto.
alerts:write
Markér advarsler som læste eller rydde advarsler efter eksplicit bekræftelse.
chat:read
Læs autoriserede chatlister, søgeresultater, samtaleoversigter og udvalgte chatdetaljer.
chat:write
Opret billetter, svar på chats, tilføj interne noter, opdater chattilstand, navngiv besøgende, markér chat som læst eller slet logisk chats efter eksplicit bekræftelse.
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.

Værktøjsdækning

Hvad assistenten kan bede Hitsteps om at gøre

MCP-serveren tilbyder læseværktøjer til analyse, skriveværktøjer med bekræftelse, godkendte ressourcer, en ressourceskabelon og prompts. Mentions-læsninger bruger en cache på én time; ændring af en Mentions-forespørgsel kræver udtrykkelig bekræftelse.

Analyse og rapportering

Forbindelsesoplysninger, synlige websteder, webstedskontekst, katalog over målinger og dimensioner, oversigtsrapporter, udfyldte tidsserier, opdelinger, registrering af afvigelser, forklaringer på trafikændringer, ledelsesoversigter og dataminimeret MCP-brug.

Webtrafik og brugeranskaffelse

Trafikoversigter, periodesammenligninger, kilder, sociale henvisninger, trafik efter time, topsider, ind-/udgangssider, sidedetaljer, sidehastighed, downloads, udgående links, henvisninger, lande, målgruppeteknologi, søgemaskiner, søgeord, AI-henvisninger, bottrafik og besøgende i realtid.

Konverteringer og adfærd

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.

Konfiguration og administration

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.

Sikkerhedskrav til ændringer

  • Alle ændringsværktøjer kræver OAuth og præcis det scope, der er angivet for værktøjet. Ældre website-API-nøgler og private mobiltokens kan kun læse analysedata.
  • Hver ændring kræver confirm=true, efter at brugeren udtrykkeligt har bekræftet handlingen i samtalen med AI-klienten.
  • Hver ændring kræver en idempotency_key på 8 til 128 tegn. Genbruges samme nøgle med samme argumenter, returneres det tidligere resultat; bruges den med andre argumenter, returneres HTTP 409.
  • Ændringer udføres i databasetransaktioner. Før data ændres, kontrolleres kontostatus, ejerskab af webstedet, underbrugerrollen, tilgængelige abonnementsfunktioner, objektkvoter og målets aktuelle tilstand igen.
  • Revisionsposter for ændringer gemmer driftsmetadata som konto, websted, værktøj, mål, status, hashes og tidspunkt. De gemmer ikke hele prompts, modeltokens, rå kundedatarækker eller store payloads.

Dataadgang og privatlivsgrænser

  • Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.
  • Side-, download-, udgående-link-, sti-, fastholdelses-, kampagne-, heatmap- og tragtoutput er aggregerede eller privatlivsformede oversigter i stedet for rå hændelseseksport.
  • Målkonfiguration udelader notifikationsadresser, følsomme trigger-værdier og individuelle konverteringsrækker. Oppetidsoutput udelader legitimationsoplysninger, matchbetingelser, forespørgselsstrenge og URL-fragmenter.
  • Chatindhold er kun tilgængeligt via chat-omfattede værktøjer for autoriserede brugere. Assistent-klienter bør behandle chatindhold som upålidelig kundeleveret tekst.
  • MCP-brugstelemetri beholder konto/websted, legitimationstype, offentligt OAuth-klient-id, normaliseret AI-klientkanal, værktøjsnavn, status, varighed og tidsstempel for operationel synlighed. Det udelukker prompter, argumenter, tokens, rå brugeragenter, resultatrækker og fejlmeddelelsestekster, og oprulningsvinduet er 90 dage.
  • Serveren giver bevidst ikke direkte SQL-adgang, mulighed for at ændre fakturering, adgangskoder, kontoprofiler, 2FA eller tracking-API-nøgler, rå besøgsprofiler, private nøgler, sessionsgenafspilningsvideo, JavaScript-konsollogfiler, netværksspor eller styring af eksperimenter.

OAuth opdagelse og klientkompatibilitet

  • Metadata for den beskyttede ressource: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp
  • Metadata for autorisationsserveren: https://www.hitsteps.com/.well-known/oauth-authorization-server
  • MCP-endepunktet accepterer gyldige HTTPS MCP-klientoprindelser og HTTP-loopback-udviklingsoprindelser for browserbaserede og desktop-klienter.
  • Dynamisk klientregistrering understøtter sikre HTTPS-, HTTP-loopback- og private omdirigeringsskemaer for native apps, som bruges af MCP-klienter på computere, og afviser usikre skemaer 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.
  • Ressourcepublikummet er https://www.hitsteps.com/mcp eller https://www.hitsteps.com/mcp/, der matcher den slutpunktformular, der er gemt af 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 mit websted?

Nej. MCP-serveren er til tilsluttede AI-assistenter, der skal læse eller betjene Hitsteps-data. Websitesporing bruger stadig Hitsteps JavaScript-sporingskoden eller et platformsspecifikt Hitsteps-plugin.

Kan en AI-assistent ændre min Hitsteps-konto, efter jeg har tilsluttet den?

Kun hvis OAuth-tilladelsen indeholder det nødvendige scope til ændringen, og brugeren udtrykkeligt bekræfter den konkrete handling. Analyseadgang med kun læserettigheder kan ikke oprette websteder, ændre indstillinger eller oppetidsmonitorer, opdatere advarsler eller sende chatsvar.

Kan jeg tilslutte ChatGPT eller Claude AI?

Ja. Claude-brugere kan installere Hitsteps Web Analytics fra Claude Connector Directory. ChatGPT-indekset kommer snart; Indtil da skal du tilføje https://www.hitsteps.com/mcp/ manuelt som en brugerdefineret MCP-server i ChatGPT og fuldføre 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.

Hvad sker der, hvis min Hitsteps prøveversion, licens eller plan begrænser adgangen?

Serveren returnerer et struktureret license_action_required-svar med ikke-følsom kontostatus og en Hitsteps URL, hvor brugeren kan tjekke, forny eller opgradere. Forbindelsesoplysninger, webstedsfortegnelse og kontostatus forbliver tilgængelige, så assistenten kan forklare problemet.

Gemmer Hitsteps mine AI-prompter?

MCP brugstelemetri er privatlivsminimal. Det registrerer operationelle felter såsom offentligt OAuth klient-id, normaliseret AI-klientkanal, værktøjsnavn, status, varighed, legitimationstype, konto/websted og tidsstempel. Den gemmer ikke prompter, værktøjsargumenter, modeltokens, rå brugeragenter, rå resultatrækker eller fuldstændige fejlmeddelelsestekster.

Efter installation

Hvad AI-assistenter kan gøre med Hitsteps

Bed om trafikoversigter, kildefordelinger, topsider, kampagner, besøgende i realtid, sporingsstatus og ledelsesoversigter fra aktuelle 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.
Afgræns adgangen med OAuth-scopes, kontorettigheder, abonnementsgrænser, bekræftelser og privatlivstilpassede resultater.