Servidor MCP de Lueira
Permite que asistentes de IA como Claude o ChatGPT interactúen con tus datos de Lueira de forma natural. Consulta reservas, crea pedidos, comprueba disponibilidad: todo en conversación.
- 🗓️ Listar reservas
- 👤 Buscar un cliente
- 📦 Comprobar stock
- 💳 Registrar un pago
- 📊 Consultar ocupación
Conecta Lueira con tu asistente de IA
El servidor MCP de Lueira permite a los asistentes de IA trabajar directamente con tu cuenta: crear y buscar reservas, gestionar clientes y productos, consultar disponibilidad y pagos, todo a través de la conversación. Es remoto y basado en estándares (OAuth 2.1 sobre Streamable HTTP), así que funciona con cualquier cliente compatible con MCP.
Antes de empezar: necesitas una cuenta de Lueira con el acceso a la API activado.
Elige tu cliente
Selecciona la herramienta que usas. Todas se conectan a la misma URL del servidor de arriba; solo cambian los pasos.
Configuración manual en un minuto.
- 1Abre claude.ai, haz clic en el icono de tu perfil, luego en Personalizar y después en Connectors.
- 2Haz clic en el botón "+" y elige "Añadir conector personalizado".
- 3Pega la URL del servidor MCP que aparece arriba.
- 4Haz clic en Conectar. El navegador te redirige al inicio de sesión de Lueira.
- 5Autoriza el acceso. Listo.
Autenticación OAuth 2.1
La conexión usa OAuth 2.1 sobre Streamable HTTP. Nunca pegas tu contraseña ni una API Key en el cliente MCP: te autenticas en Lueira desde tu navegador y decides qué permisos concedes.
1. El cliente pide acceso
El cliente MCP (Claude, ChatGPT, …) inicia un flujo OAuth 2.1 contra api.lueira.com. Se registra automáticamente (dynamic client registration) si es la primera vez.
2. Tú inicias sesión en Lueira
El navegador se abre en la pantalla de login de Lueira, con tu cuenta habitual. Nunca compartes credenciales con el cliente MCP.
3. Eliges los permisos
Lueira te muestra qué puede pedir el asistente (leer reservas, crear pedidos, gestionar clientes…) y eliges el perfil que quieres conceder.
4. Se emite el token
Al aprobar, Lueira emite un token con esos permisos. Se guarda en el cliente MCP y se renueva automáticamente mientras la conexión esté activa.
Tú decides qué puede hacer tu IA
Tu asistente siempre hereda los permisos de tu propio usuario de Lueira: nunca podrá hacer nada que tú no puedas. Al autorizar la conexión, Lueira te pregunta qué perfil conceder dentro de esos límites. Cámbialo cuando quieras desde Ajustes → Desarrolladores → Credenciales.
Analista
Solo lecturaTu asistente puede consultar reservas, clientes, productos, disponibilidad y ocupación. Puede leer, pero nunca cambiar nada.
Operativo
Lectura y escrituraTodo lo del perfil Analista y además puede actuar: crear reservas, añadir clientes, registrar pagos, actualizar productos.
Personalizado
Tus reglasElige a mano exactamente qué scopes concedes, uno a uno. Reutiliza los mismos scopes de la API REST para tener control total.
Comprueba que funciona
Pregúntale algo a tu asistente sobre tu cuenta. Usará las herramientas de Lueira para obtener datos reales.
- 💬 Lista mis reservas de esta semana
- 💬 Muéstrame los clientes con inmersiones pendientes
- 💬 ¿Cuánto stock me queda de kayaks?
- 💬 Crea una reserva para mañana a las 10:00
Gestiona la conexión
La conexión genera un token de acceso en Lueira con los permisos que hayas concedido al MCP. Puedes revisarlo en cualquier momento en Ajustes → Desarrolladores → Credenciales.
- Desconectar: en los ajustes de conectores de tu cliente, haz clic en Lueira y elige Desconectar.
- Reconectar: repite los pasos de instalación de arriba.
- Revocar desde Lueira: en Ajustes → Desarrolladores → Credenciales, revoca el token del cliente MCP en un clic.
Resolución de problemas
"0 herramientas visibles"
Puede que tu cuenta de Lueira no tenga los permisos necesarios, o que el perfil concedido sea demasiado estrecho. Revisa Credenciales y reautoriza si hace falta.
"Sesión no encontrada"
Desconecta y vuelve a conectar desde tu cliente MCP.
Error de OAuth
Asegúrate de que tu cuenta de Lueira tiene el acceso a la API activado y de que estás usando la URL exacta del servidor MCP.
El token deja de funcionar
Los tokens se renuevan automáticamente. Si el cliente lleva mucho tiempo cerrado, puede que el refresh haya expirado — reconecta y listo.