Rezdy Agent

Busca productos del marketplace, gestiona reservas y maneja relaciones con clientes usando la API de Rezdy Agent.

GitHub
2
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Rezdy Agent

Un servidor de Model Context Protocol (MCP) para integrarse con la API de Rezdy Agent. Este servidor proporciona herramientas para que los agentes de viajes busquen productos del marketplace, gestionen reservas, manejen relaciones con clientes y procesen pagos a través de Claude.

Características

  • Búsqueda de productos del marketplace: Busca productos de todos los proveedores con filtros avanzados
  • Disponibilidad y precios: Búsqueda de disponibilidad en tiempo real con cálculos de comisión para agentes
  • Gestión de reservas: Cotiza, crea, actualiza y cancela reservas con soporte para procesos de 2 pasos
  • Gestión de clientes: Base de datos de clientes propiedad del agente con operaciones CRUD completas
  • Procesamiento de pagos: Soporte para flujos de pago manuales y automatizados
  • Cálculos de comisión: Precios de agente y manejo de comisiones integrados
  • Límite de velocidad: Límite de velocidad automático (100 llamadas/minuto) con cola inteligente
  • Soporte de entornos: Entornos de staging y producción

Inicio rápido

1. Instalación

Primero, clona y compila el servidor MCP:

git clone https://github.com/jezweb/rezdy-agent-mcp.git
cd rezdy-agent-mcp
npm install
npm run build

2. Configuración con Claude Desktop

Añade el servidor a tu configuración de Claude Desktop:

En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rezdy-agent": {
      "command": "node",
      "args": ["/path/to/rezdy-agent-mcp/build/index.js"]
    }
  }
}

3. Configuración con otros editores

Roo (Roo.dev)

Añade a tu configuración de Roo:

{
  "mcp": {
    "servers": {
      "rezdy-agent": {
        "command": "node",
        "args": ["/path/to/rezdy-agent-mcp/build/index.js"]
      }
    }
  }
}

Cline (Extensión de VS Code)

  1. Instala la extensión Cline en VS Code
  2. Abre la configuración de VS Code (Cmd/Ctrl + ,)
  3. Busca "Cline MCP"
  4. Añade la configuración del servidor:
{
  "cline.mcp.servers": {
    "rezdy-agent": {
      "command": "node",
      "args": ["/path/to/rezdy-agent-mcp/build/index.js"]
    }
  }
}

Cursor

  1. Abre la configuración de Cursor
  2. Navega a Extensiones > MCP
  3. Añade el servidor:
{
  "mcpServers": {
    "rezdy-agent": {
      "command": "node",
      "args": ["/path/to/rezdy-agent-mcp/build/index.js"]
    }
  }
}

4. Despliegue con Docker (Alternativa)

Para despliegue en contenedores, puedes usar Docker:

Opción A: Docker Compose (Recomendado)

  1. Clona el repositorio:
git clone https://github.com/jezweb/rezdy-agent-mcp.git
cd rezdy-agent-mcp
  1. Crea un archivo .env:
REZDY_API_KEY=your-agent-api-key-here
REZDY_ENVIRONMENT=production
  1. Inicia el contenedor:
npm run docker:compose:up
  1. Para Claude Desktop, usa la ruta del contenedor Docker:
{
  "mcpServers": {
    "rezdy-agent": {
      "command": "docker",
      "args": [
        "exec",
        "rezdy-agent-mcp",
        "node",
        "build/index.js"
      ]
    }
  }
}

Opción B: Compilación y ejecución con Docker

# Build the Docker image
npm run docker:build

# Run the container
docker run --rm -it \
  -e REZDY_API_KEY=your-api-key \
  -e REZDY_ENVIRONMENT=production \
  rezdy-agent-mcp

Comandos de gestión de Docker

# Start services
npm run docker:compose:up

# Stop services
npm run docker:compose:down

# View logs
npm run docker:compose:logs

# Rebuild container
npm run docker:compose:build

5. Obtén tu clave de API de Rezdy Agent

  1. Inicia sesión en tu cuenta de Rezdy Agent
  2. Ve a Configuración > Claves de API
  3. Crea una nueva clave de API de agente
  4. Copia la clave de API para la configuración

6. Configura el servidor

Una vez conectado, configura el servidor con tus credenciales de Rezdy Agent:

Use the rezdy_agent_configure tool with:
- apiKey: "your-agent-api-key"
- environment: "staging" or "production"

Ejemplo: "Configura Rezdy Agent con mi clave de API abc123 para el entorno de staging"

El asistente ejecutará:

rezdy_agent_configure({
  apiKey: "abc123",
  environment: "staging"
})

