Integrasi pembantu AI

Dokumentasi Pelayan Hitsteps AI MCP

Hitsteps exposes a remote Model Context Protocol pelayan for connected AI assistants. Use it to ask about analitik, langsung pelawat, laman, matlamat, masa aktif, amaran, Mentions, and authorized sembang activity from your Hitsteps akaun while keeping access bounded by OAuth scopes, akaun kebenaran, lesen checks, and privacy-shaped tool results.

Sebelum bermula

Akaun Hitsteps dengan akses kepada laman web yang ingin anda periksa
Tetapan klien AI atau ruang kerja yang serasi dengan MCP yang menyokong pelayan Streamable HTTP jauh
Keupayaan untuk log masuk dengan Hitsteps OAuth apabila klien AI bertanya
Keputusan tentang skop OAuth yang harus diterima oleh pembantu

Pilih klien AI anda

Pasang Hitsteps di mana anda sudah menggunakan AI

Mulakan dengan direktori klien anda apabila tersedia. Setiap pilihan bersambung ke pelayan Hitsteps MCP terurus yang sama, kemudian diteruskan melalui Hitsteps OAuth.

GitHub pendaftaran

VS Code dan GitHub Copilot

Buka Pendaftaran MCP GitHub dan pasang Hitsteps Web Analytics daripada pelanggan VS Code atau GitHub Copilot anda.

Tersedia sekarang

Cursor

Buka penyenaraian Hitsteps Web Analytics dalam Direktori Cursor dan pilih Tambah ke Cursor. Cursor hanya menerima titik akhir Hitsteps MCP terurus; akses akaun anda diberikan secara berasingan melalui OAuth.

Tersedia sekarang

Claude AI

Tambahkan Hitsteps Web Analytics daripada Direktori Penyambung Claude, kemudian log masuk ke Hitsteps dan luluskan hanya skop yang anda mahu Claude gunakan.

Akan datang

ChatGPT AI

Penyenaraian direktori Hitsteps untuk ChatGPT akan datang tidak lama lagi. Buat masa ini, tambahkan titik akhir di bawah secara manual sebagai pelayan MCP tersuai, kemudian lengkapkan Hitsteps OAuth.

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

Panduan pemasangan

Google Antigravity dan pelanggan MCP yang lain

1

Gunakan titik akhir MCP jauh

Titik akhir Hitsteps MCP ialah https://www.hitsteps.com/mcp/. Jika klien anda meminta kaedah pengangkutan data, pilih Streamable HTTP atau HTTP. Nama pendaftaran rasmi ialah com.hitsteps/analytics-operations.

2

Pilih tahap akses

Sebelum menyambungkan pelayan, sahkan pengguna Hitsteps yang akan log masuk, tapak web yang boleh diakses dan skop OAuth yang diminta oleh klien AI. Penggunaan analitik sahaja boleh kekal baca sahaja; aliran kerja operasi memerlukan skop tulis khusus yang diterangkan di bawah.

3

Tambah Hitsteps pada Google Antigravity

Konfigurasi MCP jauh tersuai Antigravity menggunakan serverUrl untuk pelayan jauh.

4

Sahkan identiti dengan Hitsteps OAuth

Simpan konfigurasi, mulakan atau muat semula pelayan MCP dalam klien AI anda, kemudian ikuti arahan log masuk. Hitsteps menggunakan OAuth, jadi anda tidak perlu menampal kunci API penjejakan ke dalam klien AI.

5

Sahkan alat dan keistimewaan yang paling sedikit

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.

Perlu diketahui

  • Pelayan MCP ini adalah untuk pembantu AI. Ia tidak memasang penjejakan Hitsteps pada laman web anda.
  • Pengguna VS Code dan GitHub Copilot harus bermula dengan Pendaftaran MCP GitHub; Pengguna Cursor dan Claude boleh menggunakan penyenaraian direktori Hitsteps khusus di atas.
  • Sokongan direktori ChatGPT akan datang tidak lama lagi. Sehingga itu, tambahkan https://www.hitsteps.com/mcp/ secara manual sebagai pelayan MCP tersuai.
  • Jangan tampalkan kunci API penjejakan tapak web Hitsteps anda, token OAuth atau kata laluan akaun ke dalam konfigurasi MCP.

