Cómo conectar Xentral a Cursor vía MCP

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

Xentral + Cursor

Conecta Xentral ERP con tu IA: busca productos y stock por almacén y ubicación, clientes y proveedores, pedidos de venta, albaranes con seguimiento del envío, facturas con estado de pago, abonos, pedidos de compra y facturas de proveedores, y crea borradores de pedidos de venta. Con la API actual de Xentral y un Personal Access Token.

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:

XENTRAL_URL, XENTRAL_TOKEN

Paso 1 — Obtener credenciales

1. En Xentral, haz clic en Administration abajo a la izquierda y luego en Account settings (Kontoeinstellungen) → Developer settings (Developer Einstellungen) → Personal Access Tokens. Más rápido: escribe "Personal Access Token" en la Smart Search. Necesitas una cuenta de administrador.
2. Haz clic en Create token (Token erzeugen) y ponle al token un nombre como AnythingMCP-Read, una descripción y una duración (180 días por defecto).
3. Concede Read en las áreas que la IA debe ver: productos y stock, clientes (CRM), documentos de venta (pedidos de venta, albaranes, facturas, abonos), compras (pedidos de compra, proveedores, obligaciones con proveedores) y ajustes como formas de pago y proyectos. Añade Create y Delete sobre pedidos de venta solo si la IA puede preparar borradores de pedido. Deja fuera los scopes de Admin.
4. Haz clic en Create y copia el token enseguida: Xentral lo muestra una sola vez.
5. Pon en XENTRAL_URL la dirección con la que abres Xentral, por ejemplo https://acme.xentral.biz (o tu propio dominio), sin /api, sin ruta y sin barra final. Pega el token solo en XENTRAL_TOKEN, sin la palabra Bearer, e instala el conector.
6. Empieza con xentral_list_products: si devuelve productos, la URL y el token funcionan.

Duración y permisos del token: un token caduca en la fecha que elegiste, y Xentral borra los tokens que llevan 180 días sin usarse. Sus permisos no se pueden editar después: para cambiarlos, crea un token nuevo y sustituye XENTRAL_TOKEN. La IA solo ve las áreas que el token puede leer.

Ids, no números impresos: cada herramienta usa el id interno de Xentral, no el número de producto, documento o cliente que aparece impreso. La IA busca primero el id con una herramienta de listado, con un filtro sobre number, documentNumber o customerNumber, o con search. El id de un cliente es también su id de dirección: los documentos lo muestran como address.id, y xentral_create_sales_order lo recibe como addressId. Los filtros de clientes solo encuentran coincidencias exactas, así que para encontrar un cliente por parte del nombre la IA busca sus documentos con xentral_list_invoices o xentral_list_sales_orders y toma de ahí address.id.

Filtros: las herramientas de listado aceptan condiciones que deben cumplirse todas, cada una con un campo (key), un operador (op) y un valor (value). Las facturas pendientes, por ejemplo: [{"key": "paymentStatus", "op": "in", "value": ["pending", "partiallyPaid"]}]. Entre los operadores están equals, in, contains, startsWith, greaterThanOrEquals y lessThan; cada herramienta indica los campos que acepta. Las fechas de los documentos van en formato YYYY-MM-DD.

Buscar y ordenar documentos: en pedidos de venta, albaranes, facturas, abonos y pedidos de compra, search busca en el número del documento, el nombre y el número del cliente o proveedor, el email, el código postal y los números de pedido externos. sort acepta nombres de campo, un signo menos delante ordena de forma descendente (-documentDate), e include añade datos relacionados como lineItems (líneas) o address.

Estados: los pedidos de venta son draft, released, completed o cancelled; las facturas, los albaranes y los pedidos de compra también pueden ser sent. El estado de pago (paymentStatus) de facturas y abonos es pending, paid, partiallyPaid, cancelled, partiallyCancelled, badDebt o debited.

Stock: xentral_get_product_stock devuelve los totales y las mismas cifras por almacén y por canal de venta. sellable es lo que aún se puede prometer a un cliente, physical lo que hay en las estanterías, reserved lo que retienen los pedidos abiertos. Los almacenes (Lager) contienen ubicaciones (Lagerplätze): xentral_list_product_storage_locations muestra dónde está un producto, xentral_list_storage_location_items qué hay en una ubicación.

Envíos y pagos: xentral_list_delivery_note_shipments devuelve el transportista, el número de seguimiento y el enlace de seguimiento de un albarán. xentral_get_invoice_balance muestra los pagos registrados en una factura y cuánto queda pendiente.

Páginas: los listados de documentos aceptan page y perPage (hasta 1000, 25 por defecto); los demás listados, page y pageSize (de 10 a 50).

Escritura: xentral_create_sales_order solo crea un borrador para un cliente existente: sin número de pedido, y no se reserva ni se envía nada hasta que alguien lo revise y lo libere en Xentral. Si la IA no indica precios, Xentral usa los del cliente y del producto. xentral_delete_sales_order_draft borra un borrador así y viene desactivada al instalar; Xentral no permite borrar pedidos liberados, completados o cancelados. Todas las demás herramientas solo leen.

Solo lectura: dale al token solo permisos Read y desactiva xentral_create_sales_order en la página del conector.

Límite de uso: Xentral permite unas 100 solicitudes por minuto por instancia, sea cual sea el plan; por encima responde 429 con una cabecera Retry-After. Mejor un listado filtrado que muchas consultas sueltas.

Errores frecuentes: 401 significa que el token es incorrecto, caducó o se borró. 403 significa que al token le falta el permiso para esa área: crea un token nuevo que lo tenga. 400 "Generic request validation failed" o "filter must be an array" indica un campo de filtro o un operador que la herramienta no acepta, o un valor mal formado. 404 "Route not found" significa que XENTRAL_URL contiene una ruta como /api/v1, o que la instancia aún no ofrece ese endpoint. 409 al borrar un pedido de venta significa que ya no es un borrador.

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

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántas unidades del producto 700123 podemos vender todavía en cada almacén, y en qué ubicaciones está?"
• "¿Qué facturas siguen sin pagar o están pagadas solo en parte? Muéstrame cliente, importe y nivel de reclamación, primero las más antiguas."
• "¿Dónde está el paquete del pedido 200345? Dame el transportista y el enlace de seguimiento."
• "Crea un borrador de pedido de venta para el cliente 10001 con 20 unidades del producto 700123 y 5 unidades del producto 700456, fecha de entrega deseada el 20 de octubre."

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