تكامل بروتوكول سياق النموذج (MCP)

بروتوكول سياق النموذج (Model Context Protocol - MCP) هو معيار مفتوح طورته شركة Anthropic يمكّن النماذج اللغوية الكبيرة (LLMs) وبيئات التطوير المدعومة بالذكاء الاصطناعي (مثل Cursor وWindsurf) والوكلاء المستقلين من التفاعل بأمان مع الأدوات الخارجية وقواعد البيانات وواجهات البرمجة التشغيلية.

توفر HashEntry خوادم MCP رسمية بتقنية Streamable-HTTP تتيح للمطورين ومسؤولي الامتثال أتمتة فحص ملفات تعريف الارتباط، وتكوين لافتات الموافقة، وصياغة سياسات الخصوصية، والاستعلام عن إحصاءات الامتثال لـ GDPR وقوانين حماية البيانات باللغة الطبيعية مباشرة.

---

البنية ومستويات الوصول

توفر HashEntry ثلاثة خوادم MCP مخصصة وفقاً لمستوى الأذونات والأمان المطلوب:

نقطة النهاية (Endpoint)	مستوى الوصول	المصادقة	الإمكانيات والوظائف
https://system.hashentry.com/mcp/public	عام (Public)	لا توجد (مجهول)	فحص فوري للمواقع، والبحث في مكتبة ملفات تعريف الارتباط، واستعراض الباقات وقاعدة المعرفة.
https://system.hashentry.com/mcp/tenant	العميل (Tenant)	رمز Bearer (he_mcp_...)	إدارة المواقع، وإطلاق تدقيق ملفات الارتباط، وتحديث مظهر اللافتة، وصياغة ونشر السياسات القانونية، ومتابعة إحصاءات الموافقة.
https://system.hashentry.com/mcp/reseller	الموزع (Reseller)	رمز Bearer (he_mcp_...)	إدارة محفظة عملاء الوكالة، والعمولات، والرصيد، وتذاكر دعم الشركاء.

---

المصادقة وإنشاء رمز MCP

بالنسبة لخوادم Tenant وReseller، يجب أن يتضمن كل طلب رمز وصول شخصي (he_mcp_...).

إنشاء الرموز عبر لوحة تحكم HashEntry

1. سجّل الدخول إلى لوحة تحكم HashEntry.
2. انتقل إلى الإعدادات → رموز الذكاء الاصطناعي و MCP.
3. انقر على إنشاء رمز MCP جديد، وحدد اسماً واضحاً وفترة الصلاحية.
4. انسخ المفتاح he_mcp_... المنشأ واحتفظ به في مكان آمن.

---

إعداد برامج الذكاء الاصطناعي

1. إعداد Cursor IDE

أنشئ أو حدّث الملف .cursor/mcp.json في المجلد الرئيسي لمشروعك:

{
  "mcpServers": {
    "hashentry-public": {
      "url": "https://system.hashentry.com/mcp/public"
    },
    "hashentry-tenant": {
      "url": "https://system.hashentry.com/mcp/tenant",
      "headers": {
        "Authorization": "Bearer he_mcp_ضع_رمزك_هنا"
      }
    }
  }
}

2. إعداد Claude Desktop

افتح ملف التكوين claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

أضف تكوين الخادم:

{
  "mcpServers": {
    "hashentry": {
      "url": "https://system.hashentry.com/mcp/tenant",
      "headers": {
        "Authorization": "Bearer he_mcp_ضع_رمزك_هنا"
      }
    }
  }
}

---

مرجع الأدوات المتاحة (Tools)

1. الأدوات العامة (/mcp/public)

متاحة بدون تسجيل دخول:

• start_cmp_scan: بدء فحص شامل لملفات تعريف الارتباط والامتثال لأي رابط ويب.
• get_cmp_scan_status: الاستعلام عن حالة تقدم الفحص الجاري في الخلفية.
• get_cmp_scan_report: جلب التقرير النهائي المصنف للملفات المكتشفة ونسبة الامتثال.
• search_cookie_definitions: البحث في قاعدة بيانات HashEntry العالمية عن تصنيف الملف ومزوده وفترة تخزينه.
• get_pricing_plans: استعراض خطط الاشتراك والحصص المتوفرة.
• search_knowledge_base: البحث في أدلة التوثيق الرسمية والأسئلة القانونية الشائعة.

2. أدوات العميل (/mcp/tenant)

تتطلب رمز عميل صالحاً:

• list_sites: عرض جميع المواقع المسجلة في حسابك.
• get_site: جلب بيانات وإعدادات ومفاتيح موقع معين.
• create_site: إضافة موقع ويب جديد إلى المنصة.
• trigger_site_cookie_scan: بدء فحص دوري لملفات الارتباط لموقع مسجل.
• list_site_cookies: سرد جميع ملفات الارتباط المكتشفة وتصنيفاتها.
• get_banner_config: استرداد ألوان ونصوص وأنماط لافتة الموافقة.
• update_banner_config: تحديث إعدادات مظهر وسلوك اللافتة.
• list_documents: استعراض الوثائق القانونية (سياسة ملفات الارتباط، إشعار الخصوصية).
• get_document: تحميل النص الكامل للسياسة القانونية.
• save_document_draft: حفظ المسودة أو التعديلات المصاغة بواسطة الذكاء الاصطناعي.
• publish_document: نشر الوثيقة القانونية المعتمدة برقم إصدار رسمي.
• get_consent_stats: تقرير نسب قبول ورفض الزوار لملفات الارتباط.
• list_tickets وcreate_ticket: مراجعة التذاكر وفتح طلبات دعم فني جديدة.
• get_quota_usage: متابعة استهلاك الحصص المتاحة (الفحوصات، المواقع، استدعاءات API).

3. أدوات الموزع (/mcp/reseller)

تتطلب صلاحية موزع شريك:

• get_reseller_dashboard: لوحة قيادة المؤشرات التجارية ورصيد العمولات والمدفوعات.
• list_reseller_tenants: قائمة بجميع المؤسسات التابعة لوكالتك.
• create_reseller_tenant: إنشاء مؤسسة عميل جديدة.
• list_commissions: كشف تفصيلي بحركات العمولات المستحقة.
• list_reseller_tickets & create_reseller_ticket: قناة دعم فني ذات أولوية للشركاء.