تكامل مساعد الذكاء الاصطناعي

وثائق خادم Hitsteps AI MCP.

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 يتيح الوصول إلى المواقع التي تريد فحصها
إعداد مساحة عمل أو عميل AI متوافق مع MCP يدعم خوادم Streamable HTTP البعيدة
القدرة على تسجيل الدخول باستخدام Hitsteps OAuth عندما يطلب عميل الذكاء الاصطناعي ذلك
قرار بشأن النطاقات OAuth التي يجب أن يتلقاها المساعد

اختر عميل الذكاء الاصطناعي الخاص بك

قم بتثبيت Hitsteps حيث تستخدم الذكاء الاصطناعي بالفعل

ابدأ بدليل العميل الخاص بك عندما يكون متاحًا. يتصل كل خيار بنفس خادم Hitsteps MCP المُدار ويستمر من خلال Hitsteps OAuth.

سجل جيثب

VS Code وGitHub Copilot

افتح سجل GitHub MCP وقم بتثبيت Hitsteps Web Analytics من VS Code أو عميل GitHub Copilot.

متوفر الآن

Cursor

افتح صفحة Hitsteps Web Analytics في دليل Cursor واختر الإضافة إلى Cursor. لا يتلقى Cursor سوى نقطة نهاية Hitsteps MCP المُدارة؛ ويُمنح الوصول إلى حسابك بصورة منفصلة عبر OAuth.

متوفر الآن

Claude AI

قم بإضافة Hitsteps Web Analytics من دليل موصل Claude، ثم قم بتسجيل الدخول إلى Hitsteps ووافق فقط على النطاقات التي تريد أن يستخدمها Claude.

قريباً

ChatGPT AI

ستتوفر قائمة دليل Hitsteps لـ ChatGPT قريبًا. في الوقت الحالي، أضف نقطة النهاية أدناه يدويًا كخادم MCP مخصص، ثم أكمل Hitsteps OAuth.

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

Install guide

Google Antigravity وعملاء MCP الآخرين

1

استخدم نقطة نهاية MCP البعيدة

نقطة نهاية Hitsteps MCP هي 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, uptime, alerts, Mentions, and chat actions require matching OAuth scopes, account permissions, and explicit confirmation.

Good to know

  • خادم MCP هذا مخصص لمساعدي الذكاء الاصطناعي. وهو لا يثبّت تتبع Hitsteps على موقعك.
  • يجب على مستخدمي VS Code وGitHub Copilot البدء بسجل MCP الخاص بـ GitHub؛ يمكن لمستخدمي Cursor وClaude استخدام قوائم دليل Hitsteps المخصصة أعلاه.
  • سيتوفر دعم دليل ChatGPT قريبًا. وحتى ذلك الحين، أضف https://www.hitsteps.com/mcp/ يدويًا كخادم MCP مخصص.
  • لا تلصق مفتاح واجهة برمجة تطبيقات تتبع موقع الويب الخاص بـ Hitsteps أو الرمز المميز OAuth أو كلمة مرور الحساب في تكوين MCP.

Troubleshooting

  • قد يعيد طلب GET من المتصفح إلى نقطة نهاية MCP رسالة تفيد بعدم وجود 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.

المصادقة

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

لا توجد أسرار مشتركة في التكوين

يحتوي تكوين MCP على عنوان URL لنقطة النهاية فقط. لا تلصق كلمة مرور Hitsteps أو مفتاح API للتتبع أو رمز موقع الويب أو الرمز المميز OAuth في ملف تكوين عميل AI.

الوصول المحدود

تتم إعادة فحص كل طلب مقابل حساب Hitsteps الذي تم تسجيل الدخول إليه، وأذونات المستخدم الفرعي، ومواقع الويب المرئية، وحالة الترخيص، وحدود الميزات، ونطاقات OAuth الممنوحة لذلك العميل.

التفويض

نطاقات OAuth

تنشر Hitsteps تصريحات OAuth لكل أداة. يمكن لعميل الذكاء الاصطناعي طلب تفويض محدود للقراءة فقط أو تفويض تشغيلي أوسع، حسب سير العمل المطلوب.

