خادم MCP

يشغّل حاضر شات خادم MCP (بروتوكول Model Context Protocol)، لتجيب تطبيقات الذكاء الاصطناعي مثل Claude وChatGPT وCursor عن أسئلة من بيانات مساحة عملك. يقدّم الأدوات نفسها التي يستخدمها مساعد حاضر، وكلها للقراءة فقط؛ لا تستطيع أي منها أن ترسل أو تعدّل أو تحذف شيئاً. يعمل إذا كان مساعد حاضر وربط MCP مفعّلين في مساحة عملك.

الخادم

• الرابط: https://app.hadir.chat/mcp
• طريقة الاتصال: Streamable HTTP، رسالة JSON-RPC 2.0 واحدة في كل طلب POST، والرد JSON. الطرق المتاحة: initialize وping وtools/list وtools/call.
• رد كل أداة يبدأ باسم مساحة العمل ومنطقتها الزمنية، ثم النتيجة بلغة المستخدم، ثم البيانات نفسها بصيغة JSON (وفي structuredContent أيضاً).

طريقتان للدخول

OAuth (لـ Claude وChatGPT)

أعطِ التطبيق الرابط فقط. يعلن الخادم طريقة الدخول عبر /.well-known/oauth-protected-resource و/.well-known/oauth-authorization-server، والتطبيقات تسجّل نفسها تلقائياً. بعدها يسجّل الشخص دخوله إلى حاضر شات في المتصفح نفسه، فتظهر له صفحة ربط تطبيق بمساعد حاضر، يختار فيها تحت ما يمكن الوصول إليه ما يراه التطبيق، ويحدّد ينتهي بعد، ثم يضغط الموافقة والربط. رموز الوصول صالحة ساعة وتتجدد تلقائياً. الخطوات لكل تطبيق في ربط حاضر بـ Claude وChatGPT.

بمفتاح (واجهة Claude البرمجية وCursor وغيرها)

1. بصفتك مديراً، افتح الإعدادات ثم خيارات الربط ثم بطاقة MCP (Claude وChatGPT).
2. اضغط إضافة اتصال MCP جديد. املأ اسم الاتصال والتطبيق وما يمكن الوصول إليه وينتهي بعد (30 يوماً أو 90 يوماً أو لا ينتهي)، ثم اضغط إنشاء الاتصال.
3. انسخ المفتاح، ويبدأ بـ hdr_mcp_. تستطيع عرضه لاحقاً من عرض المفتاح بعد تأكيد كلمة المرور.

أرسل المفتاح كرمز Bearer:

curl https://app.hadir.chat/mcp \
  -H "Authorization: Bearer hdr_mcp_…" -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

مع واجهة Claude البرمجية ضع الرابط في mcp_servers والمفتاح في authorization_token.

ماذا يرى الاتصال؟

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

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

الأدوات

الصلاحية بين قوسين. بعضها يحتاج أيضاً الميزة نفسها في باقتك، مثل الصفقات أو المواعيد أو متجر مربوط.

• account_info (الملخص): باقة مساحة العمل وحدودها وقنواتها وتكاملاتها وميزاتها وساعات العمل.
• account_summary (الملخص): المحادثات الجديدة والمحلولة، وأول رد، والمفتوحة والمنتظرة، لفترة.
• compare_periods (الملخص): فترتان جنباً إلى جنب مع مقدار التغيّر.
• unanswered_conversations (المحادثات): المحادثات المفتوحة بانتظار الرد، الأقدم أولاً.
• sla_status (المحادثات): المحادثات المتجاوزة لهدف الخدمة أو القريبة منه بـ 30 دقيقة.
• search_conversations (المحادثات): البحث عن محادثة بالاسم أو الجوال أو رقم المحادثة.
• conversation_transcript (المحادثات): آخر 30 رسالة في محادثة.
• agent_summary (أداء الفريق): أرقام موظف لفترة.
• team_ranking (أداء الفريق): ترتيب الموظفين حسب رقم واحد.
• available_now (أداء الفريق): المتصلون الآن ومحادثاتهم المفتوحة.
• contact_search (العملاء): البحث عن عميل بالاسم أو الجوال أو البريد.
• customer_360 (العملاء): محادثات العميل وصفقاته ومهامه ومواعيده ورضاه وطلباته.
• deals (المبيعات والطلبات): الصفقات حسب الحالة أو المسؤول أو المرحلة.
• deal_details (المبيعات والطلبات): صفقة واحدة مع مهامها المفتوحة.
• tasks (المبيعات والطلبات): المهام المستحقة اليوم أو المتأخرة.
• appointments (المواعيد): المواعيد في فترة.
• appointment_types (المواعيد): أنواع المواعيد.
• free_slots (المواعيد): الأوقات المتاحة حتى 14 يوماً.
• order_lookup (المتجر): آخر طلبات عميل في المتجر.
• orders_summary (المتجر): الطلبات الجديدة في فترة لكل متجر.
• campaigns (الحملات): حملات واتساب حسب حالتها.
• campaign_results (الحملات): وصول حملة والردود عليها وإلغاءات الاشتراك.
• journey_results (الحملات): نتائج الرسائل التلقائية لـ 7 أو 30 أو 90 يوماً.
• csat_summary (الجودة والتشغيل): رضا العملاء لفترة.
• whatsapp_health (الجودة والتشغيل): جودة كل رقم واتساب وحدّه اليومي.
• service_meter (الجودة والتشغيل): رسائل خدمة واتساب هذا الشهر.
• hadir_ai_usage (الجودة والتشغيل): ردود حاضر AI هذا الشهر والمسموح منها.

ملاحظة: المفتاح يعمل باسم من أنشأه. أعطِ كل تطبيق اتصالاً خاصاً به بأقل صلاحيات يحتاجها، واضغط إلغاء الاتصال على ما لم تعد تستخدمه.