Penyelesaian masalah

  • Permintaan GET pelayar ke titik akhir MCP mungkin mengembalikan mesej tiada SSE atau mesej kaedah. Itu perkara biasa; klien MCP bersambung dengan JSON-RPC melalui HTTP.
  • Respons 401 sebelum log masuk memang dijangka. Klien harus menggunakan metadata OAuth yang diumumkan untuk memulakan kebenaran.
  • Jika Hitsteps tidak muncul dalam direktori klien rasmi, muat semula direktori itu dan semak dasar organisasi serta tetapan MCP klien.

Hitsteps AI dalam papan pemuka anda

Gunakan AI mengikut cara anda: dalam Hitsteps atau dalam pembantu anda sendiri

Gunakan Hitsteps AI dalam papan pemuka, atau sambungkan Hitsteps MCP Plugin percuma kepada pembantu AI serasi anda sendiri untuk analitik web berbentuk perbualan.

Keselamatan dan akses

Butiran sambungan

Gunakan butiran ini untuk menyambungkan Hitsteps dan memahami perkara yang boleh diakses oleh pembantu AI daripada akaun anda.

Titik akhir awam

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.

Kaedah pengangkutan data

Hitsteps menggunakan Streamable HTTP jauh dengan JSON-RPC. Tiada pakej Node.js tempatan, jambatan desktop, pekerja SSE atau proses yang dihoskan pelanggan yang berasingan untuk dipasang.

Identiti pendaftaran

Nama pendaftaran/pelayan ialah com.hitsteps/analytics-operations dan tajuk yang dipaparkan ialah Hitsteps Analytics and Operations.

Pengesahan identiti

Public AI clients use Hitsteps OAuth with authorization code flow and S256 PKCE. Dynamic registration supports new and custom clients, while the persetujuan halaman asks you to verify the exact callback and scopes and requires an extra acknowledgement for write access.

Tiada rahsia yang dikongsi dalam konfigurasi

Konfigurasi MCP hanya mengandungi URL titik akhir. Jangan tampal kata laluan Hitsteps, penjejakan kunci API, kod tapak web atau token OAuth ke dalam fail konfigurasi klien AI.

Akses terhad

Setiap permintaan disemak semula terhadap akaun Hitsteps yang dilog masuk, kebenaran sub-pengguna, tapak web yang boleh dilihat, status lesen, had ciri dan skop OAuth yang diberikan kepada klien tersebut.

Pemberian kuasa

Skop OAuth

Hitsteps menerbitkan perisytiharan OAuth bagi setiap alat. Klien AI boleh meminta akses baca sahaja yang terhad atau kebenaran operasi yang lebih luas, bergantung pada aliran kerja yang anda mahukan.

analytics:read
Baca laporan analitis, senarai tapak, konteks tapak, kesihatan penjejakan, ringkasan gelagat agregat, syot kilat masa nyata dan status akaun/lesen.
sites:write
Buat tapak web dan kemas kini tetapan tapak web yang dibenarkan selepas pengesahan yang jelas.
goals:write
Buat, kemas kini atau padamkan matlamat dan konfigurasi kempen selepas pengesahan yang jelas.
labels:write
Create, update, or delete Segments after explicit confirmation. The MCP API keeps its legacy label identifiers for compatibility.
uptime:write
Buat, kemas kini atau padamkan kenalan masa aktif, monitor, jadual penyelenggaraan dan tindakan pemulihan selepas pengesahan yang jelas.
alerts:read
Baca senarai makluman dan status makluman untuk akaun yang dibenarkan.
alerts:write
Tandai makluman sebagai makluman dibaca atau kosongkan selepas pengesahan yang jelas.
chat:read
Baca senarai sembang yang dibenarkan, hasil carian, ringkasan perbualan dan butiran sembang terpilih.
chat:write
Cipta tiket, balas sembang, tambah nota dalaman, kemas kini keadaan sembang, namakan pelawat, tandai sembang dibaca atau padamkan sembang secara logik selepas pengesahan yang jelas.
mentions:read
Read active Mentions queries and combined Web Carian/X results.
mentions:write
Add, rename, or remove active Mentions kata kunci queries after explicit confirmation.

