Resumen
Gestión de restaurantes iiko y Syrve a través de la iikoCloud API (Syrve Cloud API): organizaciones y grupos de terminales, menú y menús externos, listas de parada, pedidos de entrega y de mesa, reservas, mensajeros, tipos de pedido y pago, descuentos y clientes leales. Inicio de sesión en la API desde el back office web.
Configuración guiada
Conecta iiko a ChatGPT en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta iiko con la configuración guiada y añade tu URL MCP a ChatGPT. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
El plugin de AnythingMCP en el directorio de ChatGPT responde, en AnythingMCP Cloud, a preguntas sobre las bases de datos de tu empresa (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, solo lectura): abre la ficha (se abre en una pestaña nueva) y pulsa Install plugin. Los demás conectores se añaden a ChatGPT como servidor MCP personalizado con la URL MCP de tu AnythingMCP.
Prueba a pedir
Prompts de ejemplo para iiko
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Connectors → iiko, pega el inicio de sesión de la API y elige iiko o Syrve como el host de la API y los caminos de lealtad, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
iiko + ChatGPT
Gestión de restaurantes iiko y Syrve a través de la iikoCloud API (Syrve Cloud API): organizaciones y grupos de terminales, menú y menús externos, listas de parada, pedidos de entrega y de mesa, reservas, mensajeros, tipos de pedido y pago, descuentos y clientes leales. Inicio de sesión en la API desde el back office web.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 5 minutos.
- Inicia sesión en el back office web (iikoWeb para iiko, Syrve Web / Syrve App para Syrve) como administrador y abre la configuración de la API en la nube (Integraciones, claves API; llamadas Configuración de API o Configuración de API en vivo en versiones anteriores).
- Crea un inicio de sesión de API (clave API) para este conector: dale un nombre, elige las organizaciones a las que puede acceder y una fecha de caducidad (máximo 2 años). Copia la clave; una nueva clave tiene 36 caracteres y puede mostrarse solo una vez.
- Pégala en
IIKO_API_LOGIN. Elige tu producto dos veces: el host de la API enIIKO_API_HOSTy el mismo producto enIIKO_LOYALTY_API(iiko y Syrve nombran los caminos de lealtad de manera diferente). - Opcional: coloca el id de tu restaurante principal en
IIKO_ORGANIZATION_IDdespués de la primera llamada aiiko_list_organizations, para que las herramientas que toman una organización puedan omitirlo.
El conector intercambia el inicio de sesión de la API en /api/1/access_token por un token de portador que dura 1 hora y lo renueva automáticamente. iiko marca esta llamada de inicio de sesión como obsoleta a favor de /api/v2/access_token, que también necesita una aplicación registrada en el portal de desarrolladores; si iiko desactiva la llamada antigua, la verificación de configuración informa un inicio de sesión fallido.
Dónde empezar: iiko_list_organizations proporciona los ids de organización que necesita cada herramienta. iiko_list_terminal_groups lista las instalaciones de POS de una organización y iiko_check_terminal_groups_alive indica si están en línea.
Menú: iiko_list_external_menus y iiko_get_external_menu leen los menús preparados para los canales de entrega, con precios por organización. iiko_get_nomenclature lee el menú completo del back office (grande; documentado para Syrve, ya no en la referencia de iiko, así que prefiere el menú externo en iiko). iiko_get_stop_lists muestra lo que está fuera de stock por grupo de terminal; iiko_add_to_stop_list y iiko_remove_from_stop_list lo cambian y están instalados desactivados (necesitan un inicio de sesión de API con el derecho adicional de lista de parada).
Pedidos de entrega: iiko_list_deliveries_by_date_and_status (la vista general diaria), iiko_search_deliveries (búsqueda de texto y filtro de problemas), iiko_list_deliveries_by_phone, iiko_get_deliveries_by_id. Estos están garantizados para los últimos 7 días; iiko_list_delivery_history_by_phone llega hasta 90 días. Estados: No confirmado, Esperando cocción, Listo para cocinar, Cocción iniciada, Cocción completada, Esperando, En camino, Entregado, Cerrado, Cancelado. iiko_create_delivery y iiko_cancel_delivery están instalados desactivados: un pedido creado llega a la cocina y una cancelación no puede deshacerse.
Pedidos de mesa y reservas: iiko_get_table_orders_by_id y iiko_list_table_orders_by_table leen los pedidos para comer en el local. Para reservas, iiko_list_reserve_terminal_groups, luego iiko_list_restaurant_sections (salones y mesas), iiko_list_reserves (lo que está reservado a partir de un tiempo) y iiko_get_reserves_by_id (los detalles). El conector no crea reservas.
Diccionarios: iiko_list_order_types, iiko_list_payment_types, iiko_list_discounts, iiko_list_cancel_causes, iiko_list_couriers. Rara vez cambian: léelos una vez por conversación, no por pedido.
Lealtad: iiko_get_customer encuentra a un cliente leal (invitado) por teléfono, correo electrónico o número de tarjeta y muestra los saldos de la billetera; iiko_list_customer_transactions lista los movimientos de bonificación; iiko_list_customer_categories y iiko_list_loyalty_programs describen el programa. iiko_create_or_update_customer guarda los datos maestros del invitado. El conector nunca recarga, retiene o cancela una billetera y no registra pagos.
Comandos: crear o cancelar una entrega y cambiar una respuesta de lista de parada a la vez con un correlationId; el POS lleva a cabo el comando después. Lee el resultado con iiko_get_command_status (En progreso, Éxito, Error).
Formatos: los ids son UUIDs. Las fechas son yyyy-MM-dd HH:mm:ss.fff sin zona horaria: los tiempos de pedido y reserva son locales para la terminal (consulta la zona horaria en iiko_list_terminal_groups), las fechas de informes de lealtad son UTC. Las sumas están en la moneda de la organización. Casi cada llamada es un POST con un cuerpo JSON, también las lecturas.
Límites: iiko agrupa los métodos (diccionarios, menú, listas de parada, lectura de pedidos y otros) y limita cada grupo por intervalo de tiempo, generalmente un minuto; sobre el límite, cada llamada de ese grupo responde 429 hasta que finaliza el intervalo. Los límites para los métodos de pedido y lista de parada crecen con el número de restaurantes. Pide varias organizaciones en una sola llamada en lugar de una llamada por cada una, almacena en caché diccionarios y menús, y no sondees pedidos individuales. Repetir solicitudes idénticas o fallidas en bloque puede bloquear el inicio de sesión de la API.
Errores: una respuesta de error tiene errorDescription y a menudo error (un código) más un correlationId para citar al soporte de iiko. 401 significa que el token o el inicio de sesión de la API fue rechazado, 400 indica el campo incorrecto, 408 significa que el POS no respondió a tiempo (el restaurante puede estar fuera de línea).
Paso 2 — Instalar el adaptador
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 ChatGPT
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 muestraYOUR_SERVER_ID.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
iiko. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
iiko_list_organizations | Lista las organizaciones (restaurantes) a las que puede acceder el inicio de sesión de la API: id, nombre y código, además de país, dirección, coordenadas, configuraciones de zona horaria… |
iiko_list_terminal_groups | Lista los grupos de terminales (las instalaciones de POS a las que se envían los pedidos) de una o más organizaciones: por organización los grupos con id… |
iiko_check_terminal_groups_alive | Verifica si los grupos de terminales están en línea en este momento: por grupo de terminal isAlive verdadero o falso. Úsalo antes de decirle a alguien que un restaurante… |
iiko_get_nomenclature | Lee el menú completo (nomenclatura) de una organización como se exporta desde el back office: grupos, categorías de productos, productos (platos… |
iiko_list_external_menus | Lista los menús externos (los menús preparados para sitios y aplicaciones de entrega en el back office web) y las categorías de precios de la cuenta: id… |
iiko_get_external_menu | Lee un menú externo con sus categorías de ítems, ítems, tamaños, precios por organización, grupos de modificadores, alérgenos, valores nutricionales… |
iiko_get_stop_lists | Lee las listas de parada (artículos fuera de stock): por organización y grupo de terminal los artículos con productId, sizeId, sku, balance (restante… |
iiko_list_order_types | Lista los tipos de pedido por organización: id, nombre, orderServiceType (Común para pedidos de mesa, DeliveryByCourier, DeliveryByClient para… |
iiko_list_payment_types | Lista los tipos de pago: id, código, nombre, paymentTypeKind (Efectivo, Tarjeta, Externo, Tarjeta de lealtad y otros), paymentProcessingType, la terminal… |
iiko_list_discounts | Lista los descuentos y recargos configurados en el back office por organización: id, nombre, porcentaje o suma fija, modo, suma mínima del pedido… |
iiko_list_cancel_causes | Lista las causas de cancelación de entrega: id, nombre y isDeleted. Se necesita un id para cancelar una entrega. Solo lectura; almacena la respuesta |
iiko_list_deliveries_by_date_and_status | Lista los pedidos de entrega y recogida por fecha de entrega y estado: por organización los pedidos con id, posId, creationStatus y el pedido… |
iiko_list_deliveries_by_phone | Encuentra los pedidos de entrega recientes de un número de teléfono (garantizado para los últimos 7 días): los mismos detalles del pedido que… |
iiko_list_delivery_history_by_phone | Encuentra pedidos de entrega más antiguos de un número de teléfono en el historial de pedidos (guardados 90 días): los mismos detalles del pedido, agrupados por organización, como máximo… |
iiko_search_deliveries | Busca pedidos de entrega por texto (búsqueda por prefijo en el número de pedido, nombre del cliente, teléfono o dirección) con filtros por fecha, estado, tipo de servicio… |
iiko_get_deliveries_by_id | Lee hasta 200 pedidos de entrega por id: creationStatus (Éxito, En progreso, Error con errorInfo) y el pedido completo con estado, cliente… |
iiko_get_table_orders_by_id | Lee pedidos de mesa (para comer en el local) por id: creationStatus y el pedido con tableIds, estado (Nuevo, Cuenta, Cerrado, Eliminado), camarero, cliente… |
iiko_list_table_orders_by_table | Lista los pedidos de mesa (para comer en el local) de mesas dadas, opcionalmente por estado y fecha de creación: los mismos detalles que iiko_get_table_orders_by_id.… |
iiko_list_reserve_terminal_groups | Lista los grupos de terminales de las organizaciones dadas que aceptan reservas de mesa y banquetes: id, nombre, dirección y zona horaria, y el… |
iiko_list_restaurant_sections | Lista las secciones del restaurante (salones) de grupos de terminales que aceptan reservas, con sus mesas: id y nombre de sección, y por mesa id… |
iiko_list_reserves | Lista las reservas y banquetes reservados en secciones de restaurante a partir de un tiempo de inicio: id, tableIds, estimatedStartTime, durationInMinutes y… |
iiko_get_reserves_by_id | Lee reservas y banquetes por id: creationStatus, isDeleted y la reserva con cliente, teléfono, número de invitados, mesas, inicio estimado… |
iiko_list_couriers | Lista los empleados que son mensajeros de entrega, por organización: id, firstName, lastName, displayName, código y isDeleted. Solo lectura |
iiko_get_customer | Busca un cliente leal (invitado) por teléfono, correo electrónico, número de tarjeta, pista de tarjeta o id: id, nombre, apellido, teléfono, correo electrónico, cumpleaños, sexo… |
iiko_list_customer_categories | Lista las categorías de clientes (invitados) del programa de lealtad de una organización: id, nombre, isActive y isDefaultForNewGuests. Solo lectura |
iiko_list_loyalty_programs | Lista los programas de lealtad de una organización: id, nombre, descripción, programType, isActive, fechas de validez, walletId, y el marketing… |
iiko_list_customer_transactions | Lista las transacciones de lealtad de un cliente en un período (acumulaciones y cancelaciones de bonificación, recargas de billetera, cupones): tipo, typeName, suma… |
iiko_create_or_update_customer | Crea un cliente leal o actualiza uno encontrado por id, teléfono o tarjeta: nombre, teléfono, correo electrónico, cumpleaños, sexo, comentario, estado de consentimiento y… |
iiko_get_command_status | Verifica el resultado de un comando (creando o cancelando una entrega, cambiando una lista de parada): estado En progreso, Éxito o Error con… |
iiko_create_delivery | Crea un pedido de entrega o recogida en el POS. Es un comando: la respuesta lleva un correlationId y orderInfo con creationStatus… |
iiko_cancel_delivery | Cancela un pedido de entrega, con una causa de cancelación. No se puede deshacer y los artículos ya impresos se cancelan. Es un comando: verifica el… |
iiko_add_to_stop_list | Coloca productos en la lista de parada de un grupo de terminal, con la cantidad restante (0 para agotado). Los invitados ya no pueden pedir un agotado… |
iiko_remove_from_stop_list | Retira productos de la lista de parada de un grupo de terminal, para que puedan ser pedidos nuevamente. Necesita un inicio de sesión de API con el derecho adicional para cambiar la lista de parada… |
Ejemplos de indicaciones
- "¿Qué pedidos de entrega de hoy aún no están en camino, por restaurante?"
- "¿Qué hay en la lista de parada en cada grupo de terminal en este momento?"
- "¿Están todos nuestros grupos de terminal POS en línea?"
- "Muestra las reservas para esta noche a partir de las 18:00 en el restaurante principal, con salón y mesa."
- "Encuentra al invitado con teléfono 79161234567 y muestra el saldo de bonificación y las últimas transacciones."
Preguntas frecuentes
¿De dónde proviene el inicio de sesión de la API? Un administrador inicia sesión en el back office web (iikoWeb para iiko, Syrve Web para Syrve) y abre Integraciones, claves API (Configuración de API en versiones anteriores). Crea un inicio de sesión de API para el conector, elige las organizaciones a las que puede acceder y una fecha de caducidad de máximo 2 años, y copia la clave. Luego elige tu producto para el host de la API y los caminos de lealtad: iiko usa api-ru.iiko.services, Syrve usa api-eu.syrve.live, y una clave solo funciona en el host de su propio producto.
¿Qué cubre? Organizaciones y grupos de terminales con su estado en línea, los menús externos con precios y el menú del back office, listas de parada, pedidos de entrega por fecha, estado, teléfono o búsqueda de texto, pedidos de mesa, reservas con salones y mesas, mensajeros, tipos de pedido y pago, descuentos y causas de cancelación, y clientes leales con saldos de billetera y transacciones de bonificación. Guarda los datos maestros de los invitados, pero nunca recarga, retiene o cancela una billetera, no registra pagos y no crea reservas.
¿Qué herramientas se instalan desactivadas? iiko_create_delivery, iiko_cancel_delivery, iiko_add_to_stop_list y iiko_remove_from_stop_list. Un pedido creado va directamente a la cocina y una cancelación no puede deshacerse, y las herramientas de lista de parada necesitan un inicio de sesión de API con el derecho adicional de lista de parada. Actívalas en la página del conector solo si la IA debe usarlas.
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Próximos pasos
¿Te ha sido útil esta guía?