Cómo conectar ready2order a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → ready2order, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

ready2order + Cursor

Conecta el TPV ready2order (caja registradora) a tu IA: artículos, precios y stock, grupos de productos, tickets y ventas diarias, pedidos abiertos, clientes, métodos de pago y tipos de IVA, con cambios confirmados en artículos, stock y clientes.

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:

READY2ORDER_ACCOUNT_TOKEN

Paso 1 — Obtener credenciales

ready2order emite un Account Token por cada cuenta de caja mediante un breve proceso de aprobación. Lleva unos 10 minutos, una vez por cuenta, y necesitas el acceso del titular de la cuenta y un registro gratuito como desarrollador.

1. Regístrate como desarrollador en https://api.ready2order.com. ready2order te envía por correo un Developer Token.
2. Solicita el acceso con él:

   curl -X POST https://api.ready2order.com/v1/developerToken/grantAccessToken \
     -H "Authorization: Bearer <DEVELOPER_TOKEN>" -H "Content-Type: application/json" -d "{}"
   

   La respuesta contiene grantAccessToken y grantAccessUri.
3. Abre grantAccessUri antes de 10 minutos, inicia sesión con el titular de la cuenta de ready2order y haz clic en Approve.
4. Lee el Account Token:

   curl https://api.ready2order.com/v1/developerToken/grantAccessToken/<grantAccessToken> \
     -H "Authorization: Bearer <DEVELOPER_TOKEN>"
   

5. Pega el accountToken de la respuesta en READY2ORDER_ACCOUNT_TOKEN e instala el conector. El token solo se envía a ready2order y sigue siendo válido hasta que lo revoques en el admin de ready2order, en Settings → API access.

El Developer Token por sí solo se rechaza con 403: el conector necesita el Account Token.

Qué cubre: artículos con precio, IVA, número de artículo, código de barras y stock, los niveles de stock con punto de pedido y stock de seguridad, grupos de productos, tickets y facturas (Belege) con sus líneas, pagos y desglose de IVA, un enlace al PDF de cada ticket, pedidos abiertos por mesa, clientes y grupos de clientes, métodos de pago, tipos de IVA, los usuarios de la caja y si hay un cierre diario abierto.

Confirma primero: los cambios afectan a la caja en uso al instante, y un artículo nuevo aparece enseguida en el TPV. La IA indica el artículo o el cliente y los nuevos valores y espera tu sí. Puede crear y editar artículos, registrar stock (una cantidad absoluta tras un inventario, o una entrada o salida, como mercancía recibida o roturas), crear grupos de productos y crear y editar clientes. ready2order_delete_product está desactivado al instalar; para retirar un artículo de la venta, la IA lo marca como inactivo.

Cifras de ventas: ready2order_list_bills admite un rango de fechas. Por defecto las fechas siguen el cierre diario al que pertenece cada ticket (el día de negocio), o la hora del propio ticket si lo pides. Con las líneas vendidas incluidas, da las ventas por artículo. Los tickets son registros fiscales: el conector no puede modificarlos ni anularlos.

Límite de peticiones: 60 peticiones por minuto por Account Token; tras un 429, espera un minuto.

Errores comunes: 401 Sorry, but your token is invalid.: el token es incorrecto o se revocó; repite el proceso de aprobación. 403: se pegó un Developer Token en lugar del Account Token. 429: más de 60 peticiones en un minuto. 400 o 422: un campo no es válido y el mensaje lo indica, por ejemplo un artículo sin tipo de IVA.

El conector no crea ni anula tickets (storno), no imprime y no gestiona cupones, descuentos, mesas, terminales de pago, webhooks ni exportaciones contables.

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 Cursor

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 muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de ready2order.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuánto vendimos ayer y cuáles fueron los 10 artículos más vendidos?"
• "¿Qué artículos del grupo Bebidas están por debajo de su punto de pedido?"
• "Han llegado 24 botellas del artículo número 1002: súmalas al stock."
• "Sube el precio del capuchino a 4,20 y enséñame el cambio antes de guardarlo."
• "Consígueme el PDF del último ticket de Müller GmbH."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT