什么是带 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 和 MCP”。输入连接名称并点击“创建令牌”。复制生成的令牌：创建后它只会在该页面显示。经理从酒店业主处获取令牌。
- 在兼容 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 获取最多 50 个新请求，使用 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 客户端，请点击“撤销”。撤销会终止该令牌的访问；如需重新连接，请创建新令牌。其他酒店的令牌不可访问，经理不能发放或撤销令牌。