Napi punika AI assistant sareng MCP
MCP nyambungang AI assistant eksternal ring Luma Concierge. Pemilik lan manajer prasida mataken indik operasi hotel lan nampi wangsulan madasar data sistem sane mangkin. Puniki sambungan sane kapisah antuk tim; tamu nenten perlu punika antuk nganggen aplikasi.
Server punika read-only. AI prasida ngusulang rencana aksi, nanging ngatur assignee, nguah status, ngirim pesen ring tamu, lan operasi pembayaran kamargiang ring antarmuka Luma.
Data napi sane kasedia
| Piranti | Napi sane katampi AI | Conto pitaken |
|---|---|---|
get_operational_overview |
Akeh panesengan sane kabuka manut status, panesengan sane lintang wektu, lan stay aktif | "Siapang ringkesan singkat antuk ngawitin shift" |
list_open_requests |
Panesengan kabuka paling anyar: nomer, judul, status, prioritas, assignee, lan tanggal | "Tampilang panesengan anyar lan usulang urutan penanganan" |
list_active_stays |
Stay aktif: kamar lan tanggal check-in lan check-out | "Check-out napi sane jagi rauh ring pantaraning stay aktif?" |
list_service_catalog |
Layanan aktif, harga, mata uang, metode pembayaran, wektu kasediaan, lan aturan booking | "Layanan napi sane kasedia lan aji kuda?" |
Lis ngawaliang ngantos 20 data secara default; parameter limit nyetel saking 1 ngantos 50. Nenten wenten pagination: lis 50 data nenten njamin kelengkapan laporan. Panesengan kaurutang saking paling anyar ngantos paling lingsir, stay manut wektu check-out. Antuk total akeh, nganggen ringkesan.
Antuk panesengan wenten filter status: new, accepted, in_progress, waiting_guest, ready. Panesengan sane sampun puput lan kaborang nenten kasarengin ring lis kabuka. Katalog ngawaliang wasta lan deskripsi ring basa Inggris; assistant prasida ngewangsulang. Harga kasimpen ring price_minor: antuk IDR punika akeh sane kacingak, antuk mata uang sane kasedia tiosan punika satus-satus mata uang.
Kadi napi nyambung
- Login ring dashboard pemilik, buka "AI dan MCP" ring menu manajemen. Lebokang wasta sambungan lan klik "Create token". Copy token sane kamedalang: punika kacingak wantah ring kaca puniki sasampun karipta. Manajer nampi token saking pemilik hotel.
- Ring setelan klien AI sane kompatibel, tambahang server MCP remote sareng dukungan HTTP lan header otorisasi.
- Tentukan alamat
https://lalo.craabchee.com/mcplan otorisasiBearersareng token sane kamedalang. Klien patut ngirim headerAuthorization: Bearer <MCP_TOKEN>ring saben panesengan. Puniki<MCP_TOKEN>punika placeholder, nenten kunci asli. - Simpen sambungan lan parios klien nyingakin papat piranti saking tabel ring ajeng.
- Panesengan ringkesan hotel. Bandingang asil sareng data dashboard sane mangkin lan parios wektu
generated_at.
Protokol 2025-11-25, JSON-RPC 2.0, lan wangsulan JSON antuk panesengan POST kasedia. Aliran GET/SSE nenten kasedia. Login OAuth nenten kamargiang: klien sane patut OAuth nenten prasida nyambung kadi puniki. Wasta field sane spesifik madasar klien AI.
Conto prompt antuk tim
Pemilik: "Jemak ringkesan sane mangkin liwat MCP. Tampilang panesengan kabuka manut status, akeh sane lintang wektu lan stay aktif. Usulang tetiga prioritas antuk tim. Tentukan wektu data lan watesan sampling."
Manajer: "Jemak ngantos 50 panesengan anyar liwat list_open_requests sareng status: new. Kelompokang manut prioritas, tandain panesengan tanpa assignee, lan usulang urutan penanganan. Sampun nguah napi-napi."
Nyiapang check-out: "Jemak ngantos 50 stay aktif. Tandain check-out sane pinih nampek sareng nomer kamar lan wektu. Sampun ngenal tamu lan tunjukang yening lis kawatesin."
Katalog: "Jemak layanan aktif. Terangin harga lan aturan booking sadurung ring basa sederhana. Sampun janji kasediaan ring tanggal spesifik: MCP nenten ngewaliang slot sane kantun."
Pitutur antuk AI assistant
Pitutur puniki prasida kasimpen ring setelan assistant semeton:
Anggen piranti Luma MCP antuk jemak data sane mangkin. Pisahang fakta saking wangsulan server saking rekomendasi. Tentukan wektu ringkesan lan watesan lis. Sampun ngaryanin data sane nenten wenten lan sampun ngenal tamu manut nomer kamar lan tanggal. MCP punika read-only. Antuk nguah panesengan, ngaryanin pembayaran, utawi ngirim pesen, usulang manajer ngamargiang aksi ring Luma. Yening data nenten kasedia, tunjukang langsung.
Manajemen sambungan lan privasi
Saben token kaiket ring asiki hotel. MCP nenten ngewaliang wasta tamu lan kontak, kode PIN, deskripsi panesengan, catatan internal, utawi data pembayaran. Nanging, nomer kamar, judul panesengan, lan wasta staf sane katugasang kasedia antuk assistant — pilih klien AI sane dipercaya tim semeton.
Simpen token ring setelan sambungan sane aman. Sampun nempelang ring pesen, bar alamat, screenshot, utawi dokumen sane kabagi. Medalang token sane kapisah antuk saben klien. Yening akses ical utawi karyawan nguah, pemilik patut buka "AI dan MCP" ring dashboard lan klik "Revoke" antuk sambungan sane cocok.
Yening sambungan nenten jalan
- 401: token nenten wenten, iwang, utawi kaborang; parios taler aktivitas hotel lan akses langganan sareng administrator.
- 403: Origin klien browser nenten kaiizin. Administrator patut parios setelan origin sane kaiizin; sampun ngurungin parios.
- 405: klien nganggen GET. Sambungan patut jalan liwat POST sareng wangsulan JSON.
- 429: watesan panesengan sampun kalampahin. Antos lan coba malih panesengan; rute kawatesin ngantos 60 panesengan per menit.
- Lis kosong: minab nenten wenten data sane cocok. Parios status, tanggal stay, lan filter; sampun ganti data sane nenten wenten sareng asumsi.
- OAuth kaperluang: integrasi sane mangkin nganggen token Bearer; pilih klien sane kompatibel.
Dashboard pemilik nampilang wasta sambungan, tanggal karipta, pangawit kaanggen, lan status. Antuk nyambungang klien AI, klik "Revoke". Revokasi ngawedhar akses liwat token puniki; antuk nyambung malih, karyanin sane anyar. Token hotel tiosan nenten prasida kaakses, lan manajer nenten prasida medalang utawi revoke token.