Conectar un asistente de IA

Puedes conectar tu propio asistente de IA (Claude, ChatGPT, Grok, Claude Code
o un agente que corra en tu computador) a Aloha Hospitality y manejar el hotel
desde la conversación: preguntar cómo viene el día, revisar disponibilidad,
cotizar una estadía o preparar un cambio de precios.

La conexión usa MCP (Model Context Protocol), el estándar con el que estos
asistentes se conectan a otros sistemas. No necesitas una API key ni programar
nada: el asistente se autoriza con tu usuario, como cuando inicias sesión en el
panel.

Quién puede conectar uno

Cada persona conecta su propio asistente, con su propio usuario. El
asistente ve y hace exactamente lo que tu rol permite, nada más.

Para conectar uno necesitas ser el dueño de la cuenta o tener el permiso
Conectar asistentes de IA (Claude, ChatGPT) a esta cuenta, que se otorga en
Configuración → Equipo → Roles. Sin ese permiso, la pantalla de autorización explica
que no puedes conectar y no ofrece el botón para aprobar.

La URL del conector

https://mcp.hospitality.aloha.co/mcp

También la encuentras, con un botón para copiarla, en Configuración →
Asistentes de IA.

Conectarlo, paso a paso

Claude (web, escritorio y móvil)

1. En Claude, abre Configuración → Conectores.
2. Elige Agregar conector personalizado y pega la URL del conector.
3. Claude abre la pantalla de Aloha Hospitality: inicia sesión y autoriza.

Una vez conectado desde la web, también queda disponible en la app de
escritorio y en la móvil.

ChatGPT

1. En ChatGPT, abre Configuración → Conectores (o Apps, según tu plan).
2. Agrega un conector personalizado con la URL del conector.
3. Inicia sesión con tu usuario de Aloha Hospitality y autoriza.

Qué planes de ChatGPT permiten conectores personalizados, y si pueden hacer
cambios o solo leer, lo decide OpenAI. Revisa la ayuda de ChatGPT para tu plan.

Grok

1. En grok.com, abre Conectores y elige Nuevo conector → Personalizado.
2. Pega la URL del conector.
3. Inicia sesión y autoriza.

Claude Code y agentes locales

En la terminal:

claude mcp add --transport http aloha-hospitality https://mcp.hospitality.aloha.co/mcp

Luego, dentro de Claude Code, ejecuta /mcp y elige aloha-hospitality para
iniciar sesión. Otros agentes que corren en tu computador (como el MCP
Inspector) se conectan igual: con la URL del conector y el inicio de sesión en
el navegador.

Qué ves al autorizar

1. Inicias sesión con tu email y contraseña de Aloha Hospitality. Si tienes
   una contraseña temporal, primero tienes que cambiarla desde el panel.
2. Eliges la cuenta. Si perteneces a más de una, escoges a cuál se conecta
   el asistente. Una conexión es una cuenta; para usar otra, conecta el
   asistente de nuevo.
3. Apruebas. La pantalla muestra el nombre del asistente, la cuenta, lo que
   podrá hacer y, en grande, la dirección a la que volverás (por ejemplo
   claude.ai o chatgpt.com).

Fíjate en esa dirección antes de aprobar. El nombre lo declara la propia
aplicación y Aloha Hospitality no puede comprobarlo; la dirección sí es
verificable. Si la conexión es para una aplicación de tu propio computador, la
pantalla lo indica.

Qué puede hacer el asistente

Consultar

• Tus propiedades, unidades y su configuración.
• Disponibilidad para unas fechas y cotización exacta de una estadía, calculada
  igual que una reserva.
• Reservas: listado, el detalle de cada una, cómo se armó su precio noche a
  noche, sus folios, sus links de pago, su historial de cambios y si llegó bien
  a los canales. El asistente puede pedir hasta 25 reservas en una sola consulta.
• El calendario de reservas de una propiedad.
• Huéspedes: nombre, email, teléfono, país y su historial de estadías.
• Tarifas, el calendario de precios y estadías mínimas.
• El día en una propiedad: llegadas, salidas, huéspedes en casa, check-ins
  digitales pendientes y overbookings.
