Requiply MCP

Herramientas del MCP de Requiply

Todas las herramientas que puede usar un asistente conectado a Requiply: orientación y guías, registros, reservas y ventas, disponibilidad y precios, conversaciones, comentarios, informes y configuración.

Estas son las herramientas que el servidor MCP de Requiply ofrece a un asistente conectado. Las de solo lectura se pueden usar libremente; cualquier herramienta que cambie algo muestra antes una vista previa y solo guarda cuando la confirmas. Para verlas en acción, consulta Casos de uso.

Cómo trabaja un asistente con Requiply

Requiply ofrece un conjunto de herramientas pequeño y coherente. Estas existen para que el asistente se oriente antes de tocar los datos:

Herramienta	Qué hace
`whoami`	Devuelve el perfil del negocio (moneda, idioma, zona horaria, horario laboral y festivos, sedes, opciones de pago y de envío), en nombre de quién actúa el asistente, una matriz de acceso por tipo de objeto y los miembros del personal con sus grupos de permisos. Los asistentes la llaman lo primero en una conversación.
`describe`	Descubrimiento del esquema. Lista los tipos de objeto a los que llega la conexión, las secciones de la configuración y los temas de orientación. Para un tipo de objeto devuelve los campos, los filtros, valores en tiempo real como los estados de reserva o las categorías, tus campos personalizados en reservas, clientes y grupos de artículos, y los campos por los que `objects_query` puede filtrar y agrupar. Para una sección de la configuración devuelve los campos de esa sección.
`get_guidance`	Devuelve instrucciones detalladas para una tarea: todas las macros que admite tu organización (incluidos tus campos personalizados), las reglas de formato de las plantillas, la estructura de los disparadores y las acciones de los flujos de trabajo con recetas listas para usar, los operadores de filtro, el catálogo de informes, el lenguaje de consulta y un mapa de las páginas de la app.
`get_profile`	Devuelve la cuenta de Requiply con la que inicia sesión la conexión: nombre, email y organización. Solo en las conexiones iniciadas como miembro.
`search_help`	Busca en esta base de conocimiento cómo funciona Requiply y cómo configurar algo, y lee una página completa. El asistente cita las páginas que ha usado.

Como las macros y la estructura de los flujos de trabajo salen de las herramientas y no de la memoria del asistente, una plantilla redactada por un asistente usa exactamente las macros que tiene tu organización.

get_guidance acepta uno o varios de estos temas:

Tema	Qué incluye
`getting_started`	Cómo encajan las herramientas entre sí y la convención de vista previa y confirmación para las escrituras.
`booking_rules`	El horario laboral, los márgenes entre reservas, el estado de las solicitudes y lo que hace y no hace una solicitud de reserva.
`email_template_macros`	Todas las `{{macro}}` disponibles en las plantillas de email, incluidos tus campos personalizados.
`message_template_macros`	Las macros y las reglas de formato de las plantillas de mensajes de SMS, Viber y Telegram.
`export_template_macros`	Las macros y la sintaxis de las columnas de tabla de las plantillas de documentos PDF.
`template_conditionals`	Los bloques `{{#if}}` y cómo se comportan los valores vacíos.
`workflow_recipes`	La estructura de los disparadores y las acciones con recetas de automatización listas para usar.
`workflow_filters`	Los nombres de las propiedades de filtro, los operadores y los formatos de valor de los flujos de trabajo.
`reports_catalog`	Qué informe responde a cada pregunta de negocio y sus parámetros.
`query_language`	La sintaxis de `objects_query`: campos, operadores, fechas, agrupación y ejemplos resueltos.
`app_navigation`	Todas las páginas de la app web de Requiply con su ruta en el menú y un enlace, para preguntas como "¿dónde lo encuentro?" o "¿cómo lo hago?".

Registros

Los registros se leen con dos herramientas genéricas y se cambian con la herramienta de escritura de cada tipo. El argumento objectType elige con qué trabajar. Cada registro que tiene una página en Requiply lleva una url que la abre, y los asistentes enlazan los registros con ella.

Tipo de objeto	Lectura	Escritura	Notas
`booking`	Sí	Con `bookings_manage`; los campos personalizados, con `objects_manage`	Filas reducidas en la búsqueda; artículos, servicios, pagos y campos personalizados completos con get. El número de reserva que ve el usuario es `reservationOrgId`.
`client`	Sí	Crear, actualizar, campos personalizados	Búsqueda exacta por email o teléfono, búsqueda aproximada por nombre. La creación evita los duplicados. La creación y la actualización aceptan `customFields`.
`item_group`	Sí	Solo los campos personalizados	Productos de alquiler con stock, precios, tramos de precio, campos personalizados y disponibilidad para un intervalo de fechas. Los productos en sí se editan en la app.
`sale_item`	Sí	No	Productos a la venta (Ventas): nombre, SKU, código de barras, categoría, precio de venta, stock disponible (puede ser negativo) y vendidos en los últimos 30 días. `purchaseCost` solo para las cuentas con Allow managing stock (permitir gestionar el stock). Necesita Ventas activado y un permiso de Ventas.
`sale`	Sí	Con `sales_manage`	Ventas de productos, sueltas o en una reserva, de la más reciente a la más antigua. Filtros: `kind` (suelta o en una reserva), `status`, `unpaid`, `clientId`, `soldFrom`, `soldTo`. Get devuelve las líneas, las devoluciones y los pagos. El número que ve el usuario es `saleOrgId`; pasa `idKind="org"` para obtenerla por ese número.
`category`	Sí	Crear, actualizar	Categorías de artículos, anidadas mediante `parentId`.
`service`	Sí	Crear, actualizar	Servicios adicionales; se archivan en lugar de eliminarse.
`location`	Sí	Crear, actualizar	Sedes de recogida y devolución.
`reservation_status`	Sí	No	Estados de reserva, que se usan para obtener los ids de los flujos de trabajo y los filtros.
`email_template`, `message_template`, `export_template`	Sí	Con `templates_manage`	Se listan sin el cuerpo; el cuerpo se obtiene con get. `templates_preview` genera una con una reserva.
`workflow`	Sí	Con `workflows_manage`	Se listan con un resumen legible del disparador y la acción; get devuelve la configuración completa.
`bundle`	Sí	No	Packs que se pueden reservar, con sus artículos y su descuento. Pasa fechas a la búsqueda para saber cuántos juegos están libres. Los packs se crean y se editan en la app.
`conversation`	Sí	Con `conversations_manage`	La bandeja de entrada de conversaciones, de la más reciente a la más antigua: canal, contacto, cliente vinculado, quién responde ahora (la IA o una persona), responsable, estado y número de mensajes sin leer. Filtros: `view` (`needs_human`, `mine`, `ai`, `closed`), `period` (`today`, `week`), `channel`. Get devuelve los últimos mensajes y si todavía se puede enviar una respuesta por ese canal.
`comment`	Sí	Con `comments_manage`	Comentarios en una reserva, un cliente, una unidad o una tarea. La búsqueda necesita `entityType` y `entityId` (la cronología de un registro) o `mentionsMe=true` (los comentarios que te mencionan, en las conexiones de miembros). Las entradas del sistema se omiten salvo con `includeSystem=true`.

Herramienta	Qué puede hacer
`objects_search`	Listar o buscar un tipo de objeto con una `query` de texto libre, `filters` tipados (fechas, nombres de estado, id del cliente, categoría, intervalo de disponibilidad, vista de la bandeja de entrada) y paginación por cursor.
`objects_get`	Obtener hasta 20 registros por id con todos los detalles, incluidos los campos personalizados de reservas, clientes y grupos de artículos. Para las reservas y las ventas, `idKind="org"` acepta el número que se ve en la app.
`objects_query`	Responder preguntas con filtros y agrupaciones sobre reservas, clientes, grupos de artículos y ventas con RQL (Requiply Query Language), una consulta en JSON: condiciones combinadas con AND y OR sobre cualquier campo, incluidos el cliente, el estado, los artículos y su categoría, el saldo que queda por pagar y los campos personalizados. Devuelve los registros que coinciden con sus enlaces, o una fila por grupo con recuentos, sumas, medias y medianas, por ejemplo los ingresos por mes. Solo lectura. Los totales de dinero necesitan Reporting access (acceso a los informes).
`objects_manage`	Crear o actualizar un cliente, una categoría, un servicio o una sede, y fijar los valores de los campos personalizados de una reserva, un cliente o un grupo de artículos existentes (`set_custom_fields`). Requiere el permiso correspondiente: Allow client management (permitir la gestión de clientes) para los clientes, Allow inventory management (permitir gestionar el inventario) para las categorías y los campos personalizados de los grupos de artículos, Allow services management (permitir la gestión de servicios) para los servicios, Allow booking management (permitir la gestión de reservas) para los campos personalizados de las reservas y Allow access to settings (permitir el acceso a la configuración) para las sedes.

Qué herramienta de lectura usa el asistente en cada caso.objects_search encuentra registros por nombre, por número o con unos pocos filtros fijos. reports_run responde a los informes de negocio estándar. objects_query se encarga de las preguntas intermedias, como "reservas de julio con un dron que siguen sin pagar" o "clientes con tres reservas o más que no han reservado desde junio". Los asistentes leen el tema de orientación query_language antes de su primera consulta.

Herramientas de reservas, ventas, disponibilidad y precios

Herramienta	Qué puede hacer
`availability_check`	`mode="items"` devuelve los grupos de artículos con al menos una unidad libre durante todo el rango de fechas. `mode="calendar"` devuelve los recuentos día a día por grupo de artículos.
`pricing_quote`	Calcula un presupuesto exacto a partir de los grupos de artículos, packs y servicios elegidos, las fechas del alquiler, los tramos de precio y un descuento de cliente opcional. Una fecha sin hora se calcula desde la hora de apertura hasta la de cierre, y el resultado repite las fechas que ha usado.
`sales_manage`	`create` registra una venta suelta de productos al precio del catálogo, con un cliente opcional (por id, o por nombre con email o teléfono) y un método de pago. La vista previa lista las líneas, el total, los avisos de stock (el stock puede quedar en negativo, la venta se permite igualmente) y si el método de pago funciona; la llamada confirmada la registra y devuelve un enlace de pago para los métodos online. Necesita Allow selling items (permitir vender artículos). Las devoluciones, las cancelaciones, la edición de líneas y marcar pagos como pagados se hacen en la app.
`bookings_manage`	`create_request` redacta una reserva en el Status for booking requests (estado de las solicitudes de reserva) de tu organización (Request, solicitud, salvo que lo hayas cambiado en Creación de reservas). La llamada de vista previa comprueba la disponibilidad, calcula el precio de los artículos y devuelve el resumen; la llamada confirmada crea la solicitud. Acepta los `customFields` de la reserva, con las claves de campo que lista `describe`. `add_note` añade a una reserva una nota interna, solo para el personal. El personal cuyo grupo de permisos tiene Allow booking outside of working hours puede pedir una recogida o una devolución fuera del horario, y la herramienta pasa `allowOutsideWorkingHours` para ellos. El personal cuyo grupo tiene Allow booking cost adjustments (permitir ajustes del coste de la reserva) también puede pasar un `adjustment` (`units`, `percent` o `amount`, con signo), consulta Ajuste del coste de la reserva. El personal con Allow selling items puede pasar `saleLines` para vender productos con la reserva al precio del catálogo: la vista previa los muestra como `saleSubtotal`, dentro del total y nunca con descuento, y su stock baja cuando se crea la solicitud. Una solicitud también puede incluir `bundles`, que se reservan como sus artículos con el descuento del pack.

Una solicitud de reserva nunca bloquea el inventario ni cobra ningún pago. Un miembro del personal la aprueba en la app, y la aprobación vuelve a comprobar la disponibilidad. Los cambios de estado, los pagos y la edición de artículos de una reserva existente se hacen en la app.

Las fechas y las horas son tu hora local. Los asistentes pasan las fechas y las horas sin zona horaria, por ejemplo 2026-10-06T10:00:00, y Requiply las interpreta en la zona horaria de la organización definida en Configuración de fecha y hora, con el horario de verano incluido. Una fecha sin hora, como 2026-10-06, significa la hora de apertura para la recogida y la hora de cierre para la devolución. Los valores que llevan su propio desfase horario, como 2026-10-06T10:00:00+03:00, se usan tal cual.

El horario laboral se comprueba en la vista previa. Cuando la recogida o la devolución pedidas caen en un día cerrado o fuera del horario laboral, la vista previa lo indica en workingHours con el día laborable más cercano o el intervalo permitido, y el asistente no te pide que confirmes. En su lugar, te propone otra hora.

Todas las reglas del negocio se comprueban en la vista previa. Cuando una solicitud no se puede reservar tal como se ha pedido, la vista previa devuelve bookable: false y una lista de problems, cada uno con un código, el motivo y un nextStep que el asistente sigue antes de pedirte que confirmes:

Código	Significado	Qué hace el asistente a continuación
`working_hours`	Recogida o devolución en un día cerrado o fuera del horario laboral.	Propone la hora válida más cercana.
`minimum_duration`	Más corta que la Minimum booking duration (duración mínima de la reserva) de Duración de las reservas.	Ofrece la devolución más temprana que se aceptaría.
`unavailable`	No hay suficiente stock libre para esas fechas.	Dice cuántos hay libres y propone otras fechas, una cantidad menor o un artículo parecido.
`not_found`	No se ha encontrado un artículo, un servicio o un cliente.	Lo vuelve a buscar o te pide los datos del cliente.
`not_allowed`	Tu grupo de permisos o el plan no permiten una parte de la solicitud.	Ofrece continuar sin ella, por ejemplo sin el ajuste.
`invalid_request`	Hay algo mal formado en la solicitud, por ejemplo la devolución antes de la recogida.	Corrige la solicitud y vuelve a generar la vista previa.
`system_error`	Un fallo temporal.	Lo vuelve a intentar una vez.

Los problemas se devuelven como respuestas normales, no como errores, así que el asistente siempre te cuenta qué ha pasado y qué propone, en lugar de detenerse sin decir nada. pricing_quote y availability_check responden de la misma forma: la disponibilidad se comprueba para las horas exactas pedidas, incluidos tus márgenes entre reservas.

Sin reservas duplicadas por un "sí" repetido. Si confirmas la misma solicitud dos veces en menos de 30 minutos (mismo cliente, mismas fechas y mismos artículos), la segunda llamada devuelve el número de la solicitud ya creada en lugar de crear otra.

Conversaciones y comentarios

Herramienta Qué puede hacer

conversations_manage Acciones de la bandeja de entrada en nombre del miembro que ha iniciado sesión. reply envía un mensaje al cliente por su canal (Telegram, Instagram, Viber, OLX o el chat web); el miembro pasa a ser el responsable y el asistente de IA deja de responder esa conversación. update pasa la conversación a una persona o la devuelve a la IA (handler), la cierra o la vuelve a abrir (status), o hace responsable al miembro o quita el responsable (assign). La vista previa muestra el canal, la persona, el responsable actual, si la ventana de respuesta del canal sigue abierta y cualquier motivo por el que se rechazaría la respuesta. Una conversación de la que es responsable otro miembro solo se responde cuando pides al asistente que se haga cargo de ella. Necesita Allow access to conversations (permitir el acceso a las conversaciones) y una conexión iniciada como miembro; las claves de API de la organización no pueden responder.

comments_manage add escribe un comentario interno en una reserva, un cliente, una unidad o una tarea, en nombre del miembro que ha iniciado sesión (una clave de API de la organización lo escribe sin autor). mentionUserIds menciona a miembros del equipo de whoami, que reciben una notificación push, y parentCommentId lo convierte en una respuesta a otro comentario del mismo registro. Los clientes nunca ven estos comentarios.

Herramienta	Qué puede hacer
`conversations_manage`	Acciones de la bandeja de entrada en nombre del miembro que ha iniciado sesión. `reply` envía un mensaje al cliente por su canal (Telegram, Instagram, Viber, OLX o el chat web); el miembro pasa a ser el responsable y el asistente de IA deja de responder esa conversación. `update` pasa la conversación a una persona o la devuelve a la IA (`handler`), la cierra o la vuelve a abrir (`status`), o hace responsable al miembro o quita el responsable (`assign`). La vista previa muestra el canal, la persona, el responsable actual, si la ventana de respuesta del canal sigue abierta y cualquier motivo por el que se rechazaría la respuesta. Una conversación de la que es responsable otro miembro solo se responde cuando pides al asistente que se haga cargo de ella. Necesita Allow access to conversations (permitir el acceso a las conversaciones) y una conexión iniciada como miembro; las claves de API de la organización no pueden responder.
`comments_manage`	`add` escribe un comentario interno en una reserva, un cliente, una unidad o una tarea, en nombre del miembro que ha iniciado sesión (una clave de API de la organización lo escribe sin autor). `mentionUserIds` menciona a miembros del equipo de `whoami`, que reciben una notificación push, y `parentCommentId` lo convierte en una respuesta a otro comentario del mismo registro. Los clientes nunca ven estos comentarios.

