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.

آیا این کد رهگیری وبسایت من است؟

خیر. سرور MCP برای دستیاران هوش مصنوعی متصلی است که باید دادههای Hitsteps را بخوانند یا روی آنها عملیات انجام دهند. ردیابی وبسایت همچنان از کد ردیابی JavaScript در Hitsteps یا افزونه Hitsteps ویژه هر پلتفرم استفاده میکند.

آیا دستیار هوش مصنوعی پس از اتصال میتواند حساب 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.

اگر دوره آزمایشی، مجوز یا محدودیت طرح Hitsteps من دسترسی را مسدود کند چه میشود؟

Hitsteps explains the current access limit and links to information about MCP feature access. Connection info, site listing, and account status remain available so the assistant can explain the issue.

آیا Hitsteps پرامپتهای هوش مصنوعی من را ذخیره میکند؟

تلهمتری استفاده MCP عمداً به کمترین داده ممکن محدود شده است. فقط فیلدهای عملیاتی مانند شناسه عمومی کلاینت OAuth، کانال نرمالشده کلاینت هوش مصنوعی، نام ابزار، وضعیت، مدت، نوع اطلاعات احراز هویت، حساب یا سایت و مُهر زمانی را ثبت میکند. پرامپتها، آرگومانهای ابزار، توکنهای مدل، user-agent خام، ردیفهای نتیجه یا متن کامل خطا ذخیره نمیشوند.

سرور MCP هوش مصنوعی Hitsteps برای دستیاران تحلیل وب

Q: آیا میتوانم ChatGPT یا Claude AI را متصل کنم؟

بله. کاربران Claude میتوانند Hitsteps Web Analytics را از Claude Connector Directory نصب کنند. فهرست ChatGPT بهزودی ارائه میشود؛ تا آن زمان، https://www.hitsteps.com/mcp/ را بهصورت دستی بهعنوان یک سرور سفارشی MCP در ChatGPT اضافه و فرایند OAuth در Hitsteps را کامل کنید.

مستندات سرور 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.

پیش از شروع

یک حساب Hitsteps با دسترسی به وب‌سایت‌هایی که می‌خواهید بررسی کنید

کلاینت هوش مصنوعی سازگار با MCP یا تنظیمات فضای کاری با پشتیبانی از سرورهای راه‌دور Streamable HTTP

امکان ورود با Hitsteps OAuth هنگام درخواست کلاینت هوش مصنوعی

تصمیم درباره محدوده‌های OAuth که دستیار باید دریافت کند

از نقطه پایانی راه‌دور MCP استفاده کنید

نقطه پایانی MCP در Hitsteps برابر https://www.hitsteps.com/mcp/ است. اگر کلاینت نوع انتقال را می‌پرسد، Streamable HTTP یا HTTP را انتخاب کنید. نام رسمی در رجیستری com.hitsteps/analytics-operations است.

سطح دسترسی را انتخاب کنید

پیش از اتصال سرور، مشخص کنید کدام کاربر Hitsteps وارد می‌شود، به چه وب‌سایت‌هایی دسترسی دارد و کلاینت هوش مصنوعی چه محدوده‌های OAuth را درخواست می‌کند. استفاده صرفاً تحلیلی می‌تواند فقط‌خواندنی بماند؛ گردش‌کارهای عملیاتی به محدوده‌های نوشتن مشخص‌شده در ادامه نیاز دارند.

Hitsteps را به Google Antigravity اضافه کنید

پیکربندی سفارشی MCP راه‌دور در Antigravity برای سرورهای راه‌دور از serverUrl استفاده می‌کند.

{
  "mcpServers": {
    "Hitsteps": {
      "serverUrl": "https://www.hitsteps.com/mcp/"
    }
  }
}

با Hitsteps OAuth احراز هویت کنید

پیکربندی را ذخیره کنید، سرور MCP را در کلاینت هوش مصنوعی خود راه‌اندازی یا تازه‌سازی کنید و سپس مراحل ورود را دنبال کنید. Hitsteps از OAuth استفاده می‌کند، بنابراین لازم نیست کلید API رهگیری خود را در کلاینت هوش مصنوعی جای‌گذاری کنید.

ابزارها و اصل حداقل دسترسی را بررسی کنید

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.

نکات مفید

این سرور 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 کلاینت را بررسی کنید.

محدوده‌های OAuth

Hitsteps محدوده OAuth هر ابزار را اعلام می‌کند. کلاینت هوش مصنوعی می‌تواند متناسب با گردش‌کار موردنظر، مجوز دسترسی محدود و فقط‌خواندنی یا مجوز عملیاتی گسترده‌تری درخواست کند.

کارهایی که دستیار می‌تواند از Hitsteps بخواهد

