Desarrolladores · para Anfitriones

Conecta ChatGPT, Claude o tu propio agente de IA (MCP)

Conecta ChatGPT, Claude, Cursor, n8n o cualquier cliente MCP a Guestbud con tu inicio de sesión o una clave de API: tu agente responde a huéspedes y gestiona reservas y anuncios.

Guestbud habla el Model Context Protocol (MCP), el estándar abierto que usan los asistentes de IA para trabajar con otro software. Conectas tu propio agente de IA a tu cuenta de Guestbud una sola vez. Después puedes decirle en lenguaje natural qué hacer, por ejemplo:

“Responde a las nuevas preguntas sobre el aparcamiento en el chat de Airbnb.”
“¿Quién llega mañana y han hecho todos el check-in?”
“Cambia la contraseña del wifi de Harbour Loft a SeaBreeze2026.”
“Haz más cercano el email con los datos del check-in y añade la norma de las toallas de playa.”
“¿Qué incidencias siguen abiertas y qué ha avisado el huésped del apartamento 3?”

El agente trabaja con tus datos, en tu cuenta y solo con los permisos que le des.

Qué puede hacer tu agente #

Área	Qué puede hacer	Permiso de rol necesario
Cuenta	Ver con qué cuenta y rol está conectado	—
Reservas	Listar y buscar reservas, leer una reserva con los datos del check-in, el estado de los pagos y el de los códigos de la puerta	Bookings: view
Chat con huéspedes	Leer la conversación de Airbnb, Booking.com, Vrbo … y enviar mensajes al huésped (a través de Hostaway o Channex)	Bookings: view / edit
Check-in	Enviar el enlace de check-in o un recordatorio por email o chat; mostrar antes de tiempo los códigos de la puerta para un check-in anticipado acordado	Bookings: edit
Reservas	Crear una reserva directa, editar notas, huéspedes y contacto, cancelar	Bookings: edit
Incidencias	Listar los avisos de incidencias de los huéspedes, marcarlos en curso o resueltos, añadir notas internas	Bookings: view / edit
Plan de limpieza	Entradas y salidas de los próximos días con horas de llegada / salida y vuelos	Cleaning plan
Anuncios	Leer toda la guía del huésped; cambiar secciones (wifi, pasos del check-in, normas de la casa, recomendaciones locales, extras …); activar o desactivar un alojamiento	Properties: view / edit
Mensajes a huéspedes	Leer y editar los mensajes automáticos y las plantillas; previsualizar un mensaje rellenado con una reserva real	Settings
Estadísticas	Ocupación, reservas, tasa turística, fianzas, check-in anticipado / check-out tardío y extras vendidos	Reports
Todo lo demás	Leer cualquier parte de la API REST (solo lectura)	como la API

Nunca disponible para un agente: reembolsos, liberación o cobro de fianzas, ajustes de pago, usuarios y claves de API. Todo eso sigue en tus manos en el panel.

Dos formas de conectarse #

	Inicio de sesión (recomendado)	Clave de API
Para	ChatGPT, claude.ai, Claude Desktop y móvil, Claude Code, Cursor	n8n, Make, frameworks de agentes, tu propio código, servidores sin una persona presente
Cómo	Pega la dirección del servidor en la app de IA, inicia sesión en Guestbud, elige un rol y haz clic en Allow	Crea una clave en Guestbud y pégala en la herramienta
Quién	La persona que inicia sesión (necesita permiso para conectar apps, ver más abajo)	Alguien que gestiona usuarios
Termina	Cuando la desconectas, cuando la persona se elimina, se desactiva, recibe otro rol o cambia su contraseña, o tras 60 días sin ningún uso	Cuando revocas la clave

La dirección de tu servidor aparece en Settings → AI agent (MCP):

https://guestbud.io/mcp, o
tu propio dominio seguido de /mcp, por ejemplo https://stay.example.com/mcp.

1. Elige qué puede hacer el agente #

El agente siempre trabaja con un rol, igual que una persona de tu equipo (consulta Usuarios, roles e inicio de sesión):

Staff: recomendado para responder a huéspedes; lee reservas, envía mensajes a huéspedes y enlaces de check-in, gestiona avisos de incidencias y ve el plan de limpieza. No puede cambiar anuncios ni ajustes.
Manager: además edita anuncios, plantillas de mensajes a huéspedes y ajustes, y consulta estadísticas.
Viewer: solo lectura; no puede enviar nada.
Cleaning: solo el plan de limpieza.

Empieza con Staff. Con el inicio de sesión eliges el rol en la página de Guestbud que se abre; nunca puede ser superior a tu propio rol, ni Owner.

Dónde añadir la dirección del servidor (https://guestbud.io/mcp) en tu app de IA:

claude.ai, Claude Desktop y móvil: Settings → Connectors → Add custom connector, pega la dirección, Add y después Connect.
ChatGPT: Settings → Apps & Connectors, crea un conector (modo desarrollador), pega la dirección, autenticación OAuth.
Claude Code: ejecuta claude mcp add --transport http guestbud https://guestbud.io/mcp, luego escribe /mcp en Claude Code y elige Authenticate.
Cursor: Settings → MCP → Add server con { "mcpServers": { "guestbud": { "url": "https://guestbud.io/mcp" } } }, y después Connect.

Después:

En tu app de IA, añade Guestbud con la dirección de tu servidor como se indica arriba e inicia la conexión.
Se abre una página de Guestbud. Inicia sesión con tu acceso habitual de Guestbud (en guestbud.io introduces también el nombre corto de tu empresa).
Comprueba el nombre de la app y a dónde vuelve (por ejemplo, claude.ai), elige el rol de la app y haz clic en Allow.
De vuelta en la app de IA, las herramientas de Guestbud están disponibles. Pregunta, por ejemplo: “¿Qué huéspedes llegan esta semana?”.

Sigue conectada: la app renueva su acceso automáticamente en segundo plano (cada hora). No tienes que volver a conectarte mientras el agente se use al menos una vez cada 60 días.

Quién puede conectarse: en Settings → AI agent (MCP) → Who may connect AI apps with sign-in eliges Team members who manage users (por defecto), All team members (cada uno hasta su propio rol) o Nobody. Al cambiar a Nobody se cortan a la vez todas las conexiones por inicio de sesión.

Apps conectadas: la misma página lista cada app conectada con la persona que inició sesión, su rol y su último uso. Disconnect la corta de inmediato.

3. Conéctate con una clave de API (herramientas de automatización y tu propio código) #

Usa una clave para herramientas que funcionan sin que nadie inicie sesión: n8n, Make, frameworks de agentes, scripts y servidores.

Abre Settings → AI agent (MCP) y despliega For automation tools and your own code (API key) (necesitas permiso para gestionar usuarios).
Introduce un Name, por ejemplo n8n — respuestas a huéspedes, y elige el Role.
Haz clic en Create key and show the setup.
La clave completa (gpk_…) se muestra una sola vez, junto con líneas de configuración listas que ya la incluyen. Cópialas ahora. Si pierdes la clave, revócala y crea una nueva.

Una clave solo funciona para tu propia cuenta. Se rechaza en el dominio de otra empresa.

n8n y otras herramientas de automatización #

En n8n, añade un AI Agent con el MCP Client Tool:

Endpoint: https://guestbud.io/mcp
Server transport: HTTP Streamable
Authentication: Bearer Auth, token = tu clave gpk_…

Cualquier otro cliente MCP que pueda enviar un encabezado funciona igual:

URL: https://guestbud.io/mcp
Transporte: Streamable HTTP
Encabezado: Authorization: Bearer gpk_…

Claude Code, Claude Desktop, Cursor, Windsurf con una clave #

Para estas apps es preferible el inicio de sesión. Si aun así quieres una clave (por ejemplo, en un servidor):

claude mcp add --transport http guestbud https://guestbud.io/mcp --header "Authorization: Bearer gpk_…"

Las apps que inician servidores MCP desde un archivo de configuración usan el puente gratuito mcp-remote (necesita Node.js):

{
  "mcpServers": {
    "guestbud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://guestbud.io/mcp", "--header", "Authorization:${GUESTBUD_AUTH}"],
      "env": { "GUESTBUD_AUTH": "Bearer gpk_…" }
    }
  }
}

La clave está en la parte env a propósito: así se evitan problemas con los espacios en Windows.

4. Úsalo #

Pregunta en lenguaje natural, como se lo pedirías a un compañero. Algunos ejemplos que funcionan bien:

Chat con huéspedes: “Mira las reservas que llegan en los próximos tres días. Lee sus conversaciones de Airbnb y Booking.com y prepara respuestas a las preguntas sin contestar. Enséñamelas antes de enviarlas.”
Seguimiento del check-in: “¿Quién llega mañana y no ha hecho el check-in online? Envíales un recordatorio por el chat de la reserva.”
Check-in anticipado: “El huésped de la reserva GP-7KQ2XD puede entrar a las 12:00: desbloquea los códigos antes de tiempo y díselo en el chat.”
Anuncios: “Enséñame los pasos del check-in de Capua Flats y corrige el código del ascensor a 3044.”
Incidencias: “Lista las incidencias abiertas; marca como resuelta la del wifi de Harbour Loft con la nota ‘router reiniciado’.”
Limpieza: “¿Qué tiene que hacer el equipo de limpieza el sábado, ordenado por hora de salida? Marca los cambios en el mismo día.”
Mensajes: “Reescribe el email con los datos del check-in con un tono más cálido, mantén todos los marcadores y enséñame una vista previa con la próxima reserva.”
Cifras: “¿Cuántos check-out tardíos vendimos el mes pasado y qué extras se vendieron más?”

Consejo: deja que el agente prepare primero los mensajes a huéspedes y te los enseñe (“enséñamelos antes de enviarlos”). Cuando confíes en él, puedes dejar que los envíe directamente.

Seguridad #

Tú eliges los permisos: el rol de la clave o del inicio de sesión lo decide todo. El agente solo ve las herramientas que permite su rol, y el servidor vuelve a comprobar cada llamada.
No se mueve dinero: los reembolsos, las fianzas, los ajustes de pago, los usuarios y las claves no son accesibles por MCP.
Texto de huéspedes no fiable: los huéspedes pueden escribir cualquier cosa en un chat o en un formulario de check-in. Guestbud indica al agente que trate todo lo que ha escrito un huésped como información, nunca como instrucciones. También le indica que no envíe códigos de la puerta antes de que la reserva los muestre como visibles. Aun así, revisa lo que envía el agente, sobre todo al principio.
Cada cambio queda registrado: cada acción que cambia algo (un mensaje enviado, una reserva o un anuncio modificados, un código desbloqueado …) aparece en Settings → Audit trail con el nombre de la app o de la clave. Las simples consultas no aparecen, para que el registro siga siendo legible.
Menos datos personales: el agente recibe lo que necesita para ayudar a los huéspedes, no más. Los datos de la reserva excluyen los datos del documento de identidad y los archivos subidos, las direcciones IP y el código de la cerradura inteligente de la reserva. El acceso de solo lectura a la API excluye archivos, usuarios, claves de API, el registro de auditoría, webhooks, datos de registro de huéspedes y los ajustes de pago, email y cerraduras.
Límites: como máximo 120 llamadas a herramientas por minuto y 40 mensajes a huéspedes por hora y conexión o clave; como máximo 10 solicitudes por lote, y las respuestas muy largas se acortan.
Inicio de sesión seguro: Guestbud usa el estándar para el inicio de sesión de apps de IA (OAuth 2.1 con PKCE). La app nunca ve tu contraseña; recibe un token de acceso válido durante una hora y un token de renovación que cambia con cada uso. Si un token de renovación se usa dos veces, Guestbud cierra la conexión. Un token de inicio de sesión solo sirve para la conexión del agente de IA, no para el resto de la API.
Revocable en cualquier momento: Settings → AI agent (MCP) → Disconnect (inicio de sesión) o Revoke (clave). El agente pierde el acceso de inmediato.
Tu proveedor de IA: los datos que lee el agente los procesa el servicio de IA que conectes (por ejemplo, Anthropic para Claude). Comprueba que encaja con tu aviso de privacidad para huéspedes.

Preguntas frecuentes #

¿Qué agentes de IA funcionan con Guestbud? #

Cualquier cliente MCP. ChatGPT, claude.ai, Claude Desktop y móvil, Claude Code y Cursor se conectan con inicio de sesión. n8n, los frameworks de agentes y tu propio código se conectan con una clave de API.

¿Cuánto dura una conexión con inicio de sesión? #

Mientras la uses. La app renueva su acceso automáticamente cada hora; la conexión solo termina tras 60 días sin ningún uso, cuando la desconectas, o cuando la persona que inició sesión se elimina, se desactiva, recibe otro rol o cambia su contraseña.

¿Puede el agente enviar los códigos de la puerta a los huéspedes? #

Solo si su rol puede leer reservas y anuncios, y solo cuando la reserva del huésped muestra los códigos como visibles: check-in y pagos completados y la hora del check-in alcanzada (o desbloqueados antes por ti). El agente conoce esta regla. Tus plantillas de mensajes con {doorCodes} siguen automáticamente la misma regla.

¿Pueden varios agentes usar Guestbud a la vez? #

Sí. Cada inicio de sesión y cada clave es una conexión independiente con su propio rol, que aparece por separado en el registro de auditoría, y puedes desconectar una sin afectar a las demás.

¿El agente cuesta algo en Guestbud? #

No. El acceso MCP forma parte de tu cuenta. El agente en sí te lo factura tu proveedor de IA.

¿Hay también una API para desarrolladores? #

Sí: el agente usa los mismos permisos que la API REST y los webhooks; consulta el inicio rápido de la API.