• El tablero y las tareas de housekeeping.
• Las conversaciones con huéspedes por WhatsApp y por las OTAs, y las
  plantillas de WhatsApp aprobadas. Leerlas no las marca como leídas.
• Indicadores (ocupación, ingresos, ADR, RevPAR) y saldos por cobrar, si tu rol
  tiene acceso a finanzas.

Proponer cambios

• Crear y editar unidades.
• Crear y editar tarifas y sub-tarifas, y fijar precios por día.
• Crear una reserva directa para un huésped que ya existe, y cambiar las fechas,
  la unidad o la cantidad de huéspedes de una reserva. El precio se recalcula con
  su tarifa, y nunca crea un overbooking.
• Cambiar el estado de una reserva: confirmar, hacer check-in o check-out,
  cancelar o reactivar.
• Agregar un cargo manual al folio de una reserva (un late checkout, el
  minibar), con las reglas de impuestos de la propiedad.
• Crear un link de pago de Aloha para una reserva. El link no se le envía al
  huésped: el asistente te da la dirección para que la compartas.
• Enviar una plantilla de WhatsApp aprobada a un huésped. No puede escribir
  texto libre ni responder una conversación.
• Crear tareas de housekeeping, cambiar su estado y marcar habitaciones como
  limpias, sucias o inspeccionadas.
• Crear y quitar bloqueos de venta, y bloquear o liberar una unidad por
  mantenimiento.

El asistente no borra unidades, tarifas, reservas ni huéspedes.
No cobra ni reembolsa: puede cargar un consumo a un folio o crear un link
para que el huésped pague, pero no registra pagos, no hace cobros a una tarjeta,
no reembolsa ni emite facturas. Tampoco crea huéspedes: eso se hace en el
panel.

Ningún cambio se aplica sin que lo confirmes

Cada cambio pasa por dos pasos:

1. El asistente prepara el cambio y te muestra una vista previa: qué cambia,
   de qué valor a qué valor y qué efectos tiene (por ejemplo, que el precio se
   enviará a los canales).
2. El cambio se aplica solo cuando lo confirmas en la conversación.

La confirmación vale para ese cambio exacto, una sola vez, y vence a los 5
minutos. Si vence, o si lo que ibas a cambiar se modificó mientras tanto (otra
persona editó la tarifa, por ejemplo), el asistente tiene que preparar el
cambio de nuevo y volver a preguntarte.

Los cambios de precios, disponibilidad y bloqueos se sincronizan con tus
canales igual que si los hicieras desde el panel. Cada cambio queda en el
registro de actividad a tu nombre.

Límites

Las propiedades en hibernación no responden al asistente hasta que se
reactiven.

Cuánto dura la conexión

La conexión se mantiene mientras la uses. Si un asistente pasa 30 días sin
usarse, tendrás que conectarlo de nuevo.

Desconectar un asistente

En Configuración → Asistentes de IA ves los asistentes conectados, desde
cuándo y cuándo se usaron por última vez. Desconectar le corta el acceso en
el acto; para volver a usarlo tendrá que autorizarse otra vez.

Cada persona ve y desconecta sus propios asistentes. El dueño de la cuenta, y
quien tenga permiso para administrar el equipo, ve y puede desconectar los de
todos.

Privacidad

Lo que el asistente consulta llega al proveedor del asistente (Anthropic,
OpenAI, xAI u otro) y se trata según sus políticas. Para limitarlo:

• De los huéspedes, el asistente recibe sus datos de contacto y el texto de
  sus conversaciones con el hotel, si tu rol puede verlas. Nunca documentos de
  identidad, fechas de nacimiento, datos fiscales ni datos de tarjetas.
• Ve solo las propiedades, unidades y datos que tu rol permite.
• Los textos de tus datos (notas, nombres, descripciones, mensajes de
  huéspedes) se le entregan como datos, nunca como instrucciones: un huésped no
  puede darle órdenes al asistente escribiéndole al hotel.