Registro di sistema GitHub
VS Code e GitHub Copilot
Apri il registro MCP di GitHub e installa Hitsteps Web Analytics dal tuo client VS Code o GitHub Copilot.
Integrazione con assistenti AI
Documentazione del server 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.
MCP remoto con OAuth Prima di iniziare
Un account Hitsteps con accesso ai siti web che vuoi analizzare
Un client AI o un'impostazione dell'area di lavoro compatibile con MCP che supporta server Streamable HTTP remoti
Possibilità di accedere con Hitsteps OAuth quando richiesto dal client AI
La scelta degli ambiti OAuth da concedere all’assistente
Scegli il tuo client IA
Installa Hitsteps dove usi già l'intelligenza artificiale
Inizia con la directory del tuo cliente quando ne è disponibile una. Ogni opzione si connette allo stesso server Hitsteps MCP gestito e continua attraverso Hitsteps OAuth.
Disponibile ora
Cursor
Apri l'elenco Hitsteps Web Analytics nella directory Cursor e scegli Aggiungi a Cursor. Cursor riceve solo l'endpoint Hitsteps MCP gestito; l'accesso al tuo account viene concesso separatamente tramite OAuth.
Disponibile ora
Claude AI
Aggiungi Hitsteps Web Analytics dalla directory dei connettori di Claude, quindi accedi a Hitsteps e approva solo gli ambiti che desideri che Claude utilizzi.
Prossimamente
ChatGPT AI
L'elenco delle directory Hitsteps per ChatGPT sarà presto disponibile. Per ora, aggiungi manualmente l'endpoint riportato di seguito come server MCP personalizzato, quindi completa Hitsteps OAuth.
https://www.hitsteps.com/mcp/
Guida all'installazione
Google Antigravity e altri client MCP
1
Usa l'endpoint MCP remoto
L'endpoint Hitsteps MCP è https://www.hitsteps.com/mcp/. Se il client richiede un trasporto, scegli Streamable HTTP o HTTP. Il nome ufficiale nel registro è com.hitsteps/analytics-operations.
2
Scegli il livello di accesso
Prima di connettere il server, verificare quale utente Hitsteps accederà, a quali siti Web può accedere l'utente e quali ambiti OAuth richiede il client AI. L'utilizzo di sola analisi può rimanere di sola lettura; i flussi di lavoro operativi necessitano degli ambiti di scrittura specifici descritti di seguito.
3
Aggiungi Hitsteps a Google Antigravity
La configurazione MCP remota personalizzata di Antigravity usa serverUrl per i server remoti.
4
Autenticati con Hitsteps OAuth
Salva la configurazione, avvia o aggiorna il server MCP nel client AI, quindi segui la richiesta di accesso. Hitsteps usa OAuth, quindi non devi incollare la chiave API di tracciamento nel client AI.
5
Verifica gli strumenti e il principio del privilegio minimo
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.
Buono a sapersi
- Questo server MCP è destinato agli assistenti AI. Non installa il tracciamento Hitsteps sul tuo sito web.
- Gli utenti VS Code e GitHub Copilot dovrebbero iniziare con il registro MCP di GitHub; Gli utenti Cursor e Claude possono utilizzare gli elenchi di directory Hitsteps dedicati sopra.
- Il supporto per la directory ChatGPT sarà presto disponibile. Fino ad allora, aggiungi https://www.hitsteps.com/mcp/ manualmente come server MCP personalizzato.
- Non incollare la chiave API di monitoraggio del sito Web Hitsteps, il token OAuth o la password dell'account nella configurazione MCP.
Risoluzione dei problemi
- Una richiesta GET del browser all'endpoint MCP può restituire un messaggio di assenza di SSE o relativo al metodo. È normale: i client MCP si connettono con JSON-RPC tramite HTTP.
- Una risposta 401 prima dell'accesso è prevista. Il client deve usare i metadati OAuth pubblicati per avviare l'autorizzazione.
- Se non viene visualizzata una directory ufficiale del cliente Hitsteps, aggiorna la directory e controlla la politica dell'organizzazione del cliente e le impostazioni MCP.
Hitsteps AI nella tua dashboard
Usa l’AI come preferisci: dentro Hitsteps o nel tuo assistente
Usa Hitsteps AI direttamente nella dashboard oppure collega il Hitsteps MCP Plugin gratuito al tuo assistente AI compatibile per l’analisi web conversazionale.
Sicurezza e accesso
Dettagli di connessione
Utilizza questi dettagli per connettere Hitsteps e capire a cosa può accedere l'assistente AI dal tuo account.
Endpoint pubblico
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.
Trasporto
Hitsteps utilizza Streamable HTTP remoto con JSON-RPC. Non è necessario installare alcun pacchetto Node.js locale, bridge desktop, lavoratore SSE o processo separato ospitato dal cliente.
Identità del registro
Il nome del registro/server è com.hitsteps/analytics-operations e il titolo visualizzato è Hitsteps Analytics and Operations.
Autenticazione
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.
Nessun segreto condiviso nella configurazione
La configurazione MCP contiene solo l'URL dell'endpoint. Non incollare una password Hitsteps, una chiave di tracciamento API, un codice sito Web o un token OAuth in un file di configurazione del client AI.
Accesso circoscritto
Ogni richiesta viene ricontrollata rispetto all'account Hitsteps a cui è stato effettuato l'accesso, alle autorizzazioni del subutente, ai siti Web visibili, allo stato della licenza, ai limiti delle funzionalità e agli ambiti OAuth concessi a quel client.
Autorizzazione
Ambiti OAuth
Hitsteps pubblica i requisiti OAuth per ogni strumento. In base al flusso desiderato, un client AI può richiedere un’autorizzazione limitata di sola lettura o un’autorizzazione operativa più ampia.
analytics:readLeggi report di analisi, elenchi di siti, contesto del sito, monitoraggio dello stato, riepiloghi comportamentali aggregati, istantanee in tempo reale e stato dell'account/licenza.
sites:writeCrea siti Web e aggiorna le impostazioni dei siti Web consentiti dopo la conferma esplicita.
goals:writeCrea, aggiorna o elimina la configurazione dell'obiettivo e della campagna dopo la conferma esplicita.
labels:writeCreate, update, or delete Segments after explicit confirmation. The MCP API keeps its legacy label identifiers for compatibility.
uptime:writeCrea, aggiorna o elimina contatti di uptime, monitoraggi, programmi di manutenzione e azioni di ripristino dopo la conferma esplicita.
alerts:readLeggere gli elenchi degli avvisi e lo stato degli avvisi per l'account autorizzato.
alerts:writeContrassegna gli avvisi come letti o cancella gli avvisi dopo la conferma esplicita.
chat:readLeggi elenchi di chat autorizzati, risultati di ricerca, riepiloghi di conversazioni e dettagli di chat selezionati.
chat:writeCrea ticket, rispondi alle chat, aggiungi note interne, aggiorna lo stato della chat, nomina i visitatori, contrassegna le chat come lette o elimina logicamente le chat dopo la conferma esplicita.
mentions:readRead active Mentions queries and combined Web Search/X results.
mentions:writeAdd, rename, or remove active Mentions keyword queries after explicit confirmation.
Copertura degli strumenti
Cosa può chiedere l'assistente a Hitsteps
Il server MCP offre strumenti di lettura analitica, strumenti di scrittura con conferma, risorse autenticate, un modello di risorsa e prompt. Le letture di Mentions utilizzano una cache di un’ora; modificare una query Mentions richiede una conferma esplicita.
Scoperta e reporting
Informazioni sulla connessione, siti visibili, contesto del sito, catalogo di metriche e dimensioni, report generali, serie temporali completate, suddivisioni, rilevamento delle anomalie, spiegazioni delle variazioni di traffico, sintesi direzionali e utilizzo MCP con raccolta dati minima.
Traffico e acquisizione
Riepiloghi del traffico, confronti di periodi, fonti, referral social, traffico per ora, pagine principali, pagine di entrata/uscita, dettagli della pagina, velocità della pagina, download, link in uscita, referrer, paesi, tecnologia del pubblico, motori di ricerca, parole chiave, referral AI, traffico bot e visitatori in tempo reale.
Conversioni e comportamenti
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.
Configurazione e operazioni
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.
Protezioni per le azioni di modifica
- Tutti gli strumenti di modifica richiedono OAuth e l’ambito esatto dichiarato per lo strumento. Le chiavi API precedenti dei siti e i token mobili privati possono soltanto leggere i dati analitici.
- Ogni modifica richiede confirm=true dopo che l’utente ha confermato esplicitamente l’azione nella conversazione con il client AI.
- Ogni modifica richiede una idempotency_key da 8 a 128 caratteri. Riutilizzare la stessa chiave con gli stessi argomenti restituisce il risultato precedente; riutilizzarla con argomenti diversi restituisce HTTP 409.
- Le modifiche vengono eseguite in transazioni di database. Prima di cambiare i dati vengono ricontrollati lo stato dell’account, la proprietà del sito, il ruolo del sottoutente, le funzionalità del piano, le quote degli oggetti e lo stato attuale della destinazione.
- I registri di audit delle modifiche memorizzano metadati operativi come account, sito, strumento, destinazione, stato, hash e ora. Non memorizzano prompt completi, token del modello, righe grezze dei clienti o payload di grandi dimensioni.
Accesso ai dati e confini della privacy
- Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.
- Gli output di pagina, download, collegamento in uscita, percorso, conservazione, campagna, mappa termica e canalizzazione sono riepiloghi aggregati o modellati sulla privacy anziché esportazioni di eventi non elaborati.
- La configurazione degli obiettivi omette indirizzi di notifica, valori sensibili dei trigger e singole righe di conversione. I dati sulla disponibilità omettono credenziali, condizioni di corrispondenza, stringhe di query e frammenti URL.
- Il contenuto della chat è disponibile solo tramite strumenti con ambito chat per gli utenti autorizzati. I clienti assistenti devono considerare il contenuto della chat come testo non attendibile fornito dal cliente.
- La telemetria sull'utilizzo di MCP conserva account/sito, tipo di credenziale, ID client OAuth pubblico, canale client AI normalizzato, nome dello strumento, stato, durata e timestamp per la visibilità operativa. Sono esclusi prompt, argomenti, token, agenti utente non elaborati, righe di risultati e corpi di messaggi di errore e la finestra di rollup è di 90 giorni.
- Il server non offre intenzionalmente accesso SQL diretto, modifiche a fatturazione, password, profilo dell’account, 2FA o chiave API di tracciamento, dati grezzi dei profili visitatore, chiavi private, video di replay delle sessioni, log della console JavaScript, tracce di rete o gestione degli esperimenti.
Rilevamento OAuth e compatibilità client
- Risorsa protetta metadata: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp
- Metadata: https://www.hitsteps.com/.well-known/oauth-authorization-server del server di autorizzazione
- L'endpoint MCP accetta origini client HTTPS MCP valide e origini di sviluppo loopback HTTP per client desktop e basati su browser.
- La registrazione dinamica del client supporta HTTPS, loopback HTTP sicuri e schemi di reindirizzamento di app native private utilizzati dai client MCP desktop, rifiutando schemi non sicuri come javascript:, data:, file:, blob: e 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.
- Il pubblico della risorsa è https://www.hitsteps.com/mcp o https://www.hitsteps.com/mcp/, corrispondente al modulo dell'endpoint salvato dal client AI.
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.
È questo il codice di monitoraggio del mio sito web?
No. Il server MCP è destinato agli assistenti AI connessi che devono leggere o operare sui dati Hitsteps. Il monitoraggio dei siti web utilizza ancora il codice di monitoraggio Hitsteps JavaScript o un plug-in Hitsteps specifico per la piattaforma.
Un assistente AI può modificare il mio account Hitsteps dopo averlo collegato?
Solo se l’autorizzazione OAuth include l’ambito di modifica richiesto e l’utente conferma esplicitamente l’azione specifica. Le autorizzazioni di sola lettura non possono creare siti, modificare impostazioni o monitor di disponibilità, aggiornare avvisi o inviare risposte in chat.
Posso collegare ChatGPT o Claude AI?
SÌ. Gli utenti Claude possono installare Hitsteps Web Analytics dalla directory del connettore Claude. L'elenco delle directory ChatGPT sarà presto disponibile; fino ad allora, aggiungi https://www.hitsteps.com/mcp/ manualmente come server MCP personalizzato in ChatGPT e completa 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.
Cosa succede se il limite della mia versione di prova, licenza o piano Hitsteps blocca l'accesso?
Il server restituisce una risposta license_action_required strutturata con stato dell'account non sensibile e un URL Hitsteps in cui l'utente può verificare, rinnovare o aggiornare. Le informazioni sulla connessione, l'elenco dei siti e lo stato dell'account rimangono disponibili in modo che l'assistente possa spiegare il problema.
Hitsteps memorizza i miei suggerimenti IA?
La telemetria sull'utilizzo di MCP rispetta al minimo la privacy. Registra campi operativi come l'ID client OAuth pubblico, il canale client AI normalizzato, il nome dello strumento, lo stato, la durata, il tipo di credenziale, l'account/sito e il timestamp. Non memorizza prompt, argomenti di strumenti, token di modello, programmi utente grezzi, righe di risultati grezzi o corpi completi di messaggi di errore.
Dopo l'installazione
Cosa possono fare gli assistenti AI con Hitsteps
Chiedi panoramiche del traffico, suddivisioni per sorgente, pagine principali, campagne, visitatori in tempo reale, stato del tracciamento e riepiloghi direzionali basati sui dati Hitsteps attuali.
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.
Mantieni l'accesso limitato tramite ambiti OAuth, autorizzazioni dell'account, limiti del piano, richieste di conferma e risultati progettati nel rispetto della privacy.