MCP के साथ AI सहायक क्या है
MCP एक बाहरी AI सहायक को Luma Concierge से जोड़ता है। मालिक और प्रबंधक होटल संचालन के बारे में प्रश्न पूछ सकते हैं और वर्तमान सिस्टम डेटा के आधार पर उत्तर प्राप्त कर सकते हैं। यह टीम के लिए एक अलग कनेक्शन है; ऐप का उपयोग करने के लिए अतिथि को इसकी आवश्यकता नहीं है।
सर्वर केवल-पढ़ने योग्य है। AI एक कार्य योजना सुझा सकता है, लेकिन असाइनीज़ सौंपना, स्थितियाँ बदलना, अतिथियों को संदेश भेजना और भुगतान संचालन Luma इंटरफ़ेस में किए जाते हैं।
कौन सा डेटा उपलब्ध है
| उपकरण | AI को क्या प्राप्त होता है | उदाहरण प्रश्न |
|---|---|---|
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 and MCP" खोलें। एक कनेक्शन नाम दर्ज करें और "Create token" पर क्लिक करें। जारी किए गए टोकन को कॉपी करें: यह निर्माण के बाद केवल इस पृष्ठ पर दिखाया जाता है। प्रबंधक को टोकन होटल के मालिक से प्राप्त होता है।
- एक संगत AI क्लाइंट की सेटिंग्स में, HTTP समर्थन और एक प्राधिकरण हेडर के साथ एक रिमोट MCP सर्वर जोड़ें।
- पता
https://lalo.craabchee.com/mcpऔर जारी किए गए टोकन के साथBearerप्राधिकरण निर्दिष्ट करें। क्लाइंट को प्रत्येक अनुरोध के साथ हेडरAuthorization: Bearer <MCP_TOKEN>भेजना चाहिए। यहाँ<MCP_TOKEN>एक प्लेसहोल्डर है, वास्तविक कुंजी नहीं। - कनेक्शन सहेजें और जांचें कि क्लाइंट ऊपर दी गई तालिका से चार उपकरण देखता है।
- होटल सारांश का अनुरोध करें। परिणाम की तुलना वर्तमान डैशबोर्ड डेटा से करें और
generated_atसमय की जांच करें।
प्रोटोकॉल 2025-11-25, JSON-RPC 2.0, और POST अनुरोधों के लिए JSON प्रतिक्रियाएँ समर्थित हैं। GET/SSE स्ट्रीम प्रदान नहीं की जाती है। OAuth लॉगिन लागू नहीं है: एक क्लाइंट जो सख्ती से OAuth की आवश्यकता रखता है, इस तरह से कनेक्ट नहीं कर पाएगा। विशिष्ट फ़ील्ड नाम AI क्लाइंट पर निर्भर करते हैं।
टीम के लिए उदाहरण संकेत
मालिक: "MCP के माध्यम से वर्तमान सारांश प्राप्त करें। स्थिति के अनुसार खुले अनुरोध, अतिदेय और सक्रिय ठहरावों की संख्या दिखाएँ। टीम के लिए तीन प्राथमिकताएँ सुझाएँ। डेटा समय और नमूना सीमाएँ निर्दिष्ट करें।"
प्रबंधक: "list_open_requests के माध्यम से status: new के साथ 50 नए अनुरोध प्राप्त करें। प्राथमिकता के अनुसार समूहित करें, बिना असाइनी वाले अनुरोधों को चिह्नित करें, और संभालने का क्रम सुझाएँ। कुछ भी न बदलें।"
चेक-आउट की तैयारी: "50 सक्रिय ठहराव प्राप्त करें। कमरा संख्या और समय के साथ निकटतम चेक-आउट को हाइलाइट करें। अतिथियों की पहचान न करें और संकेत दें कि क्या सूची सीमित है।"
कैटलॉग: "सक्रिय सेवाएँ प्राप्त करें। कीमतों और अग्रिम बुकिंग नियमों को सरल भाषा में समझाएँ। किसी विशिष्ट तिथि पर उपलब्धता का वादा न करें: MCP शेष स्लॉट नहीं लौटाता है।"
AI सहायक के लिए निर्देश
ये निर्देश आपके सहायक की सेटिंग्स में सहेजे जा सकते हैं:
वर्तमान डेटा प्राप्त करने के लिए Luma MCP उपकरणों का उपयोग करें। सर्वर प्रतिक्रिया से तथ्यों को सिफारिशों से अलग करें। सारांश समय और सूची सीमाएँ निर्दिष्ट करें। अनुपलब्ध डेटा का आविष्कार न करें और कमरा संख्याओं और तिथियों द्वारा अतिथियों की पहचान न करें। MCP केवल-पढ़ने योग्य है। अनुरोध बदलने, भुगतान करने, या संदेश भेजने के लिए, प्रबंधक को Luma में कार्रवाई करने का सुझाव दें। यदि डेटा अनुपलब्ध है, तो सीधे बताएं।
कनेक्शन प्रबंधन और गोपनीयता
प्रत्येक टोकन एक होटल से जुड़ा होता है। MCP अतिथि नाम और संपर्क, PIN कोड, अनुरोध विवरण, आंतरिक नोट्स, या भुगतान डेटा नहीं लौटाता है। हालाँकि, कमरा संख्याएँ, अनुरोध शीर्षक, और असाइन किए गए कर्मचारियों के नाम सहायक के लिए उपलब्ध हैं — एक AI क्लाइंट चुनें जिस पर आपकी टीम भरोसा करती है।
टोकन को सुरक्षित कनेक्शन सेटिंग्स में संग्रहीत करें। इसे संदेशों, पता बार, स्क्रीनशॉट, या साझा दस्तावेज़ों में पेस्ट न करें। प्रत्येक क्लाइंट के लिए एक अलग टोकन जारी करें। यदि पहुँच खो जाती है या कोई कर्मचारी बदलता है, तो मालिक को डैशबोर्ड में "AI and MCP" खोलना चाहिए और संबंधित कनेक्शन के लिए "Revoke" पर क्लिक करना चाहिए।
यदि कनेक्शन काम नहीं करता है
- 401: टोकन गायब है, गलत है, या रद्द कर दिया गया है; प्रशासक के साथ होटल की गतिविधि और सदस्यता पहुँच भी जांचें।
- 403: ब्राउज़र क्लाइंट का Origin अनुमत नहीं है। प्रशासक को अनुमत मूल सेटिंग्स की जांच करनी चाहिए; जांच को अक्षम न करें।
- 405: क्लाइंट GET का उपयोग कर रहा है। कनेक्शन को JSON प्रतिक्रियाओं के साथ POST के माध्यम से काम करना चाहिए।
- 429: अनुरोध सीमा पार हो गई है। प्रतीक्षा करें और अनुरोध पुनः प्रयास करें; मार्ग प्रति मिनट 60 अनुरोधों तक सीमित है।
- खाली सूची: कोई मेल खाता डेटा नहीं हो सकता है। स्थिति, ठहराव तिथियाँ, और फ़िल्टर जांचें; अनुपलब्ध डेटा को अनुमानों से न बदलें।
- OAuth आवश्यक: वर्तमान एकीकरण Bearer टोकन का उपयोग करता है; एक संगत क्लाइंट चुनें।
मालिक का डैशबोर्ड कनेक्शन नाम, निर्माण तिथि, अंतिम उपयोग, और स्थिति प्रदर्शित करता है। AI क्लाइंट को डिस्कनेक्ट करने के लिए, "Revoke" पर क्लिक करें। रद्द करना इस टोकन के माध्यम से पहुँच समाप्त कर देता है; पुनः कनेक्ट करने के लिए, एक नया बनाएँ। अन्य होटलों के टोकन सुलभ नहीं हैं, और प्रबंधक टोकन जारी या रद्द नहीं कर सकता।