Servidor MCP de Requiply

La integración AI (IA) es el servidor MCP de Requiply para conectar los datos de tu organización con asistentes de IA compatibles con Model Context Protocol (MCP). Permite que un asistente responda preguntas prácticas sobre tu negocio con tu catálogo, tus reservas, tus clientes, tus precios, tu disponibilidad, las conversaciones de tu bandeja de entrada y tus informes de Requiply en tiempo real.

Esta página está en Settings → Integrations → AI.

La URL del servidor MCP es:

https://api.requiply.com/api/mcp

Requiply usa OAuth para dar acceso a los conectores MCP. Cuando un asistente compatible se conecta, el usuario inicia sesión en Requiply y aprueba el acceso; no hay ninguna clave de API ni token secreto que copiar en la URL.

Por qué importa la integración de IA

La integración de IA da a un asistente una forma estructurada de trabajar con Requiply, en lugar de hacer suposiciones a partir de hojas de cálculo exportadas o capturas de pantalla. Una vez aprobado el acceso, el asistente puede llamar a las herramientas MCP de Requiply para consultar tu organización, buscar en el inventario, comprobar la disponibilidad, calcular presupuestos, encontrar clientes, revisar reservas, responder preguntas de informes y preguntas con filtros, leer y responder las conversaciones de la bandeja de entrada, dejar comentarios para el equipo y, para los usuarios con los permisos adecuados, gestionar plantillas, flujos de trabajo y la configuración de la organización.

Usos habituales:

• Preguntar qué equipos están disponibles en un rango de fechas.
• Calcular el total de una reserva antes de redactar una solicitud de reserva.
• Encontrar un cliente por email, teléfono o nombre.
• Redactar una solicitud de reserva para un cliente (pendiente de la aprobación del personal).
• Revisar los detalles de una reserva y el estado de sus pagos.
• Consultar los ingresos, la tasa de uso, las reservas con retraso, los saldos pendientes y los mejores clientes.
• Responder preguntas que combinan filtros, como las reservas de julio con un dron que siguen sin pagar, o los ingresos por mes de este año.
• Leer las conversaciones que esperan al equipo y responder a un cliente.
• Dejar en una reserva un comentario que menciona a un compañero, o leer los comentarios que te mencionan.
• Leer y rellenar tus propios campos personalizados en reservas, clientes y productos.
• Escribir o corregir una plantilla de email, de mensaje o de documento con las macros correctas.
• Configurar una automatización, como un recordatorio de recogida o un email de confirmación.
• Cambiar el horario laboral, las reglas de fianza o los márgenes entre reservas.
• Averiguar cómo funciona algo en Requiply, con enlaces a esta base de conocimiento.

Cada registro que menciona el asistente viene con un enlace que lo abre en Requiply, así que puedes ir directamente de la respuesta a la reserva, al cliente o a la conversación.

Qué significa MCP en Requiply

MCP es la capa de protocolo que permite a los asistentes de IA usar Requiply como fuente de herramientas conectada. En lugar de limitarse a leer una página estática, el asistente puede pedir JSON estructurado a las herramientas de Requiply y usar esos resultados en su respuesta.

El acceso se limita a la cuenta y la organización de Requiply autenticadas. Solo un usuario con el rol de administrador (el grupo de permisos Administrators, administradores) puede aprobar una conexión, y ese grupo siempre tiene todos los permisos de acceso, así que un asistente conectado puede usar todas las herramientas de abajo. La excepción son los permisos de Booking creation (creación de reservas) y Communications (comunicaciones), que se pueden desactivar para Administrators: cuando Allow booking outside of working hours (permitir reservar fuera del horario laboral) está desactivado para el grupo, el asistente tampoco puede crear una solicitud de reserva fuera del horario laboral. Las claves de API de la organización actúan en nombre de toda la organización.

Las conversaciones solo aparecen mientras la función bandeja de entrada de conversaciones está activada, y solo una conexión iniciada como miembro puede responderlas o hacerse cargo de ellas, porque la respuesta se envía en nombre de ese miembro.

Cada herramienta es de solo lectura o de escritura, nunca las dos cosas. Las herramientas de solo lectura (whoami, describe, get_guidance, get_profile, objects_search, objects_get, objects_query, availability_check, pricing_quote, reports_run, settings_get, templates_preview, workflows_validate, search_help) nunca cambian nada, así que un asistente puede llamarlas libremente. Las herramientas que cambian tu organización siempre muestran antes una vista previa.

Qué debes saber

• Los resultados de las herramientas se devuelven como JSON estructurado, así que el asistente puede resumirlos, compararlos, filtrarlos y combinarlos.
• Cada registro que menciona el asistente lleva una url que lo abre en Requiply.
• Las escrituras siempre se ejecutan primero como vista previa y solo se guardan cuando el asistente repite la llamada con confirmed=true después de tu aprobación. La vista previa contiene los valores exactos o la diferencia entre el antes y el después que se guardará.
• Solo se pueden eliminar plantillas y flujos de trabajo, y no se puede eliminar una plantilla que todavía usa un flujo de trabajo u otra plantilla. Las categorías, las sedes y los servicios nunca se eliminan a través del asistente; los servicios se archivan.
• Una solicitud de reserva creada por un asistente llega en tu Status for booking requests y espera la aprobación del personal. La aprobación vuelve a comprobar la disponibilidad, cobra el pago y bloquea el inventario; hasta entonces, la solicitud no hace nada de eso.
• Lo que el asistente puede ver y cambiar depende de los permisos de la cuenta que conecta. whoami muestra la matriz de acceso, y el asistente tiene instrucciones de explicar que falta un permiso en lugar de intentar el cambio.
• La integración de IA trabaja con los datos de la organización de la cuenta de Requiply autenticada.
• La URL de MCP no incluye ninguna clave secreta. La autenticación se hace mediante el inicio de sesión y la aprobación con OAuth.

Más sobre el MCP de Requiply

• Conectar un asistente: añade Requiply a Claude o ChatGPT con OAuth, paso a paso.
• Herramientas del MCP: todas las herramientas, los registros que leen y cambian y los permisos que necesitan.
• Casos de uso: preguntas que puedes hacer y el JSON que devuelven las herramientas.
• Solución de problemas: errores al iniciar sesión, cambios rechazados y herramientas que no aparecen.