IA y MCP · Guía de Luma Concierge

¿Qué es un asistente de IA con MCP?

MCP conecta un asistente de IA externo a Luma Concierge. El propietario y el gerente pueden hacer preguntas sobre las operaciones del hotel y recibir respuestas basadas en los datos actuales del sistema. Esta es una conexión separada para el equipo; el huésped no la necesita para usar la aplicación.

El servidor es de solo lectura. La IA puede sugerir un plan de acción, pero asignar responsables, cambiar estados, enviar mensajes a los huéspedes y realizar operaciones de pago se realizan en la interfaz de Luma.

Qué datos están disponibles

Herramienta	Qué recibe la IA	Pregunta de ejemplo
`get_operational_overview`	Número de solicitudes abiertas por estado, solicitudes vencidas y estancias activas	"Prepara un resumen breve para el inicio del turno"
`list_open_requests`	Últimas solicitudes abiertas: número, título, estado, prioridad, responsable y fechas	"Muestra las nuevas solicitudes y sugiere un orden de gestión"
`list_active_stays`	Estancias activas: habitación y fechas de check-in y check-out	"¿Qué check-outs son próximos entre las estancias activas?"
`list_service_catalog`	Servicios activos, precios, moneda, método de pago, horario de disponibilidad y reglas de reserva	"¿Qué servicios están disponibles y cuánto cuestan?"

Las listas devuelven hasta 20 registros por defecto; el parámetro limit establece de 1 a 50. No hay paginación: una lista de 50 registros no garantiza la integridad del informe. Las solicitudes se ordenan de la más reciente a la más antigua, las estancias por hora de check-out. Para el recuento completo, utiliza el resumen.

Para las solicitudes hay un filtro status: new, accepted, in_progress, waiting_guest, ready. Las solicitudes completadas y canceladas no se incluyen en la lista abierta. El catálogo devuelve nombres y descripciones en inglés; el asistente puede traducir la respuesta. El precio se almacena en price_minor: para IDR es el importe mostrado, para otras monedas admitidas son centésimas de la moneda.

Cómo conectarse

Inicia sesión en el panel del propietario, abre "IA y MCP" en el menú de gestión. Introduce un nombre de conexión y haz clic en "Crear token". Copia el token emitido: solo se muestra en esta página después de crearlo. El gerente recibe el token del propietario del hotel.
En la configuración de un cliente de IA compatible, añade un servidor MCP remoto con soporte HTTP y una cabecera de autorización.
Especifica la dirección https://lalo.craabchee.com/mcp y la autorización Bearer con el token emitido. El cliente debe enviar la cabecera Authorization: Bearer <MCP_TOKEN> con cada solicitud. Aquí <MCP_TOKEN> es un marcador de posición, no una clave real.
Guarda la conexión y comprueba que el cliente ve las cuatro herramientas de la tabla anterior.
Solicita el resumen del hotel. Compara el resultado con los datos actuales del panel y comprueba la hora generated_at.

Se admiten el protocolo 2025-11-25, JSON-RPC 2.0 y las respuestas JSON a solicitudes POST. No se proporciona un flujo GET/SSE. El inicio de sesión OAuth no está implementado: un cliente que requiera estrictamente OAuth no podrá conectarse de esta forma. Los nombres de campo específicos dependen del cliente de IA.

Indicaciones de ejemplo para el equipo

Propietario: "Obtén el resumen actual mediante MCP. Muestra las solicitudes abiertas por estado, el número de estancias vencidas y activas. Sugiere tres prioridades para el equipo. Especifica la hora de los datos y las limitaciones de muestreo."

Gerente: "Obtén hasta 50 solicitudes nuevas mediante list_open_requests con status: new. Agrupa por prioridad, marca las solicitudes sin responsable y sugiere un orden de gestión. No cambies nada."

Preparación para los check-outs: "Obtén hasta 50 estancias activas. Destaca los check-outs más próximos con números de habitación y horas. No identifiques a los huéspedes e indica si la lista es limitada."

Catálogo: "Obtén los servicios activos. Explica los precios y las reglas de reserva anticipada en lenguaje sencillo. No prometas disponibilidad en una fecha concreta: MCP no devuelve las plazas restantes."

Instrucciones para el asistente de IA

Estas instrucciones se pueden guardar en la configuración de tu asistente:

Utiliza las herramientas MCP de Luma para obtener datos actuales. Separa los hechos de la respuesta del servidor de las recomendaciones. Especifica la hora del resumen y las limitaciones de la lista. No inventes datos que falten y no identifiques a los huéspedes por números de habitación y fechas. MCP es de solo lectura. Para cambiar una solicitud, realizar un pago o enviar un mensaje, sugiere que el gerente realice la acción en Luma. Si los datos no están disponibles, indícalo directamente.

Gestión de conexiones y privacidad

Cada token está vinculado a un hotel. MCP no devuelve nombres ni contactos de huéspedes, códigos PIN, descripciones de solicitudes, notas internas ni datos de pago. Sin embargo, los números de habitación, los títulos de las solicitudes y los nombres del personal asignado están disponibles para el asistente: elige un cliente de IA en el que confíe tu equipo.

Guarda el token en la configuración segura de la conexión. No lo pegues en mensajes, la barra de direcciones, capturas de pantalla ni documentos compartidos. Emite un token separado para cada cliente. Si se pierde el acceso o cambia un empleado, el propietario debe abrir "IA y MCP" en el panel y hacer clic en "Revocar" para la conexión correspondiente.

Si la conexión no funciona

401: el token falta, es incorrecto o ha sido revocado; comprueba también la actividad del hotel y el acceso a la suscripción con el administrador.
403: el Origin del cliente del navegador no está permitido. El administrador debe comprobar la configuración de orígenes permitidos; no desactives la comprobación.
405: el cliente está usando GET. La conexión debe funcionar mediante POST con respuestas JSON.
429: se ha superado el límite de solicitudes. Espera y vuelve a intentar la solicitud; la ruta está limitada a 60 solicitudes por minuto.
Lista vacía: puede que no haya datos coincidentes. Comprueba el estado, las fechas de estancia y el filtro; no sustituyas los datos que faltan con suposiciones.
OAuth requerido: la integración actual utiliza un token Bearer; elige un cliente compatible.

El panel del propietario muestra el nombre de la conexión, la fecha de creación, el último uso y el estado. Para desconectar el cliente de IA, haz clic en "Revocar". La revocación termina el acceso mediante este token; para volver a conectarte, crea uno nuevo. Los tokens de otros hoteles no son accesibles, y el gerente no puede emitir ni revocar tokens.