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.

Je toto měřicí kód pro můj web?

Ne. Server MCP je pro připojené asistenty AI, kteří potřebují číst data Hitsteps nebo s nimi pracovat. Sledování webových stránek stále používá měřicí kód JavaScript Hitsteps nebo plugin Hitsteps specifický pro platformu.

Může asistent AI změnit můj účet Hitsteps poté, co jej připojím?

Pouze pokud oprávnění OAuth zahrnuje potřebný rozsah zápisu a uživatel konkrétní operaci výslovně potvrdí. Analytický přístup jen pro čtení nemůže vytvářet weby, měnit nastavení, upravovat monitory dostupnosti, aktualizovat upozornění ani odesílat odpovědi v chatu.

Mohu připojit ChatGPT nebo Claude AI?

Ano. Uživatelé Claude mohou nainstalovat Hitsteps Web Analytics z adresáře konektoru Claude. Výpis adresáře ChatGPT bude brzy k dispozici; do té doby přidejte https://www.hitsteps.com/mcp/ ručně jako vlastní server MCP v ChatGPT a dokončete 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.

Co se stane, když můj limit zkušební verze, licence nebo plánu Hitsteps zablokuje přístup?

Server vrátí strukturovanou odpověď license_action_required s necitlivým stavem účtu a URL Hitsteps, kde může uživatel zkontrolovat, obnovit nebo upgradovat. Informace o připojení, výpis webu a stav účtu zůstávají k dispozici, takže asistent může problém vysvětlit.

Ukládá Hitsteps mé AI prompty?

Telemetrie využití MCP je záměrně omezena na minimum. Zaznamenává provozní pole, jako je veřejné ID klienta OAuth, normalizovaný kanál AI klienta, název nástroje, stav, doba trvání, typ přihlašovacích údajů, účet či web a časové razítko. Neukládá prompty, argumenty nástrojů, tokeny modelu, surové user-agenty, řádky výsledků ani úplné texty chybových zpráv.

Hitsteps AI MCP server pro analytické asistenty

Dokumentace serveru Hitsteps AI MCP

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.

Než začnete

Účet Hitsteps s přístupem k webům, které chcete zkoumat

Nastavení klienta nebo pracovního prostoru AI kompatibilní s MCP, které podporuje vzdálené servery Streamable HTTP

Možnost přihlásit se pomocí Hitsteps OAuth, když se klient AI zeptá

Rozhodnutí o tom, které rozsahy OAuth by měl asistent obdržet

Použít vzdálený koncový bod MCP

Koncový bod Hitsteps MCP je https://www.hitsteps.com/mcp/. Pokud se klient zeptá na přenos, zvolte Streamable HTTP nebo HTTP. Oficiální název v registru je com.hitsteps/analytics-operations.

Vyberte úroveň přístupu

Před připojením serveru potvrďte, který uživatel Hitsteps se přihlásí, ke kterým webům má tento uživatel přístup a které rozsahy OAuth požaduje klient AI. Použití pouze pro službu Analytics může zůstat pouze pro čtení; provozní pracovní postupy vyžadují specifické rozsahy zápisu popsané níže.

Přidat Hitsteps do Google Antigravity

Vlastní vzdálená konfigurace MCP v Antigravity používá pro vzdálené servery serverUrl.

{
  "mcpServers": {
    "Hitsteps": {
      "serverUrl": "https://www.hitsteps.com/mcp/"
    }
  }
}

Ověřit se pomocí Hitsteps OAuth

Uložte konfiguraci, spusťte nebo obnovte MCP server v klientovi AI a poté postupujte podle výzvy k přihlášení. Hitsteps používá OAuth, takže do klienta AI nemusíte vkládat sledovací klíč API.

Ověřte nástroje a nejmenší oprávnění

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.

Co je dobré vědět

Tento MCP server je určen pro asistenty AI. Neinstaluje sledování Hitsteps na váš web.

Uživatelé VS Code a GitHub Copilot by měli začít s registrem MCP GitHubu; Uživatelé Cursor a Claude mohou používat vyhrazené seznamy adresářů Hitsteps výše.

Brzy bude k dispozici podpora adresářů ChatGPT. Do té doby přidejte https://www.hitsteps.com/mcp/ ručně jako vlastní server MCP.

Do konfigurace MCP nevkládejte svůj klíč API pro sledování webu Hitsteps, token OAuth nebo heslo účtu.

Řešení problémů

Požadavek GET z prohlížeče na koncový bod MCP může vrátit zprávu no-SSE nebo zprávu o metodě. To je normální; klienti MCP se připojují pomocí JSON-RPC přes HTTP.

Odpověď 401 před přihlášením je očekávaná. Klient by měl k zahájení autorizace použít zveřejněná metadata OAuth.

