Guía de conector12 minutos de lectura33 herramientas MCP7 idiomas

Conectar iiko MCP con Claude: pedidos y menús

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.

HCPor el equipo de HelpCodeActualizado 12 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

iiko

iiko

iiko and Syrve restaurant management through the iikoCloud API (Syrve Cloud API): organizations and terminal groups, menu and external menus, stop lists, delivery and table orders, reservations, couriers, order and payment types, discounts and loyalty customers. API login from the web back office.

herramientas

33

Región

INTL

Categoría

E-commerce

Autenticación

Sign-in token

Env vars requeridas

IIKO_API_HOSTIIKO_LOYALTY_APIIIKO_API_LOGIN
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

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 Claude en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta iiko con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.

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.

iiko · live vía MCP
Compartir
Opus 4.7

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 + Claude

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.

  1. 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).
  2. 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.
  3. Pégala en IIKO_API_LOGIN. Elige tu producto dos veces: el host de la API en IIKO_API_HOST y el mismo producto en IIKO_LOYALTY_API (iiko y Syrve nombran los caminos de lealtad de manera diferente).
  4. Opcional: coloca el id de tu restaurante principal en IIKO_ORGANIZATION_ID después de la primera llamada a iiko_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 Claude

La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector, y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde este guía muestre YOUR_SERVER_ID.

Ruta recomendada: funciona en claude.ai web sin editar ningún archivo de configuración.

  1. En Claude, abre Plugins (en algunos planes aún Customize) → Connectors.
  2. Pulsa + Add y después Add custom connector.
  3. Escribe un nombre, por ejemplo iiko, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Continue, deja los ajustes detectados y vuelve a pulsar Continue.
  4. Elige Sign in now, pulsa Add e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas a continuación aparecerán en tu chat: comienza a escribir indicaciones.

Herramientas disponibles

HerramientaQué hace
iiko_list_organizationsLista 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_groupsLista 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_aliveVerifica 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_nomenclatureLee 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_menusLista 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_menuLee 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_listsLee 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_typesLista los tipos de pedido por organización: id, nombre, orderServiceType (Común para pedidos de mesa, DeliveryByCourier, DeliveryByClient para…
iiko_list_payment_typesLista los tipos de pago: id, código, nombre, paymentTypeKind (Efectivo, Tarjeta, Externo, Tarjeta de lealtad y otros), paymentProcessingType, la terminal…
iiko_list_discountsLista 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_causesLista 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_statusLista 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_phoneEncuentra 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_phoneEncuentra 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_deliveriesBusca 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_idLee 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_idLee 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_tableLista 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_groupsLista 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_sectionsLista 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_reservesLista 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_idLee reservas y banquetes por id: creationStatus, isDeleted y la reserva con cliente, teléfono, número de invitados, mesas, inicio estimado…
iiko_list_couriersLista los empleados que son mensajeros de entrega, por organización: id, firstName, lastName, displayName, código y isDeleted. Solo lectura
iiko_get_customerBusca 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_categoriesLista las categorías de clientes (invitados) del programa de lealtad de una organización: id, nombre, isActive y isDefaultForNewGuests. Solo lectura
iiko_list_loyalty_programsLista los programas de lealtad de una organización: id, nombre, descripción, programType, isActive, fechas de validez, walletId, y el marketing…
iiko_list_customer_transactionsLista 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_customerCrea 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_statusVerifica el resultado de un comando (creando o cancelando una entrega, cambiando una lista de parada): estado En progreso, Éxito o Error con…
iiko_create_deliveryCrea un pedido de entrega o recogida en el POS. Es un comando: la respuesta lleva un correlationId y orderInfo con creationStatus…
iiko_cancel_deliveryCancela 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_listColoca 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_listRetira 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

¿Funciona con Claude Code así como con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

¿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.

Próximos pasos

¿Te ha sido útil esta guía?

Conecta iiko a Claude en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta iiko con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conectar iiko MCP con ChatGPT: pedidos y menús

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.

Conectores

Conectar iiko MCP con Microsoft Copilot

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.

Conectores

Conectar iiko MCP con Cursor: pedidos y menús

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.

Conectores

Conectar iiko MCP con Gemini CLI: pedidos

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.

Conectores

Conectar iiko MCP con Meta Muse: pedidos y menús

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.

Conectores

Servidor iiko MCP: menús, pedidos y reservas

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.