Cómo conectar Lodgify a Gemini vía MCP

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

Lodgify + Gemini

Gestión de alquiler vacacional con Lodgify: alojamientos y tipos de habitación, calendarios de disponibilidad, tarifas por noche y presupuestos, reservas y consultas, conversaciones con huéspedes, check-in y check-out, códigos de acceso y cambios de estado de las reservas. Funciona con la clave Public API de la cuenta.

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:

LODGIFY_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas al propietario de la cuenta de Lodgify, porque solo él ve la clave API.

1. En Lodgify (https://app.lodgify.com) abre Settings > Public API y copia la clave API.
2. Pégala en LODGIFY_API_KEY. Se envía en la cabecera X-ApiKey.
3. Instala el conector y ejecuta lodgify_list_properties para comprobar la clave.

La clave da acceso completo a la cuenta: todos los que usan este conector trabajan con cada alojamiento, reserva y conversación con huéspedes de la cuenta.

Qué lee:

• Alojamientos y tipos de habitación: lodgify_list_properties, lodgify_get_property, lodgify_list_property_rooms (los ids de tipo de habitación que necesitan tarifas, disponibilidad, presupuestos y reservas), lodgify_get_room, alojamientos eliminados desde una fecha y los extras y formas de pago de un alojamiento.
• Disponibilidad: el calendario de toda la cuenta, de un alojamiento o de un tipo de habitación para un periodo, opcionalmente con las reservas y periodos cerrados que bloquean las fechas.
• Precios: tarifas por noche y estancia mínima por día (lodgify_get_rates_calendar), ajustes de tarifa (impuestos, cargos, depósito, reglas de cancelación, precio por huésped adicional) y lodgify_get_quote, el total de una posible estancia con tarifa, cargos, impuestos, extras y código promocional.
• Reservas: lodgify_list_bookings con stay_filter Upcoming, Current, Historic, All, o ArrivalDate y DepartureDate junto con stay_filter_date (por ejemplo las llegadas de hoy); lodgify_get_booking con huésped, habitaciones, totales, importe pagado y pendiente, notas, códigos de acceso y la conversación; reservas de canales vinculadas (Airbnb, Booking.com, Vrbo, ...); el presupuesto de la reserva y el enlace de pago para el huésped.
• Bandeja de entrada: lodgify_list_inbox (reservas y consultas juntas, de la más reciente a la más antigua), lodgify_count_unread, lodgify_get_enquiry y lodgify_get_thread con el thread_uid de una reserva o consulta.

Qué escribe:

• Nueva reserva: la IA comprueba lodgify_get_room_type_availability y lodgify_get_quote y luego llama a lodgify_create_booking. Ahí Lodgify ignora el estado, así que la IA confirma después la reserva con lodgify_set_booking_booked o retiene las fechas con lodgify_set_booking_tentative. Con from_enquiry_id una consulta existente se convierte en la reserva.
• Cambios de estado: lodgify_decline_booking (las fechas vuelven a quedar libres) y lodgify_reopen_booking (vuelve a Open; una reserva Booked libera sus fechas).
• Llegada y salida: lodgify_update_key_codes fija los códigos de la puerta o de la caja de llaves que ve el huésped; lodgify_check_in_booking y lodgify_check_out_booking registran la hora de llegada y de salida.
• Mensajes: lodgify_add_booking_messages y lodgify_add_enquiry_messages añaden mensajes a una conversación; el tipo Comment guarda una nota interna que el huésped no ve. lodgify_mark_booking_replied y lodgify_mark_booking_not_replied clasifican la conversación en la bandeja de entrada.

Emails a huéspedes: los mensajes con send_notification: true, lodgify_request_payment y request_payment: true en un cambio de estado envían un email al huésped. La IA te muestra el texto y espera tu sí antes de enviarlo.

Desactivadas al instalar: ninguna herramienta. El conector no tiene herramientas de borrado y una reserva rechazada se puede reabrir con lodgify_reopen_booking.

Formatos de datos: los ids de alojamientos, tipos de habitación y reservas son enteros; una conversación es un GUID (thread_uid). Las fechas son YYYY-MM-DD; las horas de check-in y check-out son HH:mm:ss en la zona horaria del alojamiento; las fechas de modificación son ISO 8601. Los importes van en la moneda del alojamiento (currency_code), en unidades enteras (120.5 = 120,50). El estado de una reserva es Open (una solicitud), Tentative, Booked o Declined; source indica el canal (Manual, AirbnbIntegration, BookingCom, ...).

Paginación: las listas v2 aceptan page (desde 1) y size (50 por defecto); con include_count: true el total llega en count. lodgify_list_inbox usa offset y limit y devuelve total.

Errores frecuentes: 401 o 403 significa una clave API ausente o incorrecta, 404 un id desconocido, 400 fechas o parámetros no válidos (el cuerpo de la respuesta dice cuáles). 429 es el límite de peticiones: la IA espera y vuelve a intentarlo.

El conector no cambia tarifas ni disponibilidad, no crea enlaces de pago, no gestiona webhooks y no mueve reservas a la papelera.

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Lodgify.

Herramientas disponibles

Ejemplos de prompts

• "¿Quién llega hoy a nuestros alojamientos? Muéstrame nombre del huésped, alojamiento, número de personas e importe pendiente."
• "¿Está libre el Sea View Apartment del 12 al 19 de julio para 2 adultos y un perro? ¿Cuánto costaría la estancia?"
• "¿Qué mensajes de huéspedes siguen sin respuesta? Resume cada conversación."
• "Pon el código de la caja de llaves 4821 en la reserva 1234567 y redacta un mensaje de check-in para el huésped. Enséñamelo antes de enviarlo."
• "Crea una reserva para Laura Bianchi en el Garden Studio del 3 al 7 de marzo y confírmala."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

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