AI і MCP · Посібник Luma Concierge

Що таке AI-помічник з MCP

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 і MCP» в меню управління. Введіть назву підключення та натисніть «Створити токен». Скопіюйте виданий токен: він показується тільки на цій сторінці після створення. Менеджер отримує токен від власника готелю.
У налаштуваннях сумісного AI-клієнта додайте віддалений 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, не зможе підключитися цим способом. Конкретні назви полів залежать від 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-клієнт, натисніть «Відкликати». Відкликання припиняє доступ за цим токеном; для повторного підключення створіть новий. Токени інших готелів недоступні, менеджер не може випускати або відкликати токени.