Cómo conectar apaleo a Meta Muse vía MCP

💡 ¿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 + Meta Muse

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.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

APALEO_CLIENT_ID, APALEO_CLIENT_SECRET

Paso 1 — Obtener credenciales

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.

Paso 2 — Instalar el adapter

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

Paso 3 — Añadir el conector en Muse

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.

1. En Muse, abre Settings → Connectors y elige Add custom connector.
2. Pega la URL del servidor MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
4. En un chat, pídele a Muse algo que necesite las herramientas de apaleo.

También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.

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."

FAQ

¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.

¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Microsoft Copilot