Concierge

Desarrolladores

Conecte un asistente de IA a Concierge

Concierge publica dos servidores para el protocolo abierto Model Context Protocol (MCP). El servidor para hoteles da a un miembro del equipo que ha iniciado sesión las herramientas que permite su rol, protegidas por OAuth 2.1 con PKCE; el servidor para huéspedes ofrece el perfil y las FAQ de un establecimiento publicado y, cuando un huésped verifica su número de WhatsApp, sus propias estancias. Toda escritura visible para los huéspedes o destructiva espera la confirmación de la persona.

  • Dos servidores MCP
  • OAuth 2.1 con PKCE
  • Metadatos publicados
  • Indicaciones de solo lectura y destructivas
  • Confirmación antes de escrituras visibles para huéspedes
Solicitar una demo Cómo conectarse

Endpoints

Dos servidores MCP: uno para su equipo, otro para huéspedes

Ambos hablan MCP sobre Streamable HTTP: un solo endpoint y cada operación es un POST. Cada servidor es su propio servidor de autorización OAuth 2.1, con su propio emisor y su propia clave de firma.

Los endpoints se publican cuando se abra el servicio

Abajo están las rutas en las que responde cada servidor. Los nombres de host llegarán cuando se abra el servicio; hasta entonces, pídanos acceso anticipado.

Pedir acceso anticipado

Servidor para hoteles

Para el asistente de su equipo

Assistant Access Disponible

Un miembro del equipo que ha iniciado sesión recibe las herramientas que permite su rol. El token es de corta duración y está vinculado a este servidor, y la plaza de la persona se comprueba de nuevo en cada llamada.

Host
Se publica cuando se abra el servicio
Endpoint MCP
/mcp
Metadatos del recurso · RFC 9728
/.well-known/oauth-protected-resource
Metadatos del servidor de autorización · RFC 8414
/.well-known/oauth-authorization-server

Ámbitos

concierge.read
Leer la bandeja de entrada, escalados, estancias, FAQ, analíticas e informes
concierge.write
Cambios internos: entradas de FAQ, escalados, estancias y borradores
concierge.send
Mensajes que llegan a los huéspedes por WhatsApp
concierge.admin
La consola del grupo y las operaciones de la plataforma

Servidor para huéspedes

Para los asistentes de sus huéspedes

Guest Assistant Bajo petición

El endpoint público no requiere inicio de sesión: el perfil, los contactos públicos y las FAQ de un establecimiento publicado. El endpoint personal añade las estancias y los mensajes propios del huésped, después de que verifique su número de WhatsApp.

Host
Se publica cuando se abra el servicio
Endpoint público · sin inicio de sesión
/mcp
Endpoint personal · tras verificar WhatsApp
/mcp/me
Metadatos del recurso · RFC 9728
/.well-known/oauth-protected-resource

Ámbitos

guest.read
Las estancias y conversaciones del huésped y las FAQ del establecimiento
guest.message
Escribir al hotel y abrir una solicitud en nombre del huésped
guest.data
Consentimiento, nombre visible, conexiones y solicitudes de datos

Inicio de sesión y seguridad

¿Cómo inicia sesión un asistente?

El equipo inicia sesión con su acceso habitual de Concierge, y los huéspedes demuestran su número de WhatsApp en las propias páginas de Concierge, nunca dentro del asistente. Cada llamada vuelve a comprobar la plaza de la persona, el establecimiento y el ámbito.

  • OAuth 2.1 con PKCE

    El flujo de código de autorización con PKCE (S256) es obligatorio, solo para clientes públicos. Los tokens de actualización rotan en cada uso, y uno reutilizado revoca toda la cadena.

  • Metadatos publicados

    Los metadatos del recurso (RFC 9728) y del servidor (RFC 8414) indican a un cliente dónde iniciar sesión tras un 401. Los clientes se registran con un documento de metadatos o de forma dinámica.

  • Una indicación en cada herramienta

    Cada herramienta indica si solo lee y si es destructiva, y tools/list muestra solo lo que permiten la plaza de la persona y los ámbitos del token.

  • Un token, un servidor

    Los tokens de acceso están firmados con ES256, duran sesenta minutos y nombran el servidor que los emitió, así que el servidor para huéspedes rechaza un token del servidor para hoteles.

Toda escritura visible para huéspedes o destructiva espera la confirmación de la persona

Un cliente con la revisión 2026-07-28 del protocolo muestra el resumen de Concierge como un formulario dentro del asistente. Cualquier otro cliente recibe un enlace a una página de confirmación de Concierge y vuelve a llamar a la herramienta cuando la persona ha aprobado.

  1. El asistente lo pide

    Llama a una herramienta de escritura como conversation_reply. Todavía no ha pasado nada.

  2. Concierge escribe el resumen

    El servidor, no el asistente, dice lo que va a pasar. La persona lo aprueba o lo rechaza.

  3. Se ejecuta una vez y queda registrado

    La aprobación es de un solo uso, está vinculada a la persona, la herramienta y sus argumentos, y caduca a los cinco minutos. El registro de auditoría nombra a la persona y al asistente.

Conectar

Añada Concierge a su asistente

Los asistentes compatibles con MCP se conectan de la misma forma, como Claude de Anthropic, ChatGPT de OpenAI y Microsoft Copilot. Su administración de grupo decide cuáles puede conectar su equipo; los huéspedes eligen el suyo.

  1. Añada la URL del servidor

    Pegue el endpoint para hoteles o el de huéspedes donde su asistente añade un conector personalizado o un servidor MCP.

  2. Inicie sesión cuando se lo pida

    La primera llamada responde 401 con la dirección de los metadatos. El equipo usa su acceso de Concierge; los huéspedes verifican su número de WhatsApp.

  3. Permita la conexión

    La permite una vez, para un establecimiento. Para el equipo, el asistente debe estar en la lista que su administración de grupo ha permitido, que empieza vacía.

mcp.json Configuración de cliente de ejemplo 
{
  "mcpServers": {
    "concierge": {
      "type": "http",
      "url": "https://<business-host>/mcp"
    },
    "concierge-guest": {
      "type": "http",
      "url": "https://<guest-host>/mcp/me"
    }
  }
}

Los dos nombres de host se envían con el acceso anticipado.

La primera llamada, antes de iniciar sesión

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="mcp",
  resource_metadata="…/.well-known/oauth-protected-resource"

Herramientas

¿Qué puede hacer un asistente?

Una selección de ambos servidores. La lista que ve un asistente depende de la persona y de la conexión: se omite una herramienta que la plaza de la persona nunca podría abrir, y también una escritura para la que el token no tiene ámbito.

  • inbox_list Solo lectura

    La bandeja de entrada, paginada y filtrada, con los números de teléfono enmascarados.

    Servidor
    Hoteles
    Ámbito
    concierge.read
    Confirmación
    Sin confirmación
  • conversation_get Solo lectura

    Una conversación con sus mensajes, el nombre del huésped y la estancia vinculada.

    Servidor
    Hoteles
    Ámbito
    concierge.read
    Confirmación
    Sin confirmación
  • broadcast_preview Solo lectura

    Una simulación de una campaña: a quién llega y a quién omite. No envía nada.

    Servidor
    Hoteles
    Ámbito
    concierge.read
    Confirmación
    Sin confirmación
  • faq_create Escritura

    Añade la versión en un idioma de una pregunta de las FAQ. Tiene efecto inmediato.

    Servidor
    Hoteles
    Ámbito
    concierge.write
    Confirmación
    Sin confirmación
  • conversation_reply Destructiva

    Pone en cola una respuesta del equipo por WhatsApp cuando la persona confirma el texto exacto.

    Servidor
    Hoteles
    Ámbito
    concierge.send
    Confirmación
    Con confirmación
  • stay_checkout Destructiva

    Registra la salida de una estancia: el código QR de la estancia deja de funcionar y la conversación se cierra.

    Servidor
    Hoteles
    Ámbito
    concierge.write
    Confirmación
    Con confirmación
  • broadcast_send Destructiva

    Pone en cola una campaña cuando la persona confirma a cuántos huéspedes llega y cuántos se omiten.

    Servidor
    Hoteles
    Ámbito
    concierge.send
    Confirmación
    Con confirmación
  • search_faq Solo lectura

    Respuestas ordenadas de las FAQ en vivo de un establecimiento publicado para la pregunta de un huésped.

    Servidor
    Huéspedes · público
    Ámbito
    Sin inicio de sesión
    Confirmación
    Sin confirmación
  • get_property Solo lectura

    El perfil público de un establecimiento publicado. Nunca su número de WhatsApp.

    Servidor
    Huéspedes · público
    Ámbito
    Sin inicio de sesión
    Confirmación
    Sin confirmación
  • my_stays Solo lectura

    Las estancias propias del huésped. Nunca un código de check-in ni un enlace QR de la estancia.

    Servidor
    Huéspedes · personal
    Ámbito
    guest.read
    Confirmación
    Sin confirmación
  • message_hotel Escritura

    Publica el mensaje del huésped en su conversación; la respuesta de las FAQ vuelve al asistente.

    Servidor
    Huéspedes · personal
    Ámbito
    guest.message
    Confirmación
    Con confirmación
  • request_data_deletion Destructiva

    Pide al grupo hotelero que elimine los datos del huésped, con un plazo de treinta días.

    Servidor
    Huéspedes · personal
    Ámbito
    guest.data
    Confirmación
    Con confirmación

tools/list devuelve a su asistente la lista completa para la persona que ha iniciado sesión.

Los rechazos son errores de herramienta

Un rechazo vuelve como un error de herramienta cuyo texto empieza con un código legible por máquina, para que el asistente pueda decir qué falló. Un establecimiento desconocido y uno al que usted no tiene acceso responden ambos not_found.

  • unauthorized
  • no_property
  • not_found
  • forbidden
  • module_not_entitled
  • invalid_argument
  • insufficient_scope
  • conflict
  • unavailable
  • confirmation_required
  • declined
  • expired
  • not_approved

Lo que un asistente nunca recibe

  • El número de teléfono completo de un huésped: está enmascarado en cada resultado y exportación.
  • El número de WhatsApp, la cuenta o el enrutamiento de un establecimiento.
  • Códigos de check-in o enlaces QR de la estancia.
  • Una contraseña: ninguna herramienta acepta una como argumento.
  • Texto escrito por huéspedes como instrucciones: cada resultado lo marca como datos.

Documentación

Consulte los detalles

Los servidores se describen a sí mismos en sus metadatos publicados, y este sitio publica un resumen en texto plano para asistentes de IA y motores de respuesta.

  • llms.txt

    Un resumen de Concierge en texto plano para asistentes de IA y motores de respuesta, con un enlace a todo el texto del sitio.

    Abrir llms.txt

  • Metadatos de los servidores

    Cada servidor publica metadatos del recurso (RFC 9728) y del servidor de autorización (RFC 8414): el recurso, los ámbitos y dónde están las claves.

    Se publica cuando se abra el servicio

    Pedir acceso anticipado

  • Seguridad y privacidad

    Alojamiento en la UE, los datos de cada hotel separados de los de otro, enmascaramiento, consentimiento, el registro de auditoría y dónde terminan nuestros controles.

    Leer la página de seguridad

  • Informar de una vulnerabilidad

    Nuestro contacto de seguridad, legible por máquina según RFC 9116. Avísenos en privado antes de publicar nada.

    Abrir security.txt

Solicite una demo o pregúntenos lo que quiera

Cuéntenos cómo es su establecimiento y le mostraremos Concierge con sus propias preguntas. Respondemos en un día laborable.

Solicitar una demo