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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Loyverse. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?