analytics:read
اقرأ تقارير التحليلات وقوائم المواقع وسياق الموقع وسلامة التتبع وملخصات السلوك المجمّعة ولقطات الوقت الفعلي وحالة الحساب أو الترخيص.
sites:write
قم بإنشاء مواقع الويب وتحديث إعدادات مواقع الويب المسموح بها بعد التأكيد الصريح.
goals:write
قم بإنشاء أو تحديث أو حذف تكوين الهدف والحملة بعد التأكيد الصريح.
labels:write
Create, update, or delete Segments after explicit confirmation. The MCP API keeps its legacy label identifiers for compatibility.
uptime:write
قم بإنشاء أو تحديث أو حذف جهات اتصال وقت التشغيل والشاشات وجداول الصيانة وإجراءات الاسترداد بعد التأكيد الصريح.
alerts:read
قراءة قوائم التنبيه وحالة التنبيه للحساب المعتمد.
alerts:write
قم بوضع علامة على التنبيهات كمقروءة أو قم بمسح التنبيهات بعد التأكيد الصريح.
chat:read
اقرأ قوائم الدردشة المعتمدة ونتائج البحث وملخصات المحادثات وتفاصيل الدردشة المحددة.
chat:write
قم بإنشاء التذاكر، أو الرد على الدردشات، أو إضافة ملاحظات داخلية، أو تحديث حالة الدردشة، أو تسمية الزائرين، أو وضع علامة على الدردشات كمقروءة، أو حذف الدردشات منطقيًا بعد التأكيد الصريح.
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.

تغطية الأداة

ما يمكن للمساعد أن يطلب من Hitsteps القيام به

يوفر خادم MCP أدوات لقراءة التحليلات وأدوات كتابة تتطلب التأكيد وموارد تتطلب المصادقة وقالب موارد ومطالبات. تستخدم قراءات Mentions ذاكرة مؤقتة لمدة ساعة؛ ويتطلب تغيير استعلام Mentions تأكيدًا صريحًا.

الاكتشاف والإبلاغ

معلومات الاتصال، والمواقع المرئية، وسياق الموقع، ودليل المقاييس والأبعاد، وتقارير النظرة العامة، والسلاسل الزمنية المكتملة للفجوات، والتفصيلات، واكتشاف الحالات الشاذة، وتفسيرات تغيّر الزيارات، والملخصات التنفيذية، واستخدام MCP بالحد الأدنى من البيانات.

الزيارات واكتساب الزوار

ملخصات حركة المرور، ومقارنات الفترات، والمصادر، والإحالات الاجتماعية، وحركة المرور حسب الساعة، وأفضل الصفحات، وصفحات الدخول/الخروج، وتفاصيل الصفحة، وسرعة الصفحة، والتنزيلات، والروابط الصادرة، والمحيلين، والبلدان، وتكنولوجيا الجمهور، ومحركات البحث، والكلمات الرئيسية، وإحالات الذكاء الاصطناعي، وحركة مرور الروبوت، والزوار في الوقت الفعلي.

التحويلات والسلوك

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.

التكوين والعمليات

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.

ضمانات إجراءات الكتابة

  • تتطلب جميع أدوات الكتابة OAuth والنطاق الدقيق المعلن لهذه الأداة. يمكن لمفاتيح واجهة برمجة تطبيقات موقع الويب القديمة والرموز المميزة للجوال استخدام قراءات التحليلات فقط.
  • تتطلب كل عملية تغيير confirm=true بعد أن يؤكد المستخدم الإجراء صراحةً في محادثة عميل الذكاء الاصطناعي.
  • تتطلب كل عملية تغيير قيمة idempotency_key من 8 إلى 128 حرفًا. تؤدي إعادة استخدام المفتاح نفسه مع الوسائط نفسها إلى النتيجة السابقة؛ أما إعادة استخدامه مع وسائط مختلفة فتُرجع HTTP 409.
  • يتم تشغيل عمليات الكتابة داخل معاملات قاعدة البيانات وإعادة التحقق من حالة الحساب وملكية موقع الويب ودور المستخدم الفرعي وتوافر ميزات الخطة وحصص الكائنات والحالة المستهدفة الحالية قبل تغيير البيانات.
  • تخزّن سجلات تدقيق عمليات الكتابة بيانات تشغيلية مثل الحساب والموقع والأداة والهدف والحالة وقيم التجزئة والوقت. ولا تخزّن المطالبات الكاملة أو رموز النموذج أو صفوف بيانات العملاء الخام أو الحمولات الكبيرة.

