AI asistanı entegrasyonu

Hitsteps AI MCP Sunucu Belgeleri

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.

AI istemcinizi seçin Tüm entegrasyonlar

Başlamadan önce

İncelemek istediğiniz web sitelerine erişimi olan bir Hitsteps hesabı
Uzak Streamable HTTP sunucularını destekleyen, MCP uyumlu bir AI istemcisi veya çalışma alanı ayarı
AI istemcisi sorduğunda Hitsteps OAuth ile oturum açabilme yeteneği
Asistanın hangi OAuth kapsamlarını alması gerektiğine ilişkin karar

AI istemcinizi seçin

Zaten AI kullandığınız yere Hitsteps'i yükleyin

Varsa istemci dizininizden başlayın. Her seçenek aynı yönetilen Hitsteps MCP sunucusuna bağlanır ve Hitsteps OAuth akışıyla devam eder.

GitHub kayıt defteri

VS Code ve GitHub Copilot

GitHub'ın MCP Kayıt Defterini açın ve VS Code veya GitHub Copilot istemcinizden Hitsteps Web Analytics'i yükleyin.

GitHub MCP Kayıt Defterini açın
Şu anda mevcut

Cursor

Cursor Directory'deki Hitsteps Web Analytics sayfasını açın ve Cursor'a eklemeyi seçin. Cursor yalnızca yönetilen Hitsteps MCP uç noktasını alır; hesabınıza erişim OAuth üzerinden ayrıca verilir.

Cursor Directory'yi aç
Şu anda mevcut

Claude AI

Claude'un Bağlayıcı Dizininden Hitsteps Web Analytics'i ekleyin, ardından Hitsteps'te oturum açın ve yalnızca Claude'un kullanmasını istediğiniz kapsamları onaylayın.

Claude bağlayıcısını aç
Yakında gelecek

ChatGPT AI

ChatGPT için Hitsteps dizin listesi yakında geliyor. Şimdilik aşağıdaki uç noktayı özel bir MCP sunucusu olarak manuel olarak ekleyin, ardından Hitsteps OAuth'ü tamamlayın.

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

Kurulum kılavuzu

Google Antigravity ve diğer MCP istemcileri

1

Uzak MCP uç noktasını kullanın

Hitsteps MCP uç noktası https://www.hitsteps.com/mcp/ adresidir. İstemciniz aktarım türü sorarsa Streamable HTTP veya HTTP seçin. Resmî kayıt adı com.hitsteps/analytics-operations değeridir.

2

Erişim düzeyini seçin

Sunucuyu bağlamadan önce hangi Hitsteps kullanıcısının oturum açacağını, bu kullanıcının hangi web sitelerine erişebileceğini ve AI istemcisinin hangi OAuth kapsamlarını istediğini doğrulayın. Yalnızca analiz kullanımı salt okunur olarak kalabilir; operasyonel iş akışları aşağıda açıklanan özel yazma kapsamlarına ihtiyaç duyar.

3

Hitsteps'i Google Antigravity'ye ekleyin

Antigravity'nin özel uzak MCP yapılandırması, uzak sunucular için serverUrl kullanır.

4

Hitsteps OAuth ile kimlik doğrulayın

Yapılandırmayı kaydedin, AI istemcinizde MCP sunucusunu başlatın veya yenileyin, ardından oturum açma istemini izleyin. Hitsteps OAuth kullandığından izleme API anahtarınızı AI istemcisine yapıştırmanız gerekmez.

5

Araçları ve en az ayrıcalığı doğrulayı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 and Triggers, uptime, alerts, Mentions, and chat actions require matching OAuth scopes, account permissions, and explicit confirmation.

bilmek güzel

  • Bu MCP sunucusu AI asistanları içindir. Web sitenize Hitsteps izleme kodunu kurmaz.
  • VS Code ve GitHub Copilot kullanıcıları GitHub'ın MCP Registry sayfasından başlamalıdır; Cursor ve Claude kullanıcıları yukarıdaki özel Hitsteps dizin sayfalarını kullanabilir.
  • ChatGPT dizin desteği yakında geliyor. O zamana kadar şu adresi özel MCP sunucusu olarak elle ekleyin: https://www.hitsteps.com/mcp/
  • Hitsteps web sitesi izleme API anahtarınızı, OAuth jetonunuzu veya hesap şifrenizi MCP yapılandırmasına yapıştırmayın.

