Registrul GitHub
VS Code și GitHub Copilot
Deschide registrul MCP GitHub și instalează Hitsteps Web Analytics din clientul VS Code sau GitHub Copilot.
Integrare asistent AI
Documentația serverului MCP AI Hitsteps
Hitsteps oferă un server la distanță Model Context Protocol pentru asistenții AI conectați. Folosește-l pentru a întreba despre analize, vizitatori live, site-uri, obiective, disponibilitate, alerte, Mentions și activitatea autorizată din conversații a contului Hitsteps, păstrând accesul limitat prin scopuri OAuth, permisiuni de cont, verificări de licență și rezultate modelate pentru confidențialitate.
MCP la distanță cu OAuth Before you start
Un cont Hitsteps cu acces la site-urile pe care vrei să le verifici
Un client AI compatibil cu MCP sau o setare de spațiu de lucru care acceptă servere Streamable HTTP la distanță
Posibilitatea de a te conecta cu OAuth Hitsteps când clientul AI solicită acest lucru
O decizie privind scopurile OAuth pe care trebuie să le primească asistentul
Alege clientul AI
Instalează Hitsteps acolo unde folosești deja AI
Începe cu directorul clientului când este disponibil. Fiecare opțiune se conectează la același server MCP Hitsteps gestionat și continuă prin OAuth Hitsteps.
Disponibil acum
Cursor
Deschide listarea Hitsteps Web Analytics în Cursor Directory și alege Add to Cursor. Cursor primește doar punctul final MCP Hitsteps gestionat; accesul la cont se acordă separat prin OAuth.
Disponibil acum
Claude AI
Adaugă Hitsteps Web Analytics din Claude Connector Directory, apoi conectează-te la Hitsteps și aprobă doar scopurile pe care vrei să le folosească Claude.
În curând
ChatGPT AI
Listarea Hitsteps în directorul ChatGPT va fi disponibilă în curând. Deocamdată, adaugă manual punctul final de mai jos ca server MCP personalizat, apoi finalizează OAuth Hitsteps.
https://www.hitsteps.com/mcp/
Install guide
Google Antigravity și alți clienți MCP
1
Folosește punctul final MCP la distanță
Punctul final MCP Hitsteps este https://www.hitsteps.com/mcp/. Dacă clientul îți cere un transport, alege Streamable HTTP sau HTTP. Numele oficial din registru este com.hitsteps/analytics-operations.
2
Alege nivelul de acces
Înainte de a conecta serverul, confirmă ce utilizator Hitsteps se va conecta, la ce site-uri are acces și ce scopuri OAuth solicită clientul AI. Utilizarea doar pentru analize poate rămâne doar pentru citire; fluxurile operaționale au nevoie de scopurile de scriere specifice descrise mai jos.
3
Adaugă Hitsteps în Google Antigravity
Configurația MCP la distanță personalizată pentru Antigravity folosește serverUrl pentru serverele la distanță.
4
Autentifică-te cu OAuth Hitsteps
Salvează configurația, pornește sau reîmprospătează serverul MCP în clientul AI, apoi urmează solicitarea de conectare. Hitsteps folosește OAuth, astfel încât nu trebuie să lipești cheia API de urmărire în clientul AI.
5
Verifică instrumentele și privilegiul minim
După conectare, întrebați asistentul ce instrumente și domenii Hitsteps poate accesa. Instrumentele de analiză doar în citire pot răspunde la rapoarte; instrumentele de administrare, precum obiectivele, Segmentele, disponibilitatea, alertele, Mentions și acțiunile de chat, necesită domenii OAuth corespunzătoare, permisiuni de cont și confirmare explicită.
Good to know
- Acest server MCP este destinat asistenților AI. Nu instalează urmărirea Hitsteps pe site-ul tău.
- Utilizatorii VS Code și GitHub Copilot ar trebui să înceapă cu registrul MCP GitHub; utilizatorii Cursor și Claude pot folosi listările Hitsteps dedicate de mai sus.
- Suportul pentru directorul ChatGPT va fi disponibil în curând. Până atunci, adaugă manual https://www.hitsteps.com/mcp/ ca server MCP personalizat.
- Nu lipi cheia API de urmărire a site-ului Hitsteps, tokenul OAuth sau parola contului în configurația MCP.
Depanare
- O solicitare GET dintr-un program de navigare către endpointul MCP poate returna un mesaj care indică lipsa SSE sau metoda. Este normal; clienții MCP se conectează folosind JSON-RPC peste HTTP.
- Un răspuns 401 înainte de conectare este așteptat. Clientul trebuie să folosească metadatele OAuth anunțate pentru a începe autorizarea.
- Dacă un director oficial de clienți nu afișează Hitsteps, reîmprospătează directorul și verifică politica organizației și setările MCP ale clientului.
Hitsteps AI în tabloul tău de bord
Folosește AI în modul tău: în Hitsteps sau în propriul asistent
Folosește Hitsteps AI în tabloul de bord sau conectează pluginul MCP gratuit Hitsteps la propriul asistent AI compatibil pentru analiză web conversațională.
Securitate și acces
Detalii despre conexiune
Folosește aceste detalii pentru a conecta Hitsteps și pentru a înțelege ce poate accesa asistentul AI din contul tău.
Punct final public
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.
Transport
Hitsteps folosește Streamable HTTP la distanță cu JSON-RPC. Nu există niciun pachet Node.js local, componentă de legătură pentru desktop, proces SSE sau proces separat găzduit de client care să trebuiască instalat.
Identitatea din registru
Numele serverului din registru este com.hitsteps/analytics-operations, iar titlul afișat este Hitsteps Analytics and Operations.
Autentificare
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.
Fără secrete comune în configurație
Configurația MCP conține doar adresa URL a punctului final. Nu lipi o parolă Hitsteps, o cheie API de urmărire, codul site-ului sau un token OAuth într-un fișier de configurare al clientului AI.
Acces limitat
Fiecare cerere este verificată din nou în raport cu contul Hitsteps conectat, permisiunile subutilizatorului, site-urile vizibile, starea licenței, limitele funcțiilor și scopurile OAuth acordate clientului.
Autorizare
Scopuri OAuth
Hitsteps publică declarații OAuth pentru fiecare instrument. Un client AI poate solicita un acord restrâns, doar pentru citire, sau un acord operațional mai larg, în funcție de fluxul dorit.
analytics:readCitește rapoarte de analiză, liste de site-uri, contextul site-ului, starea urmăririi, rezumate agregate ale comportamentului, instantanee în timp real și starea contului/licenței.
sites:writeCreează site-uri și actualizează setările permise ale site-ului după confirmarea explicită.
goals:writeCreează, actualizează sau șterge configurația obiectivelor și campaniilor după confirmarea explicită.
labels:writeCreate, update, or delete Segments after explicit confirmation. The MCP API keeps its legacy label identifiers for compatibility.
uptime:writeCreează, actualizează sau șterge contacte de disponibilitate, monitoare, programe de mentenanță și acțiuni de recuperare după confirmarea explicită.
alerts:readCitește listele de alerte și starea alertelor pentru contul autorizat.
alerts:writeMarchează alertele ca citite sau elimină alertele după confirmarea explicită.
chat:readCitește listele autorizate de conversații, rezultatele căutării, rezumatele conversațiilor și detaliile selectate ale conversațiilor.
chat:writeCreează tichete, răspunde la conversații, adaugă note interne, actualizează starea conversațiilor, denumește vizitatori, marchează conversațiile ca citite sau șterge logic conversațiile după confirmarea explicită.
mentions:readCitește interogările Mentions active și rezultatele combinate Web Search/X.
mentions:writeAdaugă, redenumește sau elimină interogările active de cuvinte-cheie Mentions după confirmarea explicită.
Acoperirea instrumentelor
Ce îi poate cere asistentul lui Hitsteps să facă
Serverul MCP oferă instrumente de citire analitică, instrumente de scriere cu confirmare, resurse autentificate, un șablon de resursă și prompturi. Citirile Mentions folosesc un cache de o oră; modificarea unei interogări Mentions necesită confirmare explicită.
Descoperire și raportare
Informații despre conexiune, site-uri vizibile, contextul site-ului, catalogul valorilor și dimensiunilor, rapoarte generale, serii temporale completate pentru intervale lipsă, defalcări, detectarea anomaliilor, explicații ale schimbărilor traficului, rezumate executive și utilizare MCP cu date minime de confidențialitate.
Trafic și achiziție
Rezumatul traficului, comparații între perioade, surse, recomandări din rețele sociale, trafic pe ore, pagini de top, pagini de intrare/ieșire, detalii ale paginii, viteza paginii, descărcări, linkuri externe, referenți, țări, tehnologia publicului, motoare de căutare, cuvinte-cheie, recomandări AI, trafic de roboți și vizitatori în timp real.
Conversii și comportament
Obiective, conversii ale obiectivelor, campanii, performanța Pâlniilor, evenimente de interacțiune, trasee agregate, retenție, Segmente, rezumate ale hărților termice, analize video urmărite, rezumate de chat, starea și istoricul disponibilității și starea urmăririi.
Configurare și operațiuni
Configurarea site-ului, setările permise ale site-ului, configurarea obiectivelor și campaniilor, configurarea Segmentelor, contacte și monitoare de disponibilitate, programe de mentenanță, acțiuni de recuperare, operațiuni de alertă, configurarea interogărilor Mentions și fluxuri de chat autorizate.
Protecții pentru acțiunile de scriere
- Toate instrumentele de scriere necesită OAuth și scopul exact declarat pentru instrument. Cheile API legacy ale site-ului și tokenurile mobile private pot folosi doar citiri de analiză.
- Orice modificare necesită confirm=true după ce utilizatorul confirmă explicit acțiunea în conversația din clientul AI.
- Orice modificare necesită un idempotency_key de 8-128 de caractere. Reutilizarea aceleiași chei cu aceleași argumente returnează rezultatul anterior; reutilizarea ei cu argumente diferite returnează HTTP 409.
- Operațiunile de scriere rulează în tranzacții de bază de date și verifică din nou starea contului, proprietatea site-ului, rolul subutilizatorului, disponibilitatea funcțiilor planului, cotele obiectelor și starea curentă a țintei înainte de a modifica datele.
- Înregistrările de audit ale scrierilor păstrează metadate operaționale precum contul, site-ul, instrumentul, ținta, starea, hashurile și ora. Nu păstrează prompturi complete, tokenuri de model, rânduri brute despre clienți sau payloaduri mari.
Acces la date și limite de confidențialitate
- Datele despre vizitatori în timp real omit adresele IP brute, ID-urile vizitatorilor, potrivirile de Segment, cuvintele-cheie, șirurile de interogare URL și fragmentele.
- Rezultatele pentru pagini, descărcări, linkuri externe, trasee, retenție, campanii, hărți de căldură și pâlnii sunt rezumate agregate sau modelate pentru confidențialitate, nu exporturi de evenimente brute.
- Configurația obiectivelor omite adresele de notificare, valorile sensibile ale regulilor și rândurile individuale de conversie. Rezultatele disponibilității omit acreditările, condițiile de potrivire, șirurile de interogare și fragmentele.
- Conținutul conversațiilor este disponibil numai prin instrumente cu scop chat pentru utilizatorii autorizați. Clienții asistenți trebuie să trateze conținutul conversațiilor ca text neverificat furnizat de clienți.
- Telemetria utilizării MCP păstrează contul/site-ul, tipul acreditării, ID-ul public al clientului OAuth, canalul normalizat al clientului AI, numele instrumentului, starea, durata și marca temporală pentru vizibilitate operațională. Exclude prompturi, argumente, tokenuri, agenți de utilizator bruti, rânduri de rezultate și corpurile mesajelor de eroare, iar fereastra de agregare este de 90 de zile.
- Serverul nu expune intenționat acces SQL brut, modificări de facturare sau parole, modificări ale profilului contului, modificări 2FA, exporturi brute ale profilurilor vizitatorilor, chei private, modificarea cheii API de urmărire, videoclipuri de redare a sesiunilor, jurnale ale consolei JavaScript, trasee de rețea sau administrarea experimentelor.
Descoperire OAuth și compatibilitatea clientului
- Metadate ale resursei protejate: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp
- Metadate ale serverului de autorizare: https://www.hitsteps.com/.well-known/oauth-authorization-server
- Punctul final MCP acceptă origini HTTPS valide ale clienților MCP și origini HTTP loopback de dezvoltare pentru clienți care folosesc programe de navigare și aplicații desktop.
- Înregistrarea dinamică a clienților acceptă scheme sigure HTTPS, HTTP loopback și scheme private de redirecționare ale aplicațiilor native folosite de clienții MCP pentru desktop, respingând scheme nesigure precum javascript:, data:, file:, blob: și 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.
- Audiența resursei este https://www.hitsteps.com/mcp sau https://www.hitsteps.com/mcp/, în acord cu forma punctului final salvată de clientul AI.
FAQ
Questions about connecting Hitsteps to AI
Review the access, tracking, and privacy answers before you connect an AI assistant.
De ce numele instrumentelor MCP spun încă 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.
Acesta este codul de urmărire pentru site-ul meu?
Nu. Serverul MCP este destinat asistenților AI conectați care trebuie să citească sau să opereze asupra datelor Hitsteps. Urmărirea site-ului folosește în continuare codul JavaScript de urmărire Hitsteps sau o extensie Hitsteps specifică platformei.
Poate un asistent AI să îmi schimbe contul Hitsteps după conectare?
Doar dacă acordul OAuth include scopul de scriere necesar și utilizatorul confirmă explicit acțiunea concretă. Acordurile de analiză doar pentru citire nu pot crea site-uri, schimba setări, edita monitoare de disponibilitate, actualiza alerte sau trimite răspunsuri în conversații.
Pot conecta ChatGPT sau Claude AI?
Da. Utilizatorii Claude pot instala Hitsteps Web Analytics din Claude Connector Directory. Listarea în directorul ChatGPT va fi disponibilă în curând; până atunci, adaugă manual https://www.hitsteps.com/mcp/ ca server MCP personalizat în ChatGPT și finalizează OAuth Hitsteps.
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.
Ce se întâmplă dacă perioada de test, licența sau limita planului Hitsteps blochează accesul?
Serverul returnează un răspuns structurat license_action_required cu starea nesensibilă a contului și un URL Hitsteps unde utilizatorul poate verifica, reînnoi sau trece la un plan superior. Informațiile despre conexiune, lista site-urilor și starea contului rămân disponibile pentru ca asistentul să poată explica problema.
Păstrează Hitsteps prompturile mele AI?
Telemetria utilizării MCP folosește date minime de confidențialitate. Înregistrează câmpuri operaționale precum ID-ul public al clientului OAuth, canalul normalizat al clientului AI, numele instrumentului, starea, durata, tipul acreditării, contul/site-ul și marca temporală. Nu stochează prompturi, argumente ale instrumentelor, tokenuri de model, agenți de utilizator bruti, rânduri brute de rezultate sau corpurile complete ale mesajelor de eroare.
After install
Ce pot face asistenții AI cu Hitsteps
Cere prezentări ale traficului, defalcări ale surselor, pagini de top, campanii, vizitatori în timp real, starea urmăririi și rezumate executive din datele Hitsteps actuale.
Lucrați cu operațiuni native Hitsteps precum configurarea site-ului, obiective, Segmente, contacte și monitoare de disponibilitate, alerte per utilizator, gestionarea interogărilor Mentions și fluxuri de chat autorizate.
Păstrează accesul limitat prin scopuri OAuth, permisiuni de cont, limitele planului, solicitări de confirmare și rezultate concepute cu respectarea confidențialității.