Liputan alatan

Apa yang pembantu boleh minta Hitsteps lakukan

Pelayan MCP menyediakan alat baca analitik, alat tulis dengan pengesahan, sumber yang disahkan identitinya, templat sumber dan prompt. Bacaan Mentions menggunakan cache selama satu jam; perubahan pertanyaan Mentions memerlukan pengesahan jelas.

Penemuan dan pelaporan

Maklumat sambungan, tapak web yang boleh dilihat, konteks tapak, katalog metrik dan dimensi, laporan gambaran keseluruhan, siri masa yang dipenuhi jurang, pecahan, pengesanan anomali, penjelasan perubahan trafik, ringkasan eksekutif dan penggunaan MCP minimum privasi.

Trafik dan pemerolehan

Ringkasan trafik, perbandingan tempoh, sumber, rujukan sosial, trafik mengikut jam, halaman teratas, halaman masuk/keluar, butiran halaman, kelajuan halaman, muat turun, pautan keluar, perujuk, negara, teknologi khalayak, enjin carian, kata kunci, rujukan AI, trafik bot dan pelawat masa nyata.

Penukaran dan tingkah laku

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.

Konfigurasi dan operasi

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.

Perlindungan tindakan tulis

  • Semua alat tulis memerlukan OAuth dan skop tepat yang diisytiharkan untuk alat itu. Kunci API tapak web lama dan token mudah alih peribadi boleh menggunakan bacaan analitik sahaja.
  • Setiap operasi perubahan memerlukan confirm=true selepas pengguna mengesahkan tindakan tersebut dengan jelas dalam perbualan bersama klien AI.
  • Setiap operasi perubahan memerlukan idempotency_key sepanjang 8–128 aksara. Penggunaan semula kunci yang sama dengan argumen yang sama mengembalikan hasil terdahulu; penggunaan dengan argumen berbeza mengembalikan HTTP 409.
  • Tindakan tulis dijalankan dalam transaksi pangkalan data dan menyemak semula status akaun, pemilikan tapak web, peranan sub-pengguna, ketersediaan ciri pelan, kuota objek dan keadaan sasaran semasa sebelum mengubah data.
  • Rekod audit tindakan tulis menyimpan metadata operasi seperti akaun, tapak web, alat, sasaran, status, nilai cincang dan masa. Rekod ini tidak menyimpan gesaan penuh, token model, baris data pelanggan mentah atau muatan besar.

Capaian data dan sempadan privasi

  • Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.
  • Keluaran halaman, muat turun, pautan keluar, laluan, pengekalan, kempen, peta haba dan corong ialah ringkasan agregat atau berbentuk privasi dan bukannya eksport acara mentah.
  • Konfigurasi matlamat tidak menyertakan alamat pemberitahuan, nilai pencetus sensitif atau baris penukaran individu. Output masa aktif tidak menyertakan bukti kelayakan, syarat padanan, rentetan pertanyaan atau bahagian fragment/hash URL selepas tanda #.
  • Kandungan sembang hanya tersedia melalui alat berskop sembang untuk pengguna yang dibenarkan. Pelanggan pembantu harus menganggap kandungan sembang sebagai teks yang dibekalkan pelanggan yang tidak dipercayai.
  • Telemetri penggunaan MCP menyimpan akaun/tapak, jenis bukti kelayakan, ID pelanggan OAuth awam, saluran klien AI yang dinormalkan, nama alat, status, tempoh dan cap masa untuk keterlihatan operasi. Ia tidak termasuk gesaan, hujah, token, ejen pengguna mentah, baris hasil dan badan mesej ralat, dan tetingkap rollup ialah 90 hari.
  • Pelayan sengaja tidak menyediakan akses SQL langsung, perubahan pengebilan atau kata laluan, perubahan profil akaun atau 2FA, eksport mentah profil pelawat, kunci peribadi, perubahan kunci API penjejakan, video rakaman sesi, log konsol JavaScript, rakaman trafik rangkaian atau pengurusan eksperimen.