Sorun giderme

  • MCP uç noktasına yapılan bir tarayıcı GET isteği, SSE bulunmadığına veya yönteme ilişkin bir mesaj döndürebilir. Bu normaldir; MCP istemcileri HTTP üzerinden JSON-RPC ile bağlanır.
  • Oturum açmadan önce 401 yanıtı beklenir. İstemci, yetkilendirmeyi başlatmak için yayımlanan OAuth meta verilerini kullanmalıdır.
  • Resmî istemci dizininde Hitsteps görünmüyorsa dizini yenileyin ve istemcinin kuruluş politikasını ve MCP ayarlarını kontrol edin.

Panelinizin içindeki Hitsteps AI

AI kullanımınızı seçin: Hitsteps içinde veya kendi asistanınızda

Hitsteps AI özelliğini doğrudan panelde kullanın veya ücretsiz Hitsteps MCP Plugin ile kendi uyumlu AI asistanınızı bağlayarak konuşmalı web analitiğinden yararlanın.

İstemleri, örnek yanıtları ve MCP avantajını görün

Güvenlik ve erişim

Bağlantı ayrıntıları

Hitsteps'e bağlanmak ve AI asistanının hesabınızdan nelere erişebileceğini anlamak için bu ayrıntıları kullanın.

Genel uç nokta

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.

Aktarım

Hitsteps, JSON-RPC ile uzaktan Streamable HTTP'ı kullanır. Yüklenecek yerel bir Node.js paketi, masaüstü köprüsü, SSE çalışanı veya müşteri tarafından barındırılan ayrı bir işlem yoktur.

Kayıt defteri kimliği

Kayıt defteri/sunucu adı com.hitsteps/analytics-operations ve görüntülenen başlık Hitsteps Analytics and Operations'tır.

Kimlik doğrulama

Genel AI istemcileri, yetkilendirme kodu akışı ve S256 PKCE ile Hitsteps OAuth kullanır. Kullanıcı Hitsteps'te oturum açar ve istemci belirteci almadan önce istenen kapsamları görür.

Yapılandırmada paylaşılan gizli bilgi yok

MCP yapılandırması yalnızca uç nokta URL'sini içerir. Hitsteps şifresini, izleme API anahtarını, web sitesi kodunu veya OAuth jetonunu AI istemci yapılandırma dosyasına yapıştırmayın.

Sınırlı erişim

Her istek; oturum açılan Hitsteps hesabı, alt kullanıcı izinleri, görünür web siteleri, lisans durumu, özellik sınırları ve ilgili istemciye verilen OAuth kapsamlarıyla yeniden denetlenir.

Yetkilendirme

OAuth kapsamları

Hitsteps, araç başına OAuth bildirim yayınlar. Bir AI istemcisi, istediğiniz iş akışına bağlı olarak dar bir salt okunur izni veya daha geniş bir operasyonel izni talep edebilir.

analytics:read
Analitik raporlarını, site listelerini ve bağlamını, izleme durumunu, toplu davranış özetlerini, gerçek zamanlı anlık görüntüleri ve hesap/lisans durumunu okuyun.
sites:write
Açıkça onaylandıktan sonra web siteleri oluşturun ve izin verilen web sitesi ayarlarını güncelleyin.
goals:write
Açıkça onaylandıktan sonra hedef ve kampanya yapılandırmasını oluşturun, güncelleyin veya silin.
labels:write
Create, update, or delete Triggers in Segments and Triggers after explicit confirmation. The MCP API keeps its legacy label identifiers for compatibility.
uptime:write
Açık onayın ardından çalışma süresi iletişim kişilerini, monitörleri, bakım planlarını ve kurtarma eylemlerini oluşturun, güncelleyin veya silin.
alerts:read
Yetkili hesap için uyarı listelerini ve uyarı durumunu okuyun.
alerts:write
Açıkça onaylandıktan sonra uyarıları okundu olarak işaretleyin veya uyarıları temizleyin.
chat:read
Yetkili sohbet listelerini, arama sonuçlarını, görüşme özetlerini ve seçilen sohbet ayrıntılarını okuyun.
chat:write
Destek bildirimleri oluşturun, sohbetlere yanıt verin, dahili notlar ekleyin, sohbet durumunu güncelleyin, ziyaretçilere ad verin, sohbetleri okundu olarak işaretleyin veya açıkça onaylandıktan sonra sohbetleri mantıksal olarak silin.
mentions:read
Read active Mentions queries and combined Web Search/X results.
mentions:write
Add, rename, or remove active Mentions keyword queries after explicit confirmation.

Araç kapsamı

Asistanın Hitsteps'ten yapmasını isteyebileceği şeyler