Pokud se Hitsteps nezobrazuje v oficiálním adresáři klienta, obnovte adresář a zkontrolujte zásady organizace a nastavení MCP klienta.

Ochranná opatření pro operace zápisu

Všechny nástroje provádějící změny vyžadují OAuth a přesný rozsah určený danému nástroji. Starší klíče API webu a soukromé mobilní tokeny mohou analytická data pouze číst.

Každá operace měnící data vyžaduje confirm=true poté, co uživatel akci výslovně potvrdí v konverzaci s klientem AI.

Každá operace měnící data vyžaduje idempotency_key o délce 8–128 znaků. Opětovné použití stejného klíče se stejnými argumenty vrátí předchozí výsledek; s jinými argumenty vrátí HTTP 409.

Změny probíhají v databázových transakcích a před úpravou dat se znovu ověří stav účtu, vlastnictví webu, role poduživatele, dostupnost funkcí plánu, limity objektů a aktuální stav cíle.

Záznamy auditu zápisů ukládají provozní metadata, například účet, web, nástroj, cíl, stav, hashe a čas. Neukládají úplné prompty, tokeny modelu, surové řádky zákaznických dat ani velké datové payloady.

Hranice přístupu k datům a soukromí

Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.

Výstupy pro stránky, stahování, odchozí odkazy, cesty, retenci, kampaně, teplotní mapy a trychtýře jsou agregované nebo upravené s ohledem na soukromí, nikoli exporty surových událostí.

Konfigurace cíle vynechává adresy oznámení, citlivé hodnoty spouštěčů a jednotlivé konverze. Výstup monitoringu dostupnosti vynechává přihlašovací údaje, podmínky shody, řetězce dotazu a fragmenty URL.

Obsah chatu je dostupný pouze prostřednictvím nástrojů s rozsahem chatu pro autorizované uživatele. Klienti asistenta by měli s obsahem chatu zacházet jako s nedůvěryhodným textem dodaným zákazníkem.

Telemetrie využití MCP uchovává pro provozní přehled účet či web, typ přihlašovacích údajů, veřejné ID klienta OAuth, normalizovaný kanál AI klienta, název nástroje, stav, dobu trvání a časové razítko. Neobsahuje prompty, argumenty, tokeny, surové user-agenty, řádky výsledků ani texty chybových zpráv; souhrnné období je 90 dnů.

Server záměrně neposkytuje přímý přístup k SQL, změny fakturace, hesla, profilu účtu ani 2FA, surové výpisy profilů návštěvníků, soukromé klíče, změnu měřicího API klíče, video záznamů relací, protokoly konzole JavaScript, síťové trasování ani správu experimentů.

Načtení metadat OAuth a kompatibilita klientů

Metadata chráněného zdroje: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp

Metadata autorizačního serveru: https://www.hitsteps.com/.well-known/oauth-authorization-server

Koncový bod MCP přijímá platné origins klientů MCP přes HTTPS a místní vývojové origins HTTP loopback pro prohlížečové a desktopové klienty.

Dynamická registrace klienta podporuje bezpečná přesměrování HTTPS, HTTP loopback a privátní schémata přesměrování nativních aplikací používaná desktopovými klienty MCP; odmítá nebezpečná schémata jako javascript:, data:, file:, blob: a 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.

Hodnota audience prostředku je https://www.hitsteps.com/mcp nebo https://www.hitsteps.com/mcp/ a odpovídá variantě koncového bodu uložené klientem AI.

Dokumentace serveru Hitsteps AI MCP

Než začnete

Nainstalujte Hitsteps tam, kde již používáte AI

VS Code a GitHub Copilot

Cursor

Claude AI

ChatGPT AI

Google Antigravity a další klienti MCP

Použít vzdálený koncový bod MCP

Vyberte úroveň přístupu

Přidat Hitsteps do Google Antigravity

Ověřit se pomocí Hitsteps OAuth

Ověřte nástroje a nejmenší oprávnění

Co je dobré vědět

Řešení problémů

Používejte AI po svém: v Hitsteps nebo ve vlastním asistentovi

Podrobnosti připojení

Veřejný koncový bod

Způsob přenosu

Identita registru

Autentizace

V konfiguraci nejsou sdílené tajné údaje

Omezený přístup

Rozsahy OAuth

O co může asistent požádat Hitsteps

Vyhledávání dat a přehledy

Návštěvnost a akvizice

Konverze a chování

Konfigurace a operace

Ochranná opatření pro operace zápisu

Hranice přístupu k datům a soukromí

Načtení metadat OAuth a kompatibilita klientů

Questions about connecting Hitsteps to AI

Co mohou asistenti AI dělat s Hitsteps