Penemuan OAuth dan keserasian pelanggan

  • Metadata sumber yang dilindungi: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp
  • Metadata pelayan kebenaran: https://www.hitsteps.com/.well-known/oauth-authorization-server
  • Titik akhir MCP menerima asal-usul klien HTTPS MCP yang sah dan asal-usul pembangunan gelung balik HTTP untuk klien berasaskan penyemak imbas dan desktop.
  • Pendaftaran klien dinamik menyokong HTTPS yang selamat, gelung balik HTTP dan skim ubah hala aplikasi natif peribadi yang digunakan oleh klien MCP desktop, sambil menolak skim tidak selamat seperti javascript:, data:, file:, blob: dan websocket.
  • Registration is intentionally open for new and custom clients. The persetujuan halaman asks users to verify the exact callback and scopes, and requires an extra acknowledgement before write-capable access is granted.
  • Khalayak sumber ialah https://www.hitsteps.com/mcp atau https://www.hitsteps.com/mcp/, sepadan dengan borang titik akhir yang disimpan oleh klien AI.

FAQ

Questions about connecting Hitsteps to AI

Review the access, penjejakan, 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.

Adakah ini kod penjejakan untuk tapak web saya?

Tidak. Pelayan MCP adalah untuk pembantu AI bersambung yang perlu membaca atau mengendalikan data Hitsteps. Penjejakan tapak web masih menggunakan kod penjejakan Hitsteps JavaScript atau pemalam Hitsteps khusus platform.

Bolehkah pembantu AI menukar akaun Hitsteps saya selepas saya menyambungkannya?

Hanya jika kebenaran OAuth merangkumi skop tulis yang diperlukan dan pengguna mengesahkan tindakan tulis tersebut dengan jelas. Akses analitik baca sahaja tidak boleh mencipta laman web, mengubah tetapan atau monitor masa operasi, mengemas kini makluman atau menghantar balasan sembang.

Bolehkah saya menyambungkan ChatGPT atau Claude AI?

ya. Pengguna Claude boleh memasang Hitsteps Web Analytics daripada Direktori Penyambung Claude. Penyenaraian direktori ChatGPT akan datang tidak lama lagi; sehingga itu, tambah https://www.hitsteps.com/mcp/ secara manual sebagai pelayan MCP tersuai dalam ChatGPT dan lengkapkan 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.

Apakah yang berlaku jika percubaan, lesen atau pelan Hitsteps saya menyekat akses?

Pelayan mengembalikan respons license_action_required berstruktur dengan status akaun tidak sensitif dan URL Hitsteps yang membolehkan pengguna menyemak, memperbaharui atau menaik taraf. Maklumat sambungan, penyenaraian tapak dan status akaun kekal tersedia supaya pembantu boleh menerangkan isu tersebut.

Adakah Hitsteps menyimpan gesaan AI saya?

Telemetri penggunaan MCP adalah privasi-minimum. Ia merekodkan medan operasi seperti ID pelanggan OAuth awam, saluran klien AI yang dinormalkan, nama alat, status, tempoh, jenis bukti kelayakan, akaun/tapak dan cap waktu. Ia tidak menyimpan gesaan, hujah alat, token model, ejen pengguna mentah, baris hasil mentah atau badan mesej ralat penuh.

Selepas pemasangan

Perkara yang boleh dilakukan oleh pembantu AI dengan Hitsteps

Minta gambaran keseluruhan trafik, pecahan sumber, halaman teratas, kempen, pelawat masa nyata, status penjejakan dan ringkasan eksekutif daripada data Hitsteps semasa.
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.
Hadkan akses melalui skop OAuth, kebenaran akaun, had pelan, permintaan pengesahan dan bentuk hasil yang menjaga privasi.