رجیستری GitHub
VS Code و GitHub Copilot
رجیستری MCP در GitHub را باز کنید و Hitsteps Web Analytics را از کلاینت VS Code یا GitHub Copilot خود نصب کنید.
یکپارچهسازی با دستیار هوش مصنوعی
مستندات سرور MCP هوش مصنوعی Hitsteps
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 راهدور با OAuth پیش از شروع
یک حساب Hitsteps با دسترسی به وبسایتهایی که میخواهید بررسی کنید
کلاینت هوش مصنوعی سازگار با MCP یا تنظیمات فضای کاری با پشتیبانی از سرورهای راهدور Streamable HTTP
امکان ورود با Hitsteps OAuth هنگام درخواست کلاینت هوش مصنوعی
تصمیم درباره محدودههای OAuth که دستیار باید دریافت کند
کلاینت هوش مصنوعی خود را انتخاب کنید
Hitsteps را همانجایی نصب کنید که از هوش مصنوعی استفاده میکنید
اگر فهرست کلاینت شما در دسترس است، از همانجا شروع کنید. همه گزینهها به سرور مدیریتشده Hitsteps MCP متصل میشوند و سپس جریان Hitsteps OAuth را ادامه میدهند.
هماکنون در دسترس
Cursor
صفحه Hitsteps Web Analytics را در Cursor Directory باز کنید و افزودن به Cursor را انتخاب کنید. Cursor فقط نقطه پایانی مدیریتشده Hitsteps MCP را دریافت میکند؛ دسترسی به حساب شما جداگانه از طریق OAuth داده میشود.
هماکنون در دسترس
Claude AI
Hitsteps Web Analytics را از Connector Directory متعلق به Claude اضافه کنید، سپس وارد Hitsteps شوید و فقط محدودههایی را تأیید کنید که میخواهید Claude استفاده کند.
بهزودی
ChatGPT AI
فهرست Hitsteps برای ChatGPT بهزودی ارائه میشود. فعلاً نقطه پایانی زیر را بهصورت دستی بهعنوان یک سرور سفارشی MCP اضافه کنید و سپس فرایند OAuth در Hitsteps را کامل کنید.
https://www.hitsteps.com/mcp/
راهنمای نصب
Google Antigravity و دیگر کلاینتهای MCP
1
از نقطه پایانی راهدور MCP استفاده کنید
نقطه پایانی MCP در Hitsteps برابر https://www.hitsteps.com/mcp/ است. اگر کلاینت نوع انتقال را میپرسد، Streamable HTTP یا HTTP را انتخاب کنید. نام رسمی در رجیستری com.hitsteps/analytics-operations است.
2
سطح دسترسی را انتخاب کنید
پیش از اتصال سرور، مشخص کنید کدام کاربر Hitsteps وارد میشود، به چه وبسایتهایی دسترسی دارد و کلاینت هوش مصنوعی چه محدودههای OAuth را درخواست میکند. استفاده صرفاً تحلیلی میتواند فقطخواندنی بماند؛ گردشکارهای عملیاتی به محدودههای نوشتن مشخصشده در ادامه نیاز دارند.
3
Hitsteps را به Google Antigravity اضافه کنید
پیکربندی سفارشی MCP راهدور در Antigravity برای سرورهای راهدور از serverUrl استفاده میکند.
4
با Hitsteps OAuth احراز هویت کنید
پیکربندی را ذخیره کنید، سرور MCP را در کلاینت هوش مصنوعی خود راهاندازی یا تازهسازی کنید و سپس مراحل ورود را دنبال کنید. Hitsteps از OAuth استفاده میکند، بنابراین لازم نیست کلید API رهگیری خود را در کلاینت هوش مصنوعی جایگذاری کنید.
5
ابزارها و اصل حداقل دسترسی را بررسی کنید
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.
نکات مفید
- این سرور MCP برای دستیارهای هوش مصنوعی است و رهگیری Hitsteps را روی وبسایت شما نصب نمیکند.
- کاربران VS Code و GitHub Copilot باید از MCP Registry در GitHub شروع کنند؛ کاربران Cursor و Claude میتوانند از صفحههای اختصاصی Hitsteps در فهرستهای بالا استفاده کنند.
- پشتیبانی از فهرست ChatGPT بهزودی ارائه میشود. تا آن زمان، https://www.hitsteps.com/mcp/ را بهصورت دستی بهعنوان یک سرور سفارشی MCP اضافه کنید.
- کلید API رهگیری وبسایت Hitsteps، توکن OAuth یا رمز عبور حساب خود را در پیکربندی MCP جایگذاری نکنید.
عیبیابی
- ممکن است درخواست GET مرورگر به نقطه پایانی MCP پیام no-SSE یا خطای روش را برگرداند. این رفتار عادی است؛ کلاینتهای MCP از طریق JSON-RPC روی HTTP متصل میشوند.
- پاسخ 401 پیش از ورود مورد انتظار است. کلاینت باید برای آغاز مجوزدهی از فراداده OAuth اعلامشده استفاده کند.
- اگر فهرست رسمی کلاینت، Hitsteps را نشان نمیدهد، فهرست را بازخوانی کنید و خطمشی سازمانی و تنظیمات MCP کلاینت را بررسی کنید.
Hitsteps AI درون پیشخوان شما
AI را به روش خود استفاده کنید: درون Hitsteps یا در دستیار خودتان
از Hitsteps AI درون پیشخوان استفاده کنید، یا Hitsteps MCP Plugin رایگان را برای تحلیل گفتوگومحور وب به دستیار AI سازگار خود متصل کنید.
امنیت و دسترسی
جزئیات اتصال
با این جزئیات Hitsteps را متصل کنید و ببینید دستیار هوش مصنوعی به چه بخشهایی از حساب شما دسترسی دارد.
نقطه پایانی عمومی
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.
روش انتقال
Hitsteps از Streamable HTTP راهدور با JSON-RPC استفاده میکند. نیازی به نصب بسته محلی Node.js، رابط دسکتاپ، پردازشگر SSE یا فرایند جداگانه میزبانیشده توسط مشتری نیست.
هویت رجیستری
نام رجیستری/سرور com.hitsteps/analytics-operations و عنوان نمایشدادهشده Hitsteps Analytics and Operations است.
احراز هویت
کلاینتهای عمومی هوش مصنوعی از Hitsteps OAuth با جریان کد مجوز و S256 PKCE استفاده میکنند. کاربر در Hitsteps وارد میشود و پیش از دریافت توکن توسط کلاینت، محدودههای درخواستی را میبیند.
هیچ راز مشترکی در پیکربندی وجود ندارد
پیکربندی MCP فقط حاوی URL نقطه پایانی است. رمز عبور Hitsteps، کلید API رهگیری، کد وبسایت یا توکن OAuth را در فایل پیکربندی کلاینت هوش مصنوعی قرار ندهید.
دسترسی محدود
هر درخواست دوباره با حساب واردشده Hitsteps، مجوزهای کاربر فرعی، وبسایتهای قابل مشاهده، وضعیت مجوز، محدودیتهای ویژگی و محدودههای OAuth اعطاشده به آن کلاینت بررسی میشود.
مجوزدهی
محدودههای OAuth
Hitsteps محدوده OAuth هر ابزار را اعلام میکند. کلاینت هوش مصنوعی میتواند متناسب با گردشکار موردنظر، مجوز دسترسی محدود و فقطخواندنی یا مجوز عملیاتی گستردهتری درخواست کند.
analytics:readگزارشهای تحلیلی، فهرست سایتها، زمینه سایت، سلامت رهگیری، خلاصههای تجمیعی رفتار، نماهای بلادرنگ و وضعیت حساب یا اشتراک را بخوانید.
sites:writeپس از تأیید صریح، وبسایت ایجاد کنید و تنظیمات مجاز آن را بهروزرسانی کنید.
goals:writeپس از تأیید صریح، پیکربندی هدف و کمپین را ایجاد، بهروزرسانی یا حذف کنید.
labels:writeCreate, update, or delete Triggers in Segments and Triggers after explicit confirmation. The MCP API keeps its legacy label identifiers for compatibility.
uptime:writeپس از تأیید صریح، مخاطبین و مانیتورهای آپتایم، برنامههای نگهداری و اقدامات بازیابی را ایجاد، بهروزرسانی یا حذف کنید.
alerts:readفهرست هشدارها و وضعیت آنها را برای حساب مجاز بخوانید.
alerts:writeپس از تأیید صریح، هشدارها را خواندهشده علامت بزنید یا پاک کنید.
chat:readفهرست چتهای مجاز، نتایج جستوجو، خلاصه گفتوگوها و جزئیات چت انتخابشده را بخوانید.
chat:writeپس از تأیید صریح، تیکت ایجاد کنید، به چتها پاسخ دهید، یادداشت داخلی بیفزایید، وضعیت چت را بهروزرسانی کنید، برای بازدیدکنندگان نام بگذارید، چتها را خواندهشده علامت بزنید یا آنها را بهصورت منطقی حذف کنید.
mentions:readRead active Mentions queries and combined Web Search/X results.
mentions:writeAdd, rename, or remove active Mentions keyword queries after explicit confirmation.
پوشش ابزار
کارهایی که دستیار میتواند از Hitsteps بخواهد
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.
شناسایی و گزارشگیری
اطلاعات اتصال، وبسایتهای قابل مشاهده، زمینه سایت، فهرست معیارها و ابعاد، گزارشهای کلی، سریهای زمانی تکمیلشده، تفکیکها، تشخیص ناهنجاری، توضیح تغییرات ترافیک، خلاصههای مدیریتی و دادههای حداقلی استفاده از MCP.
ترافیک و جذب کاربر
خلاصههای ترافیک، مقایسه دورهها، منابع، ارجاعهای اجتماعی، ترافیک بر حسب ساعت، صفحات برتر، صفحات ورودی/خروجی، جزئیات صفحه، سرعت صفحه، دانلودها، لینکهای خروجی، ارجاعدهندهها، کشورها، فناوری مخاطب، موتورهای جستجو، کلمات کلیدی، ارجاعات هوش مصنوعی، ترافیک ربات و بازدیدکنندگان بیدرنگ.
تبدیلها و رفتار
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.
پیکربندی و عملیات
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.
سازوکارهای ایمنی تغییر داده
- همه ابزارهایی که دادهها را تغییر میدهند به OAuth و محدوده دقیق اعلامشده برای همان ابزار نیاز دارند. کلیدهای API قدیمی وبسایت و توکنهای خصوصی موبایل فقط میتوانند دادههای تحلیلی را بخوانند.
- هر عملیات تغییر، پس از تأیید صریح کاربر در گفتوگو با کلاینت هوش مصنوعی، به confirm=true نیاز دارد.
- هر عملیات تغییر به idempotency_key با طول ۸ تا ۱۲۸ نویسه نیاز دارد. استفاده دوباره از همان کلید با همان آرگومانها، نتیجه قبلی را برمیگرداند؛ استفاده از آن با آرگومانهای متفاوت، HTTP 409 را برمیگرداند.
- عملیات تغییر داده درون تراکنشهای پایگاه داده اجرا میشود و پیش از هر تغییر، وضعیت حساب، مالکیت وبسایت، نقش کاربر فرعی، دسترسی طرح به ویژگی، سهمیه اشیا و وضعیت فعلی هدف دوباره بررسی میشود.
- سوابق ممیزی تغییرات، فرادادههای عملیاتی مانند حساب، وبسایت، ابزار، هدف، وضعیت، هشها و زمان را نگه میدارند. پرامپتهای کامل، توکنهای مدل، ردیفهای خام داده مشتری یا محمولههای بزرگ ذخیره نمیشوند.
دسترسی به داده و مرزهای حریم خصوصی
- Realtime visitor output omits raw IP addresses, visitor IDs, Trigger matches, keywords, URL query strings, and fragments.
- خروجیهای صفحه، دانلود، پیوند خروجی، مسیر، حفظ کاربر، کمپین، نقشه حرارتی و قیف، بهجای خروجی خام رویدادها بهصورت خلاصههای تجمیعی یا سازگار با حریم خصوصی ارائه میشوند.
- خروجی پیکربندی هدف شامل نشانیهای اعلان، مقادیر حساس Trigger یا ردیفهای جداگانه تبدیل نیست. خروجی آپتایم نیز اعتبارنامهها، شرایط تطبیق، پارامترهای پرسوجو و بخش پس از # نشانی را حذف میکند.
- محتوای چت فقط از طریق ابزارهای دارای محدوده چت و برای کاربران مجاز در دسترس است. کلاینتهای دستیار باید آن را متن نامطمئن ارسالی مشتری در نظر بگیرند.
- تلهمتری استفاده MCP برای دید عملیاتی، حساب یا سایت، نوع اطلاعات احراز هویت، شناسه عمومی کلاینت OAuth، کانال نرمالشده کلاینت هوش مصنوعی، نام ابزار، وضعیت، مدت و مُهر زمانی را نگه میدارد. پرامپتها، آرگومانها، توکنها، user-agent خام، ردیفهای نتیجه و متن خطا را دربر نمیگیرد؛ بازه تجمیع ۹۰ روز است.
- سرور عمداً دسترسی مستقیم به SQL، تغییرات صورتحساب یا رمز عبور، تغییرات پروفایل حساب، تغییرات 2FA، خروجی خام پروفایل بازدیدکنندگان، کلیدهای خصوصی، تغییر کلید API رهگیری، ویدیوی بازپخش نشست، گزارشهای کنسول JavaScript، ردگیری شبکه یا مدیریت آزمایشها را ارائه نمیکند.
کشف OAuth و سازگاری کلاینت
- فراداده منبع محافظتشده: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp
- فراداده سرور مجوز: https://www.hitsteps.com/.well-known/oauth-authorization-server
- نقطه پایانی MCP مبدأهای معتبر کلاینت MCP روی HTTPS و مبدأهای توسعه loopback روی HTTP را برای کلاینتهای مرورگر و دسکتاپ میپذیرد.
- ثبت پویای کلاینت از HTTPS امن، HTTP loopback و طرحوارههای خصوصی تغییرمسیر اپلیکیشنهای بومی که کلاینتهای دسکتاپ MCP استفاده میکنند پشتیبانی میکند و طرحوارههای ناامن مانند javascript:، data:، file:، blob: و websocket را رد میکند.
- مقدار audience منبع https://www.hitsteps.com/mcp یا https://www.hitsteps.com/mcp/ است و با شکل نقطه پایانی ذخیرهشده توسط کلاینت هوش مصنوعی مطابقت دارد.
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.
آیا این کد رهگیری وبسایت من است؟
خیر. سرور MCP برای دستیاران هوش مصنوعی متصلی است که باید دادههای Hitsteps را بخوانند یا روی آنها عملیات انجام دهند. ردیابی وبسایت همچنان از کد ردیابی JavaScript در Hitsteps یا افزونه Hitsteps ویژه هر پلتفرم استفاده میکند.
آیا دستیار هوش مصنوعی پس از اتصال میتواند حساب Hitsteps من را تغییر دهد؟
فقط اگر مجوز دسترسی OAuth شامل محدوده لازم برای نوشتن باشد و کاربر همان عملیات مشخص را صریحاً تأیید کند. مجوزهای تحلیل فقطخواندنی نمیتوانند وبسایت ایجاد کنند، تنظیمات را تغییر دهند، مانیتورهای آپتایم را ویرایش کنند، هشدارها را بهروزرسانی کنند یا پاسخ چت بفرستند.
آیا میتوانم ChatGPT یا Claude AI را متصل کنم؟
بله. کاربران Claude میتوانند Hitsteps Web Analytics را از Claude Connector Directory نصب کنند. فهرست ChatGPT بهزودی ارائه میشود؛ تا آن زمان، https://www.hitsteps.com/mcp/ را بهصورت دستی بهعنوان یک سرور سفارشی MCP در ChatGPT اضافه و فرایند OAuth در Hitsteps را کامل کنید.
اگر دوره آزمایشی، مجوز یا محدودیت طرح Hitsteps من دسترسی را مسدود کند چه میشود؟
سرور پاسخ ساختاریافته license_action_required را همراه با وضعیت غیرحساس حساب و نشانی Hitsteps برمیگرداند تا کاربر بتواند وضعیت را بررسی کند، اشتراک را تمدید کند یا ارتقا دهد. اطلاعات اتصال، فهرست سایتها و وضعیت حساب همچنان در دسترس میماند تا دستیار مشکل را توضیح دهد.
آیا Hitsteps پرامپتهای هوش مصنوعی من را ذخیره میکند؟
تلهمتری استفاده MCP عمداً به کمترین داده ممکن محدود شده است. فقط فیلدهای عملیاتی مانند شناسه عمومی کلاینت OAuth، کانال نرمالشده کلاینت هوش مصنوعی، نام ابزار، وضعیت، مدت، نوع اطلاعات احراز هویت، حساب یا سایت و مُهر زمانی را ثبت میکند. پرامپتها، آرگومانهای ابزار، توکنهای مدل، user-agent خام، ردیفهای نتیجه یا متن کامل خطا ذخیره نمیشوند.
پس از نصب
دستیارهای هوش مصنوعی با Hitsteps چه کارهایی میتوانند انجام دهند
نمای کلی ترافیک، تفکیک منابع، صفحههای برتر، کمپینها، بازدیدکنندگان بلادرنگ، سلامت رهگیری و خلاصههای مدیریتی را از دادههای فعلی Hitsteps درخواست کنید.
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.
دسترسی را با محدودههای OAuth، مجوزهای حساب، محدودیتهای طرح، درخواستهای تأیید و ساختار نتایج سازگار با حریم خصوصی محدود نگه دارید.