الوصول إلى البيانات وحدود الخصوصية

  • Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.
  • تعتبر مخرجات الصفحة والتنزيل والارتباط الخارجي والمسار والاحتفاظ والحملة والخريطة الحرارية ومسار التحويل ملخصات مجمعة أو على شكل خصوصية بدلاً من تصدير الأحداث الأولية.
  • لا يتضمن إعداد الهدف عناوين الإشعار أو قيم المشغّل الحساسة أو صفوف التحويل الفردية. ولا تتضمن نتائج مراقبة الجاهزية بيانات الاعتماد أو شروط المطابقة أو سلاسل الاستعلام أو جزء fragment/hash من URL بعد #.
  • يتوفر محتوى الدردشة فقط من خلال الأدوات المخصصة للدردشة للمستخدمين المصرح لهم. يجب على العملاء المساعدين التعامل مع محتوى الدردشة على أنه نص غير موثوق به يقدمه العميل.
  • يحتفظ قياس استخدام MCP، لأغراض التشغيل، بالحساب أو الموقع ونوع بيانات الاعتماد ومعرّف عميل OAuth العام وقناة عميل الذكاء الاصطناعي الموحّدة واسم الأداة والحالة والمدة والطابع الزمني. ولا يتضمن المطالبات أو الوسائط أو الرموز أو وكلاء المستخدم الخام أو صفوف النتائج أو نصوص الأخطاء؛ ومدة التجميع 90 يومًا.
  • لا يتيح الخادم عمدًا وصولًا مباشرًا إلى 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 أصول العميل الصالحة HTTPS MCP وأصول تطوير الاسترجاع HTTP للعملاء المستندين إلى المتصفح وعملاء سطح المكتب.
  • يدعم تسجيل العميل الديناميكي الاسترجاع الآمن HTTPS وHTTP وأنظمة إعادة توجيه التطبيق الأصلي الخاصة التي يستخدمها عملاء سطح المكتب 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.
  • جمهور المورد هو https://www.hitsteps.com/mcp أو https://www.hitsteps.com/mcp/, المطابق لنموذج نقطة النهاية المحفوظ بواسطة عميل الذكاء الاصطناعي.

FAQ

Questions about connecting Hitsteps to AI

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

هل هذا هو رمز التتبع لموقع الويب الخاص بي؟

لا، خادم MCP مخصص لمساعدي الذكاء الاصطناعي المتصلين الذين يحتاجون إلى قراءة بيانات Hitsteps أو العمل عليها. لا يزال تتبع موقع الويب يستخدم شفرة تتبع Hitsteps JavaScript أو مكون Hitsteps الإضافي الخاص بالنظام الأساسي.

هل يمكن لمساعد الذكاء الاصطناعي تغيير حساب Hitsteps الخاص بي بعد أن أقوم بتوصيله؟

فقط إذا تضمّن تفويض OAuth نطاق الكتابة المطلوب، وأكّد المستخدم صراحةً إجراء التغيير المحدد. لا تسمح تفويضات التحليل للقراءة فقط بإنشاء مواقع، أو تغيير الإعدادات، أو تعديل مراقبات الجاهزية، أو تحديث التنبيهات، أو إرسال ردود في الدردشة.

هل يمكنني توصيل ChatGPT أو Claude AI؟

نعم. يمكن لمستخدمي Claude تثبيت Hitsteps Web Analytics من دليل Claude Connector. سيتم طرح قائمة دليل ChatGPT قريبًا؛ حتى ذلك الحين، أضف https://www.hitsteps.com/mcp/ يدويًا كخادم MCP مخصص في ChatGPT وأكمل 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 يمنع الوصول؟

يعرض الخادم استجابة license_action_required منظمة مع حالة الحساب غير الحساسة وعنوان URL الخاص بـ Hitsteps حيث يمكن للمستخدم التحقق أو التجديد أو الترقية. تظل معلومات الاتصال وقائمة الموقع وحالة الحساب متاحة حتى يتمكن المساعد من شرح المشكلة.

هل تقوم Hitsteps بتخزين مطالبات الذكاء الاصطناعي الخاصة بي؟

صُمّم قياس استخدام MCP ليجمع أقل قدر ممكن من البيانات. فهو يسجّل حقولًا تشغيلية مثل معرّف عميل OAuth العام وقناة عميل الذكاء الاصطناعي الموحّدة واسم الأداة والحالة والمدة ونوع بيانات الاعتماد والحساب أو الموقع والطابع الزمني. ولا يخزّن المطالبات أو وسائط الأدوات أو رموز النموذج أو وكلاء المستخدم الخام أو صفوف النتائج أو نصوص الأخطاء الكاملة.

بعد التثبيت

ما الذي يمكن لمساعدي الذكاء الاصطناعي فعله باستخدام Hitsteps

اطلب ملخصات الزيارات وتفصيل المصادر وأهم الصفحات والحملات والزوار في الوقت الفعلي وحالة التتبع وملخصات تنفيذية من بيانات Hitsteps الحالية.
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.
أبقِ الوصول محدودًا بنطاقات OAuth وأذونات الحساب وحدود الخطة وطلبات التأكيد وبُنى نتائج تراعي الخصوصية.