Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Loyverse con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
El back office del punto de venta Loyverse: tickets de venta y de reembolso, turnos y efectivo, artículos con variantes, categorías, modificadores, descuentos e impuestos, stock por tienda, clientes de fidelización, empleados, tiendas, dispositivos TPV, medios de pago, proveedores y webhooks. Reembolsos y borrados se instalan desactivados.
Prueba a pedir
Prompts de ejemplo para Loyverse
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.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Loyverse, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Loyverse + ChatGPT
El back office del punto de venta Loyverse: tickets de venta y de reembolso, turnos y efectivo, artículos con variantes, categorías, modificadores, descuentos e impuestos, stock por tienda, clientes de fidelización, empleados, tiendas, dispositivos TPV, medios de pago, proveedores y webhooks. Reembolsos y borrados se instalan desactivados.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
LOYVERSE_ACCESS_TOKEN
Paso 1 — Obtener credenciales
La configuración lleva unos 2 minutos. Necesitas el acceso de propietario de una cuenta Loyverse.
- Entra en el Loyverse Back Office como propietario y abre Settings, Access tokens (
https://r.loyverse.com/dashboard/#/integrations/tokens). En algunos planes los access tokens forman parte del complemento Integrations. - Pulsa Add access token, ponle un nombre y, si quieres, una fecha de caducidad, y guarda. Copia el token.
- Pégalo en
LOYVERSE_ACCESS_TOKEN. Se envía comoAuthorization: Bearer <token>y tiene acceso completo a la cuenta, así que guárdalo en privado. - Instala el conector y ejecuta
loyverse_get_merchant: muestra el nombre del negocio y la moneda y confirma el token.
El conector habla con la Loyverse API v1.0 en https://api.loyverse.com/v1.0, la API de back office del punto de venta Loyverse.
Qué lee: la cuenta con loyverse_get_merchant (moneda y número de decimales), las tiendas con loyverse_list_stores y loyverse_get_store y los dispositivos TPV con loyverse_list_pos_devices. Ventas: loyverse_list_receipts por tienda y rango de fechas (created_at_min/created_at_max) o por números de ticket, del más reciente al más antiguo, con líneas, descuentos, impuestos, pagos, empleado y cliente; loyverse_get_receipt lee un ticket por su número. Turnos y efectivo: loyverse_list_shifts y loyverse_get_shift (movimientos de caja, efectivo esperado y real, ventas brutas y netas, impuestos, pagos por tipo). Medios de pago con loyverse_list_payment_types y loyverse_get_payment_type. Catálogo: loyverse_list_items, loyverse_get_item, variantes con SKU, código de barras y precio por tienda con loyverse_list_variants (búsqueda por sku) y loyverse_get_variant, categorías, modificadores, descuentos, impuestos y proveedores. Stock: loyverse_list_inventory da in_stock por variante y tienda. Clientes con loyverse_list_customers (búsqueda por email) y loyverse_get_customer, con visitas, gasto total y puntos de fidelización; empleados con loyverse_list_employees y loyverse_get_employee; webhooks con loyverse_list_webhooks.
Qué escribe: loyverse_create_receipt registra una venta hecha en otro sitio, por ejemplo en otro canal: descuenta el stock de los artículos con control de inventario y cuenta en los informes, y sus pagos deben sumar el total del ticket. Las herramientas de guardado crean un registro sin id y lo actualizan con id: loyverse_save_item, loyverse_save_variant, loyverse_save_category, loyverse_save_discount, loyverse_save_tax y loyverse_save_customer (total_points fija el saldo de puntos). Una actualización sustituye el registro entero, así que la IA lo lee antes y envía todos los campos que quieras conservar. loyverse_set_inventory recibe en stock_after la nueva cantidad absoluta, no una diferencia. loyverse_create_webhook suscribe una URL HTTPS a un evento (tickets, artículos, clientes, cambios de inventario o turnos cerrados); tipo de evento más URL deben ser únicos. Antes de un ticket o de un cambio de stock la IA te enseña las líneas, los importes o los nuevos niveles y espera tu sí.
Desactivadas al instalar: loyverse_refund_receipt, loyverse_delete_item y loyverse_delete_customer. No se pueden deshacer, así que un admin del workspace las activa cuando el equipo las necesita.
Formatos de datos: los ids son UUID; los tickets se identifican con receipt_number (p. ej. 1-1001). El dinero es un número decimal en la moneda de la cuenta (ver loyverse_get_merchant). Los tickets tienen receipt_type SALE o REFUND; los reembolsos llevan importes positivos, así que la IA los resta al sumar las ventas, y cancelled_at marca los tickets anulados. Todas las horas son UTC (ISO 8601); la IA las convierte a la zona horaria de la tienda antes de agrupar por día. Los registros borrados en el Back Office quedan ocultos salvo que show_deleted sea true.
Paginación: las herramientas de listado devuelven limit registros (50 por defecto, 250 como máximo) y un cursor mientras haya más; la IA lo vuelve a pasar como cursor hasta que falte. Tiendas, dispositivos TPV, medios de pago, descuentos e impuestos llegan todos de una vez.
Límites y errores comunes: 300 peticiones cada 300 segundos por cuenta; por encima, Loyverse responde 429 RATE_LIMITED. Los errores llegan como errors: [{code, details, field}]. 401 UNAUTHORIZED indica un token incorrecto o caducado: cópialo de nuevo o crea otro. 402 PAYMENT_REQUIRED indica que la suscripción o el complemento que incluye la API ha vencido. 403 FORBIDDEN, 404 NOT_FOUND un id erróneo, 400 INVALID_VALUE o MISSING_REQUIRED_PARAMETER con el campo indicado.
Con las herramientas activas al instalar, el conector no reembolsa tickets y no borra nada. Lee tiendas, dispositivos TPV, medios de pago, empleados, modificadores y proveedores sin crearlos ni cambiarlos, y no elimina webhooks.
Paso 2 — Instalar el adapter
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:
Loyverse. - 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
| Tool | What it does |
|---|---|
loyverse_get_merchant | Get the Loyverse account (merchant) behind the token: business name, email, country and currency with its decimal places |
loyverse_list_stores | List the stores of the account with name, address, phone and description |
loyverse_get_store | Get one store by its id (UUID) with name, address, phone number and description, as shown in the Back Office |
loyverse_list_pos_devices | List the POS devices (registers) of the account, optionally for one store, with name, store id and whether the device is activated |
loyverse_list_receipts | List sales and refund receipts, newest first, with line items, discounts, taxes, payments, totals, store, employee, customer and POS device |
loyverse_get_receipt | Get one receipt by its receipt number (e.g. 1-1001) with all line items, modifiers, discounts, taxes, payments and the refund link |
loyverse_create_receipt | Record a sales receipt in Loyverse (e.g. a sale made in another channel) |
loyverse_refund_receipt | Create a refund receipt for some or all lines of a sales receipt |
loyverse_list_shifts | List closed cash register shifts with opening and closing time, cash movements, expected and actual cash, gross and net sales, taxes and… |
loyverse_get_shift | Get one shift by id with cash drawer amounts, cash movements, sales totals, taxes and payment totals per payment type |
loyverse_list_payment_types | List payment types (cash, card, check and custom ones) with their id and type |
loyverse_get_payment_type | Get one payment type by id with its name, type (CASH, NONINTEGRATEDCARD, CHECK, OTHER and so on) and stores |
loyverse_list_items | List items of the catalog with category, taxes, modifiers, options and their variants (SKU, barcode, cost, default price and price per… |
loyverse_get_item | Get one item by id with its variants, prices per store, category, tax ids, modifier ids, stock tracking and composite components |
loyverse_save_item | Create an item, or update it when id is given (Loyverse upserts with POST) |
loyverse_delete_item | Delete an item and its variants from the catalog |
loyverse_list_variants | List item variants with SKU, barcode, option values, cost, default price and per-store price and availability |
loyverse_get_variant | Get one item variant by id with SKU, barcode, option values, cost and the price and availability in each store |
loyverse_save_variant | Create a variant of an existing item, or update it when variant_id is given (upsert with POST) |
loyverse_list_categories | List item categories with name and colour |
loyverse_get_category | Get one item category by id (UUID) with its name, colour and creation and deletion times |
loyverse_save_category | Create an item category, or rename or recolour it when id is given (Loyverse upserts with POST) |
loyverse_list_modifiers | List modifiers (e.g |
loyverse_list_discounts | List discounts with type (fixed or variable, percent or amount, by points), value, stores and whether access is restricted |
loyverse_get_discount | Get one discount by id (UUID) with its type, amount or percent, stores and restricted access flag |
loyverse_save_discount | Create a discount, or update it when id is given (upsert with POST) |
loyverse_list_taxes | List taxes with rate, type (included in the price or added to it) and stores |
loyverse_get_tax | Get one tax by id (UUID) with its name, rate in percent, type (INCLUDED or ADDED) and stores |
loyverse_save_tax | Create a tax, or update it when id is given (upsert with POST) |
loyverse_list_suppliers | List suppliers with contact name, email, phone, website, address and note |
loyverse_list_inventory | List stock levels per item variant and store (in_stock) |
loyverse_set_inventory | Set the stock of item variants in stores. stock_after is the new absolute quantity, not a change: read the current level first and confirm… |
loyverse_list_customers | List loyalty customers with contact details, customer code, note, first and last visit, total visits, total spent and points balance |
loyverse_get_customer | Get one customer by id with contact details, address, customer code, visits, total spent and loyalty points |
loyverse_save_customer | Create a customer, or update one when id is given (upsert with POST). total_points sets the loyalty balance |
loyverse_delete_customer | Delete a customer with their loyalty points |
loyverse_list_employees | List employees with name, email, phone, role and the stores they work in |
loyverse_get_employee | Get one employee by id (UUID) with name, email, phone number, owner flag and the stores they work in |
loyverse_list_webhooks | List the webhooks of the account with event type, target URL and status (ENABLED or DISABLED after failed deliveries) |
loyverse_create_webhook | Subscribe an HTTPS URL to one event: receipts, items, customers or inventory changes, or closed shifts |
Ejemplos de prompts
- "¿Cuáles fueron ayer las ventas netas por tienda, restando los reembolsos?"
- "Muéstrame el último turno cerrado de la tienda Centro con el efectivo esperado y el real."
- "¿Qué variantes tienen menos de 5 unidades en stock en la tienda Centro?"
- "Pon el stock del SKU LATTE-CUP-12 en la tienda Centro a 200. Enséñame antes el nivel actual."
- "Busca al cliente con el email [email protected] y muéstrame sus visitas, su gasto total y sus puntos."
FAQ
¿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.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?