Herramientas disponibles

Configuración

  • rezdy_agent_configure - Configura la clave de API y el entorno

Gestión de productos del marketplace

  • rezdy_agent_search_products - Busca productos del marketplace con filtros
  • rezdy_agent_get_product - Obtén información detallada del producto
  • rezdy_agent_get_product_pickups - Obtén ubicaciones de recogida para productos

Disponibilidad y precios

  • rezdy_agent_search_availability - Busca disponibilidad con precios de agente

Gestión de reservas

  • rezdy_agent_quote_booking - Obtén cotizaciones de reservas con detalles de comisión
  • rezdy_agent_create_booking - Crea reservas confirmadas
  • rezdy_agent_get_booking - Obtén detalles de la reserva
  • rezdy_agent_update_booking - Actualiza reservas existentes
  • rezdy_agent_cancel_booking - Cancela reservas

Gestión de clientes

  • rezdy_agent_search_customers - Busca en la base de datos de clientes del agente
  • rezdy_agent_create_customer - Crea nuevos perfiles de cliente
  • rezdy_agent_get_customer - Obtén detalles del cliente

Datos del marketplace

  • rezdy_agent_get_categories - Obtén categorías de productos
  • rezdy_agent_get_locations - Obtén ubicaciones del marketplace
  • rezdy_agent_get_suppliers - Obtén proveedores del marketplace

Cómo usar

Una vez configurado, puedes interactuar con el marketplace de Rezdy mediante lenguaje natural. Aquí tienes algunos ejemplos:

Para empezar

  • "Configura Rezdy Agent con mi clave de API abc123 para producción"
  • "Muéstrame todas las categorías del marketplace"
  • "Encuentra proveedores en Sídney"

Descubrimiento de productos

  • "Busca tours de vino en Sídney por menos de $200"
  • "Encuentra actividades de deportes acuáticos para la próxima semana"
  • "Muéstrame productos del proveedor ID 456"
  • "Obtén detalles del producto 789 incluyendo ubicaciones de recogida"

Disponibilidad y precios

  • "Comprueba disponibilidad para el producto 123 la próxima semana"
  • "Muéstrame precios para 2 adultos en el producto 456 para mañana"
  • "¿Qué hay disponible para el producto 789 en diciembre?"

Proceso de reserva

  • "Obtén una cotización para Juan Pérez (juan@ejemplo.com) para el producto 123 con 2 adultos"
  • "Crea una reserva para María García para el producto 456 mañana a las 10am"
  • "Actualiza la reserva ABC123 con el nuevo número de teléfono del cliente"
  • "Cancela la reserva DEF456 debido a las condiciones climáticas"

Gestión de clientes

  • "Busca clientes con correo electrónico que contenga 'gmail'"
  • "Crea un perfil de cliente para Mike Johnson (mike@email.com)"
  • "Muéstrame los detalles del cliente ID 789"

Características clave

Funcionalidad específica para agentes

  • Cálculos de comisión: Cálculo automático de comisiones y descuentos para agentes
  • Precios de agente: Soporte para tarifas especiales de agente y descuentos por volumen
  • Base de datos de clientes: Perfiles de cliente propiedad del agente para reservas recurrentes
  • Opciones de pago: Elige entre procesamiento de pagos manual y automatizado

Búsqueda y filtrado avanzados

  • Filtra por ubicación, región, país
  • Filtrado por rango de precios
  • Filtros de duración y categoría
  • Búsquedas específicas por proveedor
  • Filtrado basado en etiquetas

Flexibilidad de reservas

  • Soporte para diferentes modos de reserva (NO_DATE, DATE_ENQUIRY, INVENTORY)
  • Proceso de reserva en 2 pasos
  • Campos de reserva personalizados
  • Gestión de participantes
  • Soporte de códigos promocionales

Procesamiento de pagos

Pagos manuales (predeterminado)

  • El agente procesa el pago fuera de Rezdy
  • Reserva creada con pago pendiente
  • El agente marca el pago como recibido manualmente

Pagos automatizados (RezdyPay)

  • Procesamiento completo de pagos a través de Rezdy
  • Confirmación automática de pago
  • Procesamiento de tarjetas de crédito con cumplimiento PCI

Ejemplos de uso (técnicos)

Si necesitas ver las llamadas exactas a las herramientas, aquí tienes ejemplos:

1. Configura el servidor

rezdy_agent_configure({
  apiKey: "your-agent-api-key-here",
  environment: "production"
})

2. Busca productos del marketplace

rezdy_agent_search_products({
  limit: 20,
  location: "Sydney",
  categoryId: 5,
  minPrice: 50,
  maxPrice: 200,
  tags: ["wine", "food"]
})

3. Comprueba disponibilidad con precios

rezdy_agent_search_availability({
  productId: 123,
  startDate: "2024-01-15",
  endDate: "2024-01-22",
  quantities: [
    { optionId: 1, value: 2 }, // 2 adults
    { optionId: 2, value: 1 }  // 1 child
  ]
})

4. Cotiza una reserva

rezdy_agent_quote_booking({
  productId: 123,
  sessionId: "session-456",
  quantities: [{ optionId: 1, value: 2 }],
  customer: {
    firstName: "John",
    lastName: "Doe",
    email: "john@example.com"
  },
  paymentType: "MANUAL",
  agentReference: "AGENT-REF-001"
})

5. Crea una reserva

rezdy_agent_create_booking({
  productId: 123,
  sessionId: "session-456",
  quantities: [{ optionId: 1, value: 2 }],
  customer: {
    firstName: "John",
    lastName: "Doe",
    email: "john@example.com",
    phone: "+1234567890",
    address: {
      city: "Sydney",
      country: "Australia"
    }
  },
  paymentType: "AUTOMATED",
  agentReference: "BOOKING-001",
  notes: "Customer has mobility requirements"
})

Referencia de la API

Operaciones del marketplace

  • Busca productos en todos los proveedores con filtrado completo
  • Obtén información detallada del producto incluyendo descripciones, imágenes y precios
  • Recupera ubicaciones de recogida y puntos de encuentro
  • Accede a información y valoraciones de proveedores

Disponibilidad y precios

  • Comprobación de disponibilidad en tiempo real con información de capacidad
  • Precios específicos para agentes con cálculos de comisión
  • Soporte para reservas grupales y múltiples opciones de precios
  • Validación de códigos promocionales y aplicación de descuentos

Operaciones de reserva

  • Proceso de reserva en dos pasos (cotización → confirmación)
  • Soporte para requisitos de reserva complejos
  • Gestión de participantes para reservas grupales
  • Soporte de campos personalizados para requisitos específicos del proveedor

Gestión de clientes

  • Base de datos de clientes propiedad del agente
  • Gestión completa de perfiles de cliente
  • Capacidades de búsqueda y filtrado
  • Seguimiento del historial y preferencias del cliente

Límite de velocidad

El servidor maneja automáticamente el límite de velocidad de Rezdy (100 llamadas por minuto) al:

  • Realizar seguimiento del número de solicitudes por minuto
  • Poner en cola las solicitudes cuando se alcanza el límite
  • Reintentar automáticamente después de la ventana del límite de velocidad

Manejo de errores

El servidor proporciona un manejo integral de errores:

  • Valida todos los parámetros de entrada usando esquemas Zod
  • Maneja los errores de la API de Rezdy con elegancia
  • Proporciona mensajes de error claros para depuración
  • Valida los datos del cliente y los requisitos de reserva
  • Comprueba formatos de fecha y reglas de negocio

Solución de problemas

Problemas comunes

Error "Cliente de Rezdy Agent no configurado"

  • Asegúrate de ejecutar primero el paso de configuración: "Configura Rezdy Agent con mi clave de API..."
  • Verifica que tu clave de API de agente sea correcta y tenga los permisos adecuados

Error "Límite de velocidad excedido"

  • El servidor maneja automáticamente el límite de velocidad, pero si ves este error, espera un minuto e inténtalo de nuevo
  • Considera reducir la frecuencia de las solicitudes

Error "Fechas de reserva no válidas"

  • Asegúrate de que las fechas estén en el formato correcto (YYYY-MM-DD para fechas, ISO 8601 para fechas-hora)
  • Comprueba que las fechas de reserva no estén en el pasado
  • Verifica que la fecha de fin sea posterior a la fecha de inicio

Servidor no encontrado en Claude Desktop

  • Comprueba que la ruta en tu claude_desktop_config.json sea correcta
  • Asegúrate de que el servidor se haya compilado correctamente (npm run build)
  • Reinicia Claude Desktop después de realizar cambios en la configuración

Errores de permisos

  • Asegúrate de que el archivo build/index.js tenga permisos de ejecución
  • En sistemas Unix: chmod +x build/index.js

Obtener ayuda

Si encuentras problemas:

  1. Consulta la página de Issues
  2. Revisa la documentación de la API de Rezdy Agent
  3. Verifica los permisos de tu clave de API en la configuración de Rezdy Agent

Desarrollo

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

Contribuciones

  1. Haz un fork del repositorio
  2. Crea una rama de características
  3. Realiza tus cambios
  4. Añade pruebas si corresponde
  5. Envía una solicitud de extracción (pull request)

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles