apaleo a MCP: reservas de hotel, disponibilidad, tarifas, folios y recepción en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → apaleo, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

apaleo

Operación hotelera en el PMS en la nube apaleo: establecimientos, habitaciones y tipos de habitación, planes de tarifa y tarifas, disponibilidad y ofertas, reservas, estancias y huéspedes, grupos, folios, pagos, facturas, mantenimiento, housekeeping e informes de rendimiento. Crea reservas, asigna habitaciones y hace check-in y check-out. Se conecta como app con OAuth2 client credentials; las cancelaciones y los no-shows vienen desactivados al instalar.

Configuración

La configuración lleva unos 5 minutos. Necesitas una cuenta de apaleo con acceso a Apps. No hay inicio de sesión en el navegador: el conector se autentica como app con el grant OAuth2 client credentials.

1. En apaleo abre Apps > Connected apps > Add a custom app (o registra en apaleo.dev un OAuth simple client con client credentials).
2. Dale a la app los permisos que necesita el equipo. Para leer, por ejemplo properties.read, unitgroups.read, units.read, rateplans.read, rates.read, services.read, companies.read, availability.read, offers.read, reservations.read, groups.read, blocks.read, folios.read, payments.read, invoices.read, maintenances.read y reports.read; para las escrituras reservations.create, reservations.manage, reservations.assign-unit, maintenances.create y operations.change-room-state. Omite los permisos de escritura si el conector solo debe leer.
3. Copia el client id en APALEO_CLIENT_ID y el client secret en APALEO_CLIENT_SECRET. El secret solo se muestra una vez; si lo pierdes, crea uno nuevo en la app.
4. Instala el conector y ejecuta apaleo_list_properties para comprobar la conexión.

El conector obtiene un token de https://identity.apaleo.com/connect/token y lo renueva cada hora. Cada llamada se hace como la custom app, con sus permisos; si a la app le falta un permiso, responde 403.

Qué lee:

• Inventario y tarifas: establecimientos (hoteles), unit groups (tipos de habitación), units (habitaciones) con estado de limpieza y mantenimiento, planes de tarifa, precios por noche con restricciones (apaleo_list_rates), servicios (extras como desayuno o parking), políticas de cancelación y empresas (cuentas corporativas).
• Disponibilidad y ofertas: habitaciones libres por tipo y noche (apaleo_get_unit_group_availability), habitaciones libres durante toda una estancia (apaleo_get_unit_availability), habitaciones asignables a una estancia y apaleo_get_offers, los planes de tarifa reservables con precios para una estancia.
• Reservas y estancias: apaleo_list_reservations con text_search (nombre, email, id de estancia) y date_filter Arrival, Departure o Stay junto con from y to; apaleo_count_reservations cuenta sin cargarlas. Además reservas, servicios de una estancia, grupos y bloqueos. Los huéspedes forman parte de las estancias (primaryGuest, additionalGuests) y de las reservas (booker).
• Facturación: folios (cuentas de huésped, se encuentran con reservation_ids), pagos de folios y facturas.
• Operaciones e informes: ventanas de mantenimiento, rendimiento del establecimiento (ocupación, ADR, RevPAR), ingresos por cuenta con neto, bruto e IVA (para un periodo de un año como máximo) y llegadas por día de un mes.

Qué escribe:

• Reservas: apaleo_create_booking con el ratePlanId y un timeSlice por noche tomados de apaleo_get_offers. apaleo_update_booking y apaleo_update_reservation aceptan operaciones JSON Patch como [{"op": "replace", "path": "/comment", "value": "Late arrival"}]. apaleo_amend_reservation cambia llegada, salida, número de huéspedes, plan de tarifa y precio por noche.
• Recepción: apaleo_assign_unit (apaleo elige una habitación libre) o apaleo_assign_specific_unit, apaleo_unassign_units, apaleo_check_in_reservation (se deshace con apaleo_revert_check_in) y apaleo_check_out_reservation, que carga en el folio todos los cargos abiertos y solo funciona si la salida no es después de mañana.
• Housekeeping y mantenimiento: apaleo_set_unit_conditions (Clean, CleanToBeInspected, Dirty) y apaleo_create_maintenance (OutOfService, OutOfOrder, OutOfInventory).

Las reservas, check-ins y check-outs cambian el hotel en vivo, así que la IA te muestra lo que va a cambiar y espera tu sí.

Desactivadas al instalar: apaleo_cancel_reservation (se aplica la penalización de la política del plan de tarifa y una estancia cancelada no se puede reactivar) y apaleo_set_reservation_no_show (carga la penalización de no-show en el folio y no se puede revertir). Un admin las activa cuando el equipo las necesite.

Formatos de datos: los ids son códigos legibles: un establecimiento MUC, un unit group MUC-DBL, una unit MUC-101, un plan de tarifa MUC-FLEX-DBL, una reserva ABCDEF, sus estancias ABCDEF-1 y ABCDEF-2, un folio ABCDEF-1-1. Los importes son {"amount": 120.0, "currency": "EUR"} en unidades enteras; el balance de una estancia es negativo cuando el huésped aún debe dinero. Las fechas son YYYY-MM-DD; las horas son ISO 8601 con el desfase UTC del establecimiento. Una noche pertenece al día operativo en que empieza; to se incluye en disponibilidad y rendimiento y se excluye en el informe de ingresos. El estado de una estancia es Confirmed, InHouse, CheckedOut, Canceled o NoShow. Los filtros con varios valores van separados por comas sin espacios (status: Confirmed,InHouse) y expand añade objetos incrustados (expand: booker,assignedUnits).

Paginación: las listas aceptan page_number (desde 1) y page_size (hasta 500) y devuelven el total en count. Una página más allá del final responde 204 No Content: no hay nada más.

Errores frecuentes: 401 significa un client id o secret incorrecto o un token caducado. 403 significa que a la custom app le falta un permiso. 404 es un id desconocido. 422 es una regla de negocio, por ejemplo un check-in antes del día de llegada, ninguna habitación asignada o una oferta agotada, con el motivo en messages. 429 es el límite de peticiones.

El conector no carga conceptos ni pagos, no crea facturas, no cambia planes de tarifa, precios ni inventario y no gestiona usuarios ni apps de apaleo.

Requisitos previos: APALEO_CLIENT_ID, APALEO_CLIENT_SECRET

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige apaleo e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué estancias llegan hoy a MUC y cuáles todavía no tienen habitación asignada?"
• "¿Cuántas habitaciones dobles quedan libres el próximo viernes y sábado, y cuánto cuesta la tarifa flexible por las dos noches?"
• "Muéstrame ocupación, ADR y RevPAR del mes pasado comparados con el mes anterior."
• "Asigna una habitación limpia a la estancia ABCDEF-1 y haz el check-in del huésped."
• "Marca las habitaciones de MUC-101 a MUC-105 como limpias y pon MUC-210 fuera de servicio hasta el lunes por una ducha rota."

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT