Cómo conectar Xentral a Gemini 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 + Gemini

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a 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

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

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