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-клиент, нажмите «Отозвать». Отзыв прекращает доступ по этому токену; для повторного подключения создайте новый. Токены других отелей недоступны, менеджер не может выпускать или отзывать токены.