ما هو مساعد الذكاء الاصطناعي مع MCP
يربط MCP مساعد الذكاء الاصطناعي الخارجي بـ Luma Concierge. يمكن للمالك والمدير طرح أسئلة حول عمل الفندق والحصول على إجابات بناءً على البيانات الحالية للنظام. هذا اتصال منفصل للفريق؛ ولا يحتاجه الضيف للعمل مع التطبيق.
يعمل الخادم للقراءة فقط. يمكن للذكاء الاصطناعي اقتراح خطة عمل، لكن تعيين المنفذين وتغيير الحالات وإرسال الرسائل إلى الضيوف وعمليات الدفع تتم في واجهة Luma.
ما هي البيانات المتاحة
| الأداة | ما يحصل عليه الذكاء الاصطناعي | مثال على السؤال |
|---|---|---|
get_operational_overview |
عدد الطلبات المفتوحة حسب الحالات، والطلبات المتأخرة والإقامات النشطة | «أعد ملخصاً موجزاً لبداية الوردية» |
list_open_requests |
أحدث الطلبات المفتوحة: الرقم، الاسم، الحالة، الأولوية، المنفذ والتواريخ | «اعرض الطلبات الجديدة واقترح ترتيب المعالجة» |
list_active_stays |
الإقامات النشطة: رقم الغرفة وتواريخ الوصول والمغادرة | «ما هي حالات المغادرة القادمة بين الإقامات النشطة؟» |
list_service_catalog |
الخدمات النشطة، والأسعار، والعملة، وطريقة الدفع، ووقت التوفر وقواعد الحجز | «ما هي الخدمات المتاحة وكم تكلفتها؟» |
تُرجع القوائم حتى 20 سجلاً افتراضياً؛ وتحدد المعلمة limit من 1 إلى 50. لا يوجد ترقيم صفحات: قائمة من 50 سجلاً لا تضمن اكتمال التقرير. الطلبات مرتبة من الأحدث إلى الأقدم، والإقامات — حسب وقت المغادرة. للحصول على العدد الكامل استخدم الملخص.
توجد للطلبات مرشح status: new، accepted، in_progress، waiting_guest، ready. الطلبات المكتملة والملغاة لا تدخل في القائمة المفتوحة. يُرجع الكتالوج الأسماء والأوصاف باللغة الإنجليزية؛ ويمكن للمساعد ترجمة الإجابة. يُخزَّن السعر في price_minor: بالنسبة لـ IDR هو المبلغ المعروض، وبالنسبة لبقية العملات المدعومة — أجزاء المئة من العملة.
كيفية الاتصال
- سجّل الدخول إلى حساب المالك، وافتح «AI وMCP» في قائمة الإدارة. أدخل اسم الاتصال واضغط «إنشاء رمز». انسخ الرمز الصادر: يظهر فقط في هذه الصفحة بعد الإنشاء. يحصل المدير على الرمز من مالك الفندق.
- في إعدادات عميل الذكاء الاصطناعي المتوافق، أضف خادم MCP بعيداً مع دعم HTTP وترويسة التفويض.
- حدد العنوان
https://lalo.craabchee.com/mcpوالتفويضBearerمع الرمز الصادر. يجب أن يرسل العميل الترويسةAuthorization: Bearer <MCP_TOKEN>مع كل طلب. هنا<MCP_TOKEN>هو تسمية وليس مفتاحاً حقيقياً. - احفظ الاتصال وتحقق من أن العميل يرى الأدوات الأربع من الجدول أعلاه.
- اطلب ملخص الفندق. قارن النتيجة مع البيانات الحالية في الحساب وتحقق من وقت
generated_at.
يُدعم البروتوكول 2025-11-25 وJSON-RPC 2.0 واستجابات JSON لطلبات POST. لا يتم توفير تدفق GET/SSE. لم يتم تنفيذ الدخول عبر OAuth: العميل الذي يتطلب OAuth إلزامياً لن يتمكن من الاتصال بهذه الطريقة. تعتمد أسماء الحقول المحددة على عميل الذكاء الاصطناعي.
أمثلة على الطلبات للفريق
المالك: «احصل على ملخص محدث عبر MCP. اعرض الطلبات المفتوحة حسب الحالات، وعدد المتأخرة والإقامات النشطة. اقترح ثلاث أولويات للفريق. حدد وقت البيانات وقيود العينة».
المدير: «احصل على حتى 50 طلباً جديداً عبر list_open_requests مع status: new. جمّعها حسب الأولوية، وحدد الطلبات بدون منفذ واقترح ترتيب المعالجة. لا تغيّر شيئاً».
التحضير للمغادرات: «احصل على حتى 50 إقامة نشطة. حدد أقرب حالات المغادرة مع أرقام الغرف والأوقات. لا تحدد هوية الضيوف واذكر إذا كانت القائمة محدودة».
الكتالوج: «احصل على الخدمات النشطة. اشرح الأسعار وقواعد الحجز المسبق بلغة بسيطة. لا تعد بالتوفر في تاريخ محدد: MCP لا يُرجع عدد الأماكن المتبقية».
تعليمات لمساعد الذكاء الاصطناعي
يمكن حفظ هذه التعليمات في إعدادات مساعدك:
استخدم أدوات Luma MCP للحصول على البيانات الحالية. افصل الحقائق الواردة من استجابة الخادم عن التوصيات. حدد وقت الملخص وقيود القوائم. لا تختلق بيانات مفقودة ولا تحدد هوية الضيوف من أرقام الغرف والتواريخ. MCP متاح للقراءة فقط. لتغيير طلب أو دفع أو إرسال رسالة، اقترح على المدير تنفيذ الإجراء في Luma. إذا كانت البيانات غير متاحة، أبلغ عن ذلك بوضوح.
إدارة الاتصالات والخصوصية
كل رمز مرتبط بفندق واحد. لا يُرجع MCP أسماء الضيوف وبيانات الاتصال بهم، ورموز PIN، وأوصاف الطلبات، والملاحظات الداخلية وبيانات الدفع. ومع ذلك، فإن أرقام الغرف وأسماء الطلبات وأسماء الموظفين المعينين متاحة للمساعد — اختر عميل الذكاء الاصطناعي الذي تثق به فريقك.
احفظ الرمز في إعدادات اتصال آمنة. لا تلصقه في الرسائل أو شريط العنوان أو لقطات الشاشة أو المستندات العامة. أصدر رمزاً منفصلاً لكل عميل. عند فقدان الوصول أو تغيير الموظف، يجب على المالك فتح «AI وMCP» في الحساب والضغط على «إلغاء» بجانب الاتصال المعني.
إذا لم يعمل الاتصال
- 401: الرمز مفقود أو غير صحيح أو ملغى؛ تحقق أيضاً من نشاط الفندق والوصول عبر الاشتراك مع المسؤول.
- 403: أصل عميل المتصفح غير مسموح. يجب على المسؤول التحقق من إعدادات المصادر المسموح بها؛ لا حاجة لتعطيل التحقق.
- 405: العميل يستخدم GET. يجب أن يعمل الاتصال عبر POST مع استجابات JSON.
- 429: تم تجاوز حد الطلبات. انتظر وأعد الطلب؛ المسار محدود بـ 60 طلباً في الدقيقة.
- قائمة فارغة: قد لا توجد بيانات مطابقة. تحقق من الحالة وتواريخ الإقامة والمرشح؛ لا تستبدل البيانات المفقودة بالافتراضات.
- مطلوب OAuth: التكامل الحالي يستخدم رمز Bearer؛ اختر عميلاً متوافقاً.
يُعرض في حساب المالك اسم الاتصال وتاريخ الإنشاء وآخر استخدام والحالة. لتعطيل عميل الذكاء الاصطناعي، اضغط «إلغاء». يوقف الإلغاء الوصول بهذا الرمز؛ لإعادة الاتصال أنشئ رمزاً جديداً. رموز الفنادق الأخرى غير متاحة، ولا يمكن للمدير إصدار أو إلغاء الرموز.