AI dan MCP · Panduan Luma Concierge

Apa itu asisten AI dengan MCP

MCP menghubungkan asisten AI eksternal dengan Luma Concierge. Pemilik dan manajer dapat mengajukan pertanyaan tentang operasional hotel dan menerima jawaban berdasarkan data sistem terkini. Ini adalah koneksi terpisah untuk tim; tamu tidak memerlukannya untuk menggunakan aplikasi.

Server beroperasi hanya baca. AI dapat mengusulkan rencana tindakan, tetapi penetapan pelaksana, perubahan status, pesan ke tamu, dan operasi pembayaran dilakukan di antarmuka Luma.

Data apa yang tersedia

Alat	Apa yang diterima AI	Contoh pertanyaan
`get_operational_overview`	Jumlah permintaan terbuka berdasarkan status, permintaan terlambat, dan masa inap aktif	«Siapkan ringkasan singkat untuk awal shift»
`list_open_requests`	Permintaan terbuka terbaru: nomor, nama, status, prioritas, pelaksana, dan tanggal	«Tampilkan permintaan baru dan usulkan urutan penanganan»
`list_active_stays`	Masa inap aktif: nomor dan tanggal check-in dan check-out	«Check-out apa yang akan datang di antara masa inap aktif?»
`list_service_catalog`	Layanan aktif, harga, mata uang, metode pembayaran, waktu ketersediaan, dan aturan pemesanan	«Layanan apa yang tersedia dan berapa harganya?»

Daftar mengembalikan hingga 20 entri secara default; parameter limit menetapkan dari 1 hingga 50. Tidak ada paginasi: daftar 50 entri tidak menjamin kelengkapan laporan. Permintaan diurutkan dari baru ke lama, masa inap — berdasarkan waktu check-out. Untuk jumlah lengkap gunakan ringkasan.

Untuk permintaan ada filter status: new, accepted, in_progress, waiting_guest, ready. Permintaan yang selesai dan dibatalkan tidak termasuk dalam daftar terbuka. Katalog mengembalikan nama dan deskripsi dalam bahasa Inggris; asisten dapat menerjemahkan jawaban. Harga disimpan dalam price_minor: untuk IDR ini adalah jumlah yang ditampilkan, untuk mata uang lain yang didukung — seperseratus mata uang.

Cara terhubung

Masuk ke akun pemilik, buka «AI dan MCP» di menu pengelolaan. Masukkan nama koneksi dan klik «Buat token». Salin token yang diberikan: token hanya ditampilkan di halaman ini setelah dibuat. Manajer menerima token dari pemilik hotel.
Di pengaturan klien AI yang kompatibel, tambahkan server MCP jarak jauh dengan dukungan HTTP dan header otorisasi.
Tentukan alamat https://lalo.craabchee.com/mcp dan otorisasi Bearer dengan token yang diberikan. Klien harus mengirim header Authorization: Bearer <MCP_TOKEN> pada setiap permintaan. Di sini <MCP_TOKEN> adalah penanda, bukan kunci sebenarnya.
Simpan koneksi dan periksa bahwa klien melihat empat alat dari tabel di atas.
Minta ringkasan hotel. Bandingkan hasilnya dengan data akun terkini dan periksa waktu generated_at.

Protokol 2025-11-25, JSON-RPC 2.0, dan respons JSON untuk permintaan POST didukung. Aliran GET/SSE tidak disediakan. Login melalui OAuth tidak diimplementasikan: klien yang wajib memerlukan OAuth tidak akan dapat terhubung dengan cara ini. Nama bidang spesifik bergantung pada klien AI.

Contoh permintaan untuk tim

Pemilik: «Dapatkan ringkasan terkini melalui MCP. Tampilkan permintaan terbuka berdasarkan status, jumlah yang terlambat dan masa inap aktif. Usulkan tiga prioritas untuk tim. Sebutkan waktu data dan batasan pengambilan sampel».

Manajer: «Dapatkan hingga 50 permintaan baru melalui list_open_requests dengan status: new. Kelompokkan berdasarkan prioritas, tandai permintaan tanpa pelaksana, dan usulkan urutan penanganan. Jangan ubah apa pun».

Persiapan check-out: «Dapatkan hingga 50 masa inap aktif. Sorot check-out terdekat dengan nomor dan waktu. Jangan tentukan identitas tamu dan sebutkan jika daftar terbatas».

Katalog: «Dapatkan layanan aktif. Jelaskan harga dan aturan pemesanan awal dengan bahasa sederhana. Jangan menjanjikan ketersediaan pada tanggal tertentu: MCP tidak mengembalikan sisa tempat».

Instruksi untuk asisten AI

Instruksi ini dapat disimpan di pengaturan asisten Anda:

Gunakan alat Luma MCP untuk mendapatkan data terkini. Pisahkan fakta dari jawaban server dari rekomendasi. Sebutkan waktu ringkasan dan batasan daftar. Jangan mengarang data yang tidak ada dan jangan tentukan identitas tamu berdasarkan nomor dan tanggal. MCP hanya tersedia untuk baca. Untuk mengubah permintaan, pembayaran, atau mengirim pesan, usulkan agar manajer melakukan tindakan di Luma. Jika data tidak tersedia, beri tahu secara langsung.

Pengelolaan koneksi dan privasi

Setiap token terikat pada satu hotel. MCP tidak mengembalikan nama dan kontak tamu, PIN, deskripsi permintaan, catatan internal, dan data pembayaran. Namun nomor, nama permintaan, dan nama karyawan yang ditugaskan tersedia untuk asisten — pilih klien AI yang dipercaya oleh tim Anda.

Simpan token di pengaturan koneksi yang aman. Jangan tempelkan ke pesan, bilah alamat, tangkapan layar, atau dokumen umum. Untuk setiap klien, terbitkan token terpisah. Jika akses hilang atau karyawan berganti, pemilik harus membuka «AI dan MCP» di akun dan klik «Cabut» pada koneksi yang sesuai.

Jika koneksi tidak berfungsi

401: token tidak ada, salah, atau dicabut; juga periksa aktivitas hotel dan akses berdasarkan langganan dengan administrator.
403: Origin klien browser tidak diizinkan. Administrator harus memeriksa pengaturan sumber yang diizinkan; tidak perlu menonaktifkan pemeriksaan.
405: klien menggunakan GET. Koneksi harus berfungsi melalui POST dengan respons JSON.
429: batas permintaan terlampaui. Tunggu dan ulangi permintaan; rute dibatasi 60 permintaan per menit.
Daftar kosong: data yang cocok mungkin tidak ada. Periksa status, tanggal masa inap, dan filter; jangan ganti data yang tidak ada dengan asumsi.
OAuth diperlukan: integrasi saat ini menggunakan token Bearer; pilih klien yang kompatibel.

Di akun pemilik ditampilkan nama koneksi, tanggal pembuatan, penggunaan terakhir, dan status. Untuk menonaktifkan klien AI, klik «Cabut». Pencabutan menghentikan akses melalui token ini; untuk menghubungkan kembali, buat token baru. Token hotel lain tidak dapat diakses, manajer tidak dapat menerbitkan atau mencabut token.