The MCP server currently exposes 100 tools: 60 read tools and 40 confirmed write tools, plus authenticated resources, a resource template, and prompts for common analytics workflows. Mentions reads reuse a one-hour provider cache and Mentions query changes require explicit confirmation.

Veri keşfi ve raporlama

Bağlantı bilgileri, görünür web siteleri, site bağlamı, metrik ve boyut kataloğu, genel bakış raporları, boşlukları doldurulmuş zaman serileri, veri kırılımları, anormallik tespiti, trafik değişikliği açıklamaları, yönetici özetleri ve asgari MCP kullanım telemetrisi.

Trafik ve edinme

Trafik özetleri, dönem karşılaştırmaları, kaynaklar, sosyal yönlendirmeler, saate göre trafik, en iyi sayfalar, giriş/çıkış sayfaları, sayfa ayrıntısı, sayfa hızı, indirmeler, giden bağlantılar, yönlendirenler, ülkeler, hedef kitle teknolojisi, arama motorları, anahtar kelimeler, AI yönlendirmeleri, bot trafiği ve gerçek zamanlı ziyaretçiler.

Dönüşümler ve davranış

Goals, goal conversions, campaigns, funnel performance, interaction events, aggregate paths, retention, Segments and Triggers, heatmap summaries, tracked-video analytics, chat summaries, uptime status/history, and tracking health.

Yapılandırma ve işlemler

Website setup, allowed website settings, goal/campaign configuration, Segments and Triggers configuration, uptime contacts and monitors, maintenance schedules, recovery actions, alert operations, Mentions query configuration, and authorized chat workflows.

Değişiklik işlemlerine yönelik güvenlik önlemleri

  • Değişiklik yapan tüm araçlar OAuth ve o araç için tanımlanan tam kapsamı gerektirir. Eski web sitesi API anahtarları ve özel mobil belirteçler yalnızca analitik verilerini okuyabilir.
  • Her değiştirme işlemi, kullanıcı AI istemcisiyle konuşmada eylemi açıkça onayladıktan sonra confirm=true gerektirir.
  • Her değiştirme işlemi 8–128 karakterlik bir idempotency_key gerektirir. Aynı anahtarı aynı argümanlarla yeniden kullanmak önceki sonucu, farklı argümanlarla yeniden kullanmak ise HTTP 409 döndürür.
  • Değişiklikler veritabanı işlemleri içinde yürütülür; veriler değiştirilmeden önce hesap durumu, web sitesi sahipliği, alt kullanıcı rolü, plan özelliklerinin kullanılabilirliği, nesne kotaları ve hedefin mevcut durumu yeniden denetlenir.
  • Yazma işlemi denetim kayıtları; hesap, web sitesi, araç, hedef, durum, karmalar ve zaman gibi operasyonel meta verileri tutar. Tam istemleri, model belirteçlerini, ham müşteri verisi satırlarını veya büyük yükleri saklamaz.