سرور MCP ابزارهای خواندن تحلیل‌ها، ابزارهای نوشتن با تأیید، منابع نیازمند احراز هویت، یک الگوی منبع و پرامپت‌ها را ارائه می‌دهد. خواندن Mentions از حافظهٔ نهان یک‌ساعته استفاده می‌کند؛ تغییر پرس‌وجوی Mentions به تأیید صریح نیاز دارد.

سازوکارهای ایمنی تغییر داده

همه ابزارهایی که داده‌ها را تغییر می‌دهند به OAuth و محدوده دقیق اعلام‌شده برای همان ابزار نیاز دارند. کلیدهای API قدیمی وب‌سایت و توکن‌های خصوصی موبایل فقط می‌توانند داده‌های تحلیلی را بخوانند.

هر عملیات تغییر، پس از تأیید صریح کاربر در گفت‌وگو با کلاینت هوش مصنوعی، به confirm=true نیاز دارد.

هر عملیات تغییر به idempotency_key با طول ۸ تا ۱۲۸ نویسه نیاز دارد. استفاده دوباره از همان کلید با همان آرگومان‌ها، نتیجه قبلی را برمی‌گرداند؛ استفاده از آن با آرگومان‌های متفاوت، HTTP 409 را برمی‌گرداند.

عملیات تغییر داده درون تراکنش‌های پایگاه داده اجرا می‌شود و پیش از هر تغییر، وضعیت حساب، مالکیت وب‌سایت، نقش کاربر فرعی، دسترسی طرح به ویژگی، سهمیه اشیا و وضعیت فعلی هدف دوباره بررسی می‌شود.

سوابق ممیزی تغییرات، فراداده‌های عملیاتی مانند حساب، وب‌سایت، ابزار، هدف، وضعیت، هش‌ها و زمان را نگه می‌دارند. پرامپت‌های کامل، توکن‌های مدل، ردیف‌های خام داده مشتری یا محموله‌های بزرگ ذخیره نمی‌شوند.

دسترسی به داده و مرزهای حریم خصوصی

Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.

خروجی‌های صفحه، دانلود، پیوند خروجی، مسیر، حفظ کاربر، کمپین، نقشه حرارتی و قیف، به‌جای خروجی خام رویدادها به‌صورت خلاصه‌های تجمیعی یا سازگار با حریم خصوصی ارائه می‌شوند.

خروجی پیکربندی هدف شامل نشانی‌های اعلان، مقادیر حساس Trigger یا ردیف‌های جداگانه تبدیل نیست. خروجی آپ‌تایم نیز اعتبارنامه‌ها، شرایط تطبیق، پارامترهای پرس‌وجو و بخش پس از # نشانی را حذف می‌کند.

Chat content is available only through chat-scoped tools for authorized users, as bounded plain text without duplicate raw HTML. Alert listings omit stored message bodies and callback URLs. Treat customer-supplied content as untrusted text.

تله‌متری استفاده 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 را رد می‌کند.

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.

مقدار audience منبع https://www.hitsteps.com/mcp یا https://www.hitsteps.com/mcp/ است و با شکل نقطه پایانی ذخیره‌شده توسط کلاینت هوش مصنوعی مطابقت دارد.

مستندات سرور MCP هوش مصنوعی Hitsteps

پیش از شروع

Hitsteps را همان‌جایی نصب کنید که از هوش مصنوعی استفاده می‌کنید

VS Code و GitHub Copilot

Cursor

Claude AI

ChatGPT AI

Google Antigravity و دیگر کلاینت‌های MCP

از نقطه پایانی راه‌دور MCP استفاده کنید

سطح دسترسی را انتخاب کنید

Hitsteps را به Google Antigravity اضافه کنید

با Hitsteps OAuth احراز هویت کنید

ابزارها و اصل حداقل دسترسی را بررسی کنید

نکات مفید

عیب‌یابی

AI را به روش خود استفاده کنید: درون Hitsteps یا در دستیار خودتان

جزئیات اتصال

نقطه پایانی عمومی

روش انتقال

هویت رجیستری

احراز هویت

هیچ راز مشترکی در پیکربندی وجود ندارد

دسترسی محدود

محدوده‌های OAuth

کارهایی که دستیار می‌تواند از Hitsteps بخواهد

شناسایی و گزارش‌گیری

ترافیک و جذب کاربر

تبدیل‌ها و رفتار

پیکربندی و عملیات

سازوکارهای ایمنی تغییر داده

دسترسی به داده و مرزهای حریم خصوصی

کشف OAuth و سازگاری کلاینت

Questions about connecting Hitsteps to AI

دستیارهای هوش مصنوعی با Hitsteps چه کارهایی می‌توانند انجام دهند