AI ו-MCP

מהו עוזר AI עם MCP

MCP מחבר עוזר AI חיצוני ל-Luma Concierge. הבעלים והמנהל יכולים לשאול שאלות על עבודת המלון ולקבל תשובות המבוססות על נתוני המערכת הנוכחיים. זהו חיבור נפרד לצוות; האורח אינו זקוק לו כדי לעבוד עם האפליקציה.

השרת פועל לקריאה בלבד. ה-AI יכול להציע תוכנית פעולה, אך הקצאת מבצעים, שינוי סטטוסים, הודעות לאורחים ופעולות תשלום מבוצעים בממשק Luma.

אילו נתונים זמינים

הרשימות מחזירות עד 20 רשומות כברירת מחדל; הפרמטר limit קובע בין 1 ל-50. אין עימוד: רשימה של 50 רשומות אינה מבטיחה שלמות הדוח. הבקשות ממוינות מהחדשות לישנות, והשהיות — לפי זמן היציאה. למספר מלא השתמש בסיכום.

עבור בקשות קיים מסנן status: new, accepted, in_progress, waiting_guest, ready. בקשות שהושלמו ובוטלו אינן נכללות ברשימה הפתוחה. הקטלוג מחזיר שמות ותיאורים באנגלית; העוזר יכול לתרגם את התשובה. המחיר נשמר ב-price_minor: עבור IDR זהו הסכום המוצג, ולשאר המטבעות הנתמכים — מאיות המטבע.

כיצד להתחבר

1. היכנס לחשבון הבעלים, פתח «AI ו-MCP» בתפריט הניהול. הזן שם חיבור ולחץ «צור טוקן». העתק את הטוקן שהונפק: הוא מוצג רק בעמוד זה לאחר היצירה. המנהל מקבל טוקן מהבעלים של המלון.
2. בהגדרות לקוח AI תואם הוסף שרת MCP מרוחק עם תמיכה ב-HTTP ובכותרת הרשאה.
3. ציין את הכתובת https://lalo.craabchee.com/mcp והרשאה Bearer עם הטוקן שהונפק. הלקוח חייב לשלוח את הכותרת Authorization: Bearer <MCP_TOKEN> בכל בקשה. כאן <MCP_TOKEN> הוא סימון, ולא מפתח אמיתי.
4. שמור את החיבור ובדוק שהלקוח רואה ארבעה כלים מהטבלה שלמעלה.
5. בקש סיכום מלון. השווה את התוצאה לנתונים הנוכחיים בחשבון ובדוק את הזמן generated_at.

נתמכים פרוטוקול 2025-11-25, JSON-RPC 2.0 ותשובות JSON לבקשות POST. זרם GET/SSE אינו מסופק. כניסה דרך OAuth אינה מיושמת: לקוח שחייב OAuth לא יוכל להתחבר בדרך זו. שמות השדות הספציפיים תלויים בלקוח ה-AI.

דוגמאות לבקשות לצוות

בעלים: «קבל סיכום עדכני דרך MCP. הצג בקשות פתוחות לפי סטטוסים, מספר בקשות באיחור ושהיות פעילות. הצע שלוש עדיפויות לצוות. ציין את זמן הנתונים ומגבלות הדגימה».

מנהל: «קבל עד 50 בקשות חדשות דרך list_open_requests עם status: new. קבץ לפי עדיפות, סמן בקשות ללא מבצע והצע סדר טיפול. אל תשנה דבר».

הכנה ליציאות: «קבל עד 50 שהיות פעילות. סמן את היציאות הקרובות עם מספרים וזמנים. אל תזהה את זהות האורחים וציין אם הרשימה מוגבלת».

קטלוג: «קבל שירותים פעילים. הסבר מחירים וכללי הזמנה מראש בשפה פשוטה. אל תבטיח זמינות לתאריך מסוים: MCP אינו מחזיר יתרת מקומות».

הנחיה לעוזר AI

ניתן לשמור הנחיה זו בהגדרות העוזר שלך:

השתמש בכלי Luma MCP לקבלת נתונים נוכחיים. הפרד עובדות מתשובת השרת מהמלצות. ציין את זמן הסיכום ומגבלות הרשימות. אל תמציא נתונים חסרים ואל תזהה את זהות האורחים לפי מספרים ותאריכים. MCP זמין לקריאה בלבד. לשינוי בקשה, תשלום או שליחת הודעה הצע למנהל לבצע את הפעולה ב-Luma. אם הנתונים אינם זמינים, דווח על כך ישירות.

ניהול חיבורים ופרטיות

כל טוקן משויך למלון אחד. MCP אינו מחזיר שמות ופרטי קשר של אורחים, קודי PIN, תיאורי בקשות, הערות פנימיות ונתוני תשלום. עם זאת, מספרים, שמות בקשות ושמות עובדים שהוקצו זמינים לעוזר — בחר לקוח AI שהצוות שלך סומך עליו.

שמור את הטוקן בהגדרות חיבור מאובטחות. אל תדביק אותו בהודעות, בשורת הכתובת, בצילומי מסך או במסמכים משותפים. הנפק טוקן נפרד לכל לקוח. במקרה של אובדן גישה או החלפת עובד, הבעלים צריך לפתוח «AI ו-MCP» בחשבון וללחוץ «בטל» ליד החיבור המתאים.

אם החיבור אינו עובד

• 401: הטוקן חסר, שגוי או בוטל; כמו כן בדוק את פעילות המלון והגישה לפי מנוי עם המנהל.
• 403: ה-Origin של לקוח הדפדפן אינו מורשה. המנהל צריך לבדוק את הגדרות המקורות המותרים; אין צורך לכבות את הבדיקה.
• 405: הלקוח משתמש ב-GET. החיבור צריך לעבוד דרך POST עם תשובות JSON.
• 429: חריגה ממגבלת הבקשות. המתן ונסה שוב את הבקשה; המסלול מוגבל ל-60 בקשות בדקה.
• רשימה ריקה: ייתכן שאין נתונים מתאימים. בדוק את הסטטוס, תאריכי השהייה והמסנן; אל תחליף נתונים חסרים בהשערות.
• נדרש OAuth: האינטגרציה הנוכחית משתמשת בטוקן Bearer; בחר לקוח תואם.

בחשבון הבעלים מוצגים שם החיבור, תאריך היצירה, השימוש האחרון והסטטוס. כדי לנתק את לקוח ה-AI, לחץ «בטל». הביטול מפסיק את הגישה באמצעות טוקן זה; לחיבור מחדש צור טוקן חדש. טוקנים של מלונות אחרים אינם נגישים, והמנהל אינו יכול להנפיק או לבטל טוקנים.