Veri erişimi ve gizlilik sınırları

  • Realtime visitor output omits raw IP addresses, visitor IDs, Trigger matches, keywords, URL query strings, and fragments.
  • Sayfa, indirme, giden bağlantı, yol, elde tutma, kampanya, ısı haritası ve huni sonuçları; ham olay dışa aktarımları yerine toplu veya gizliliği koruyacak biçimde hazırlanmış özetlerdir.
  • Hedef yapılandırması bildirim adreslerini, hassas tetikleyici değerleri ve tekil dönüşüm satırlarını içermez. Erişilebilirlik çıktısı da kimlik bilgilerini, eşleşme koşullarını, sorgu dizelerini ve URL parçalarını (# sonrası) içermez.
  • Sohbet içeriği yalnızca yetkili kullanıcılar için sohbet kapsamlı araçlar aracılığıyla kullanılabilir. Asistan istemcileri, sohbet içeriğini, müşteri tarafından sağlanan güvenilmeyen metin olarak ele almalıdır.
  • MCP kullanım telemetrisi, operasyonel görünürlük için hesap/site, kimlik bilgisi türü, genel OAuth istemci kimliğini, normalleştirilmiş AI istemci kanalını, araç adını, durumu, süreyi ve zaman damgasını korur. İstemleri, bağımsız değişkenleri, belirteçleri, ham kullanıcı aracılarını, sonuç satırlarını ve hata mesajı gövdelerini hariç tutar ve toplama penceresi 90 gündür.
  • Sunucu kasıtlı olarak doğrudan SQL erişimi; faturalandırma, şifre, hesap profili veya 2FA değişiklikleri; ham ziyaretçi profili dökümleri; özel anahtarlar; izleme API anahtarının değiştirilmesi; oturum tekrar oynatma videoları; JavaScript konsol günlükleri; ağ izleri veya deney yönetimi sunmaz.

OAuth keşif ve istemci uyumluluğu

  • Korunan kaynak meta verileri: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp
  • Yetkilendirme sunucusu meta verileri: https://www.hitsteps.com/.well-known/oauth-authorization-server
  • MCP uç noktası, tarayıcı tabanlı ve masaüstü istemciler için geçerli HTTPS MCP istemci kökenlerini ve HTTP geridöngü geliştirme kökenlerini kabul eder.
  • Dinamik istemci kaydı, güvenli HTTPS, HTTP geri döngüyü ve masaüstü MCP istemcileri tarafından kullanılan özel yerel uygulama yönlendirme şemalarını desteklerken javascript:, data:, file:, blob: ve websocket şemaları gibi güvenli olmayan şemaları reddeder.
  • Kaynağın audience değeri https://www.hitsteps.com/mcp veya https://www.hitsteps.com/mcp/ biçimindedir ve AI istemcisinin kaydettiği uç nokta biçimiyle eşleşir.
Why do MCP tool names still say label?

The Hitsteps dashboard calls the feature Segments and Triggers, and each saved object is a Trigger. Stable MCP tools and scopes retain legacy identifiers such as create_label and labels:write for compatibility. An unqualified request for a Hitsteps Segment or Trigger should use those tools unless the user explicitly means a conversion-goal or campaign condition.

Bu web sitemin izleme kodu mu?

Hayır. MCP sunucusu, Hitsteps verilerini okuması veya bunlar üzerinde çalışması gereken bağlı yapay zeka asistanları içindir. Web sitesi takibi hâlâ Hitsteps JavaScript izleme kodunu veya platforma özel bir Hitsteps eklentisini kullanıyor.

Bir AI asistanı Hitsteps hesabımı bağladıktan sonra değiştirebilir mi?

Yalnızca OAuth izni gerekli yazma kapsamını içeriyorsa ve kullanıcı belirli değişikliği açıkça onaylıyorsa. Salt okunur analiz izinleri web sitesi oluşturamaz, ayarları değiştiremez, erişilebilirlik monitörlerini düzenleyemez, uyarıları güncelleyemez veya sohbet yanıtı gönderemez.

ChatGPT veya Claude AI'yi bağlayabilir miyim?

Evet. Claude kullanıcıları Hitsteps Web Analytics'i Claude Connector Directory üzerinden yükleyebilir. ChatGPT dizin kaydı yakında geliyor; o zamana kadar şu adresi ChatGPT'ye özel MCP sunucusu olarak elle ekleyin: https://www.hitsteps.com/mcp/ Ardından Hitsteps OAuth akışını tamamlayın.

Hitsteps denemem, lisansım veya planım erişimi kısıtlarsa ne olur?

Sunucu, hassas olmayan hesap durumu ve kullanıcının kontrol edebileceği, yenileyebileceği veya yükseltebileceği bir Hitsteps URL'si içeren yapılandırılmış bir license_action_required yanıtı döndürür. Asistanın sorunu açıklayabilmesi için bağlantı bilgileri, site listesi ve hesap durumu kullanılabilir durumda kalır.

Hitsteps yapay zeka istemlerimi saklıyor mu?

MCP kullanım telemetrisi özellikle asgari verilerle sınırlandırılmıştır. Genel OAuth istemci kimliği, normalleştirilmiş AI istemci kanalı, araç adı, durum, süre, kimlik bilgisi türü, hesap veya site ve zaman damgası gibi operasyonel alanları kaydeder. İstemleri, araç argümanlarını, model belirteçlerini, ham user-agent bilgilerini, sonuç satırlarını veya tam hata metinlerini saklamaz.

Kurulumdan sonra

AI asistanları Hitsteps ile neler yapabilir?

Güncel Hitsteps verilerinden trafik genel görünümleri, kaynak dökümleri, en iyi sayfalar, kampanyalar, gerçek zamanlı ziyaretçiler, izleme durumu ve yönetici özetleri isteyin.
Work with Hitsteps-native operations such as website setup, goals, Segments and Triggers, uptime contacts and monitors, per-user alerts, Mentions query management, and authorized chat workflows.
Erişimi OAuth kapsamları, hesap izinleri, plan sınırları, onay istemleri ve gizliliği gözeten sonuç biçimleriyle sınırlı tutun.
Hitsteps özelliklerini görün Neden Hitsteps