Integrasi asisten AI

Dokumentasi Server Hitsteps AI MCP

Hitsteps exposes a remote Model Context Protocol peladen for connected AI assistants. Use it to ask about analitik, langsung pengunjung, situs, tujuan, waktu aktif, peringatan, Mentions, and authorized obrolan activity from your Hitsteps akun while keeping access bounded by OAuth scopes, akun izin, lisensi checks, and privacy-shaped tool results.

Sebelum mulai

Akun Hitsteps dengan akses ke situs web yang ingin Anda periksa
Pengaturan klien AI atau ruang kerja yang kompatibel dengan MCP yang mendukung server Streamable HTTP jarak jauh
Kemampuan untuk masuk dengan Hitsteps OAuth ketika klien AI memintanya
Keputusan tentang cakupan OAuth mana yang harus diterima asisten

Pilih klien AI Anda

Instal Hitsteps di tempat Anda sudah menggunakan AI

Mulailah dengan direktori klien Anda jika sudah tersedia. Setiap opsi terhubung ke server Hitsteps MCP terkelola yang sama dan berlanjut melalui Hitsteps OAuth.

Registri GitHub

VS Code dan GitHub Copilot

Buka Registri GitHub MCP dan instal Hitsteps Web Analytics dari klien VS Code atau GitHub Copilot Anda.

Tersedia sekarang

Cursor

Buka daftar Hitsteps Web Analytics di Direktori Cursor dan pilih Tambahkan ke Cursor. Cursor hanya menerima titik akhir Hitsteps MCP yang dikelola; akses akun Anda diberikan secara terpisah melalui OAuth.

Tersedia sekarang

Claude AI

Tambahkan Hitsteps Web Analytics dari Direktori Konektor Claude, lalu masuk ke Hitsteps dan setujui hanya cakupan yang Anda ingin Claude gunakan.

Segera hadir

ChatGPT AI

Daftar direktori Hitsteps untuk ChatGPT akan segera hadir. Untuk saat ini, tambahkan titik akhir di bawah secara manual sebagai server MCP kustom, lalu selesaikan Hitsteps OAuth.

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

Panduan instalasi

Google Antigravity dan klien MCP lainnya

1

Gunakan endpoint MCP jarak jauh

Endpoint Hitsteps MCP adalah https://www.hitsteps.com/mcp/. Jika klien Anda meminta jenis transportasi, pilih Streamable HTTP atau HTTP. Nama registri resminya adalah com.hitsteps/analytics-operations.

2

Pilih tingkat akses

Sebelum menghubungkan server, konfirmasikan pengguna Hitsteps mana yang akan masuk, situs web mana yang dapat diakses pengguna, dan cakupan OAuth mana yang diminta oleh klien AI. Penggunaan hanya Analytics dapat tetap menjadi hanya baca; alur kerja operasional memerlukan cakupan penulisan khusus yang dijelaskan di bawah.

3

Tambahkan Hitsteps ke Google Antigravity

Konfigurasi MCP jarak jauh khusus Antigravity menggunakan serverUrl untuk server jarak jauh.

4

Autentikasi dengan Hitsteps OAuth

Simpan konfigurasi, mulai atau segarkan server MCP di klien AI Anda, lalu ikuti petunjuk masuk. Hitsteps menggunakan OAuth sehingga Anda tidak perlu menempelkan kunci API pelacakan ke klien AI.

5

Verifikasi alat dan hak istimewa 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

  • Server MCP ini ditujukan untuk asisten AI. Server ini tidak memasang pelacakan Hitsteps di situs web Anda.
  • Pengguna VS Code dan GitHub Copilot harus memulai dengan Registri MCP GitHub; Pengguna Cursor dan Claude dapat menggunakan daftar direktori khusus Hitsteps di atas.
  • Dukungan direktori ChatGPT akan segera hadir. Sampai saat itu, tambahkan https://www.hitsteps.com/mcp/ secara manual sebagai server MCP khusus.
  • Jangan tempelkan kunci API pelacakan situs web Hitsteps Anda, token OAuth, atau kata sandi akun ke dalam konfigurasi MCP.

Pemecahan masalah

  • Permintaan GET dari browser ke endpoint MCP dapat mengembalikan pesan tanpa SSE atau pesan metode. Itu normal; klien MCP terhubung dengan JSON-RPC melalui HTTP.
  • Respons 401 sebelum masuk memang diharapkan. Klien harus menggunakan metadata OAuth yang diumumkan untuk memulai otorisasi.
  • Jika direktori klien resmi tidak memunculkan Hitsteps, segarkan direktori dan periksa kebijakan organisasi klien dan pengaturan MCP.

Hitsteps AI di dalam dasbor Anda

Gunakan AI dengan cara Anda: di dalam Hitsteps atau di asisten Anda sendiri

Gunakan Hitsteps AI di dalam dasbor, atau hubungkan Hitsteps MCP Plugin gratis ke asisten AI kompatibel milik Anda untuk analitik web percakapan.

Keamanan dan akses

Detail koneksi

Gunakan detail ini untuk menghubungkan Hitsteps dan memahami apa yang dapat diakses oleh asisten AI dari akun Anda.

Titik akhir publik

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.

Metode transport

Hitsteps menggunakan Streamable HTTP jarak jauh dengan JSON-RPC. Tidak ada paket Node.js lokal, jembatan desktop, pekerja SSE, atau proses terpisah yang dihosting pelanggan untuk diinstal.

Identitas registri

Nama registri/server adalah com.hitsteps/analytics-operations dan judul yang ditampilkan adalah Hitsteps Analytics and Operations.

Otentikasi

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.

Tidak ada rahasia bersama di konfigurasi

Konfigurasi MCP hanya berisi URL titik akhir. Jangan menempelkan kata sandi Hitsteps, kunci pelacakan API, kode situs web, atau token OAuth ke dalam file konfigurasi klien AI.

Akses terbatas

Setiap permintaan diperiksa ulang berdasarkan akun Hitsteps yang masuk, izin sub-pengguna, situs web yang terlihat, status lisensi, batas fitur, dan cakupan OAuth yang diberikan kepada klien tersebut.

Otorisasi

Cakupan OAuth

Hitsteps menerbitkan deklarasi OAuth untuk setiap alat. Klien AI dapat meminta akses baca-saja yang terbatas atau izin operasional yang lebih luas, sesuai alur kerja yang Anda inginkan.

analytics:read
Baca laporan analitik, daftar situs, konteks situs, kesehatan pelacakan, ringkasan perilaku agregat, cuplikan waktu nyata, dan status akun/lisensi.
sites:write
Buat situs web dan perbarui pengaturan situs web yang diizinkan setelah konfirmasi eksplisit.
goals:write
Buat, perbarui, atau hapus konfigurasi sasaran dan kampanye setelah konfirmasi eksplisit.
labels:write
Create, update, or delete Segments after explicit confirmation. The MCP API keeps its legacy label identifiers for compatibility.
uptime:write
Membuat, memperbarui, atau menghapus kontak uptime, monitor, jadwal pemeliharaan, dan tindakan pemulihan setelah konfirmasi eksplisit.
alerts:read
Baca daftar peringatan dan status peringatan untuk akun resmi.
alerts:write
Tandai peringatan sebagai telah dibaca atau hapus peringatan setelah konfirmasi eksplisit.
chat:read
Baca daftar obrolan resmi, hasil pencarian, ringkasan percakapan, dan detail obrolan yang dipilih.
chat:write
Buat tiket, balas obrolan, tambahkan catatan internal, perbarui status obrolan, beri nama pengunjung, tandai obrolan sudah dibaca, atau hapus obrolan secara logis setelah konfirmasi eksplisit.
mentions:read
Read active Mentions queries and combined Web Cari/X results.
mentions:write
Add, rename, or remove active Mentions kata kunci queries after explicit confirmation.

Cakupan alat

Apa yang dapat diminta oleh asisten untuk dilakukan oleh Hitsteps

Server MCP menyediakan alat baca analitik, alat tulis dengan konfirmasi, sumber daya terautentikasi, templat sumber daya, dan prompt. Pembacaan Mentions menggunakan cache satu jam; perubahan kueri Mentions memerlukan konfirmasi eksplisit.

Penemuan dan pelaporan

Informasi koneksi, situs web yang terlihat, konteks situs, katalog metrik dan dimensi, laporan ikhtisar, rangkaian waktu yang penuh celah, perincian, deteksi anomali, penjelasan perubahan lalu lintas, ringkasan eksekutif, dan penggunaan MCP dengan privasi minimal.

Lalu lintas dan akuisisi

Ringkasan lalu lintas, perbandingan periode, sumber, rujukan sosial, lalu lintas menurut jam, halaman teratas, halaman masuk/keluar, detail halaman, kecepatan halaman, unduhan, tautan keluar, perujuk, negara, teknologi audiens, mesin pencari, kata kunci, rujukan AI, lalu lintas bot, dan pengunjung waktu nyata.

Konversi dan perilaku

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 cakupan persis yang dinyatakan untuk alat tersebut. Kunci API situs web lama dan token seluler pribadi dapat menggunakan analisis hanya baca.
  • Setiap operasi perubahan memerlukan confirm=true setelah pengguna secara eksplisit mengonfirmasi tindakan tersebut dalam percakapan dengan klien AI.
  • Setiap operasi perubahan memerlukan idempotency_key sepanjang 8–128 karakter. Menggunakan kembali kunci yang sama dengan argumen yang sama akan mengembalikan hasil sebelumnya; penggunaan dengan argumen berbeda akan mengembalikan HTTP 409.
  • Tindakan tulis dijalankan dalam transaksi basis data dan memeriksa ulang status akun, kepemilikan situs web, peran sub-pengguna, ketersediaan fitur paket, kuota objek, dan status target saat ini sebelum mengubah data.
  • Catatan audit penulisan menyimpan metadata operasional seperti akun, situs web, alat, target, status, hash, dan waktu. Catatan ini tidak menyimpan prompt lengkap, token model, baris mentah pelanggan, atau muatan besar.

Akses data dan batasan privasi

  • Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.
  • Keluaran halaman, unduhan, tautan keluar, jalur, retensi, kampanye, peta panas, dan corong adalah ringkasan agregat atau berbentuk privasi, bukan ekspor peristiwa mentah.
  • Konfigurasi sasaran tidak menyertakan alamat notifikasi, nilai pemicu sensitif, atau baris konversi individual. Output uptime tidak menyertakan kredensial, kondisi kecocokan, string kueri, atau bagian fragment/hash URL setelah tanda #.
  • Konten obrolan hanya tersedia melalui alat cakupan obrolan untuk pengguna yang berwenang. Klien asisten harus memperlakukan konten obrolan sebagai teks yang diberikan pelanggan tidak tepercaya.
  • Telemetri penggunaan MCP menyimpan akun atau situs, jenis kredensial, ID klien OAuth publik, kanal klien AI yang dinormalisasi, nama alat, status, durasi, dan stempel waktu untuk visibilitas operasional. Prompt, argumen, token, agen pengguna mentah, baris hasil, dan isi pesan kesalahan tidak disimpan; jendela agregasinya 90 hari.
  • Server sengaja tidak menyediakan akses SQL langsung, perubahan penagihan atau kata sandi, perubahan profil akun atau 2FA, ekspor mentah profil pengunjung, kunci privat, perubahan kunci API pelacakan, video rekaman sesi, log konsol JavaScript, rekaman lalu lintas jaringan, atau pengelolaan eksperimen.

Penemuan OAuth dan kompatibilitas klien

  • Metadata sumber daya terlindungi: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp
  • Metadata server otorisasi: https://www.hitsteps.com/.well-known/oauth-authorization-server
  • Titik akhir MCP menerima asal klien HTTPS MCP yang valid dan asal pengembangan loopback HTTP untuk klien berbasis browser dan desktop.
  • Pendaftaran klien dinamis mendukung HTTPS, loopback HTTP, dan skema pengalihan aplikasi asli pribadi yang digunakan oleh klien desktop MCP, sekaligus menolak skema tidak aman seperti skema 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.
  • Audiens sumber dayanya adalah https://www.hitsteps.com/mcp atau https://www.hitsteps.com/mcp/, yang cocok dengan formulir titik akhir yang disimpan oleh klien AI.

FAQ

Questions about connecting Hitsteps to AI

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

Apakah ini kode pelacakan untuk situs web saya?

Tidak. Server MCP ditujukan untuk asisten AI terhubung yang perlu membaca atau mengoperasikan data Hitsteps. Pelacakan situs web masih menggunakan kode pelacakan Hitsteps JavaScript atau plugin Hitsteps khusus platform.

Bisakah asisten AI mengubah akun Hitsteps saya setelah saya menghubungkannya?

Hanya jika izin OAuth mencakup cakupan tulis yang diperlukan dan pengguna secara eksplisit mengonfirmasi tindakan tulis tersebut. Akses analitik baca-saja tidak dapat membuat situs web, mengubah pengaturan atau monitor uptime, memperbarui peringatan, maupun mengirim balasan chat.

Bisakah saya menghubungkan ChatGPT atau Claude AI?

Ya. Pengguna Claude dapat menginstal Hitsteps Web Analytics dari Direktori Konektor Claude. Daftar direktori ChatGPT akan segera hadir; sampai saat itu, tambahkan https://www.hitsteps.com/mcp/ secara manual sebagai server MCP khusus di ChatGPT dan selesaikan 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.

Apa yang terjadi jika uji coba, lisensi, atau batas paket Hitsteps saya memblokir akses?

Server mengembalikan respons license_action_required terstruktur dengan status akun tidak sensitif dan URL Hitsteps tempat pengguna dapat memeriksa, memperbarui, atau meningkatkan. Info koneksi, daftar situs, dan status akun tetap tersedia sehingga asisten dapat menjelaskan masalahnya.

Apakah Hitsteps menyimpan prompt AI saya?

Telemetri penggunaan MCP dibatasi seminimal mungkin demi privasi. Telemetri mencatat bidang operasional seperti ID klien OAuth publik, kanal klien AI yang dinormalisasi, nama alat, status, durasi, jenis kredensial, akun atau situs, dan stempel waktu. Telemetri tidak menyimpan prompt, argumen alat, token model, agen pengguna mentah, baris hasil mentah, atau isi lengkap pesan kesalahan.

Setelah instalasi

Yang dapat dilakukan asisten AI dengan Hitsteps

Minta ikhtisar lalu lintas, rincian sumber, halaman teratas, kampanye, pengunjung realtime, status pelacakan, dan ringkasan eksekutif dari data Hitsteps terkini.
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.
Batasi akses dengan cakupan OAuth, izin akun, batas paket, permintaan konfirmasi, dan bentuk hasil yang menjaga privasi.