Informes

Herramienta	Qué puede responder
`reports_run`	Una sola herramienta con un argumento `report`: `revenue`, `bookings_summary`, `utilization`, `top_items`, `top_clients`, `outstanding`, `overdue`, `pipeline` e `inventory_status` (unidades alquiladas en este momento). Por defecto, las fechas son los últimos 30 días. Requiere Reporting access.

Para las preguntas que no cubren los informes estándar, como los ingresos por mes de un valor de un campo personalizado, el asistente usa objects_query (consulta Registros).

Herramientas de configuración

La lectura y la comprobación son herramientas separadas de las que hacen cambios, así que un asistente puede revisar tu configuración sin proponer nunca un cambio. Las herramientas de lectura funcionan en todas las conexiones; las de escritura requieren Allow access to settings, que el grupo Administrators siempre tiene.

Herramienta	Lee o escribe	Qué puede hacer
`settings_get`	Lectura	Devuelve la configuración actual de una sección: `organization` (nombre, descripción, datos de contacto, idioma y los campos personalizados de la organización), `working_hours` (zona horaria y horario semanal), `booking_rules` (selector de fechas, duración mínima, márgenes entre reservas), `deposits` y `features`.
`settings_manage`	Escritura	Actualiza una sección solo con los campos que hay que cambiar, y antes muestra la diferencia entre el antes y el después. La sección `organization` también acepta `customFields`. Las funciones que necesitan un plan superior se indican como bloqueadas y no se pueden activar aquí.
`templates_preview`	Lectura	Genera una plantilla de email, de mensaje (SMS, Viber, Telegram) o de exportación (documento PDF) con una reserva real sin guardar nada: una plantilla guardada por id o un borrador sin guardar. Devuelve el asunto, el HTML y el texto sin formato, y lista las macros que la organización no tiene.
`templates_manage`	Escritura	Crea, actualiza y elimina plantillas de email, de mensajes y de exportación. La vista previa valida la plantilla y lista las macros desconocidas. La eliminación rechaza una plantilla que todavía usa un flujo de trabajo u otra plantilla.
`workflows_validate`	Lectura	Comprueba una automatización completa o parcial sin guardarla: convierte los ids de estados y plantillas en nombres, comprueba que los ids del personal son miembros, comprueba que el formato de una plantilla de mensaje encaja con el canal y avisa cuando un proveedor de mensajería no está conectado.
`workflows_manage`	Escritura	Crea, actualiza, activa o desactiva (`set_enabled`) y elimina automatizaciones. Además de las acciones de email, notificación push y mensaje al cliente, puede configurar `change_booking_status` y `send_group_push_notification`, que envía notificaciones push a grupos de permisos por `groupIds`; `whoami` lista el grupo de cada miembro.

Las plantillas y los flujos de trabajo se listan y se leen con objects_search y objects_get, como cualquier otro registro.

Opiniones sobre las herramientas

Herramienta	Qué hace
`send_feedback`	Envía al equipo de Requiply tu opinión sobre estas herramientas: una herramienta que ha fallado o ha devuelto datos incorrectos, algo que necesitabas y que ninguna herramienta puede hacer, o un elogio. Contiene tus propias palabras sin nombres, emails ni teléfonos de clientes, y no cambia nada en tu organización.

Conexión

Añade Requiply como conector personalizado en Claude o como servidor MCP personalizado en ChatGPT, inicia sesión con OAuth como administrador y empieza a usar las herramientas.

Casos de uso

Preguntas que puedes hacer a un asistente conectado a Requiply, las herramientas MCP que las responden y ejemplos resumidos de lo que devuelve cada una.