Cómo conectar Haufe X360 a Gemini vía MCP

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

Haufe X360 + Gemini

Haufe X360, ERP en la nube (la edición alemana de Acumatica): clientes, proveedores, artículos de inventario, pedidos de venta, facturas de clientes y envíos a través de la REST API contract-based. Inicio de sesión con un usuario de X360. Solo lectura.

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:

X360_URL, X360_TENANT, X360_ENDPOINT_VERSION, X360_USERNAME, X360_PASSWORD

Paso 1 — Obtener credenciales

1. Pide a tu administrador de X360 o a tu partner de Haufe un usuario de integración dedicado, con los roles para las pantallas que debe leer: clientes, proveedores, artículos de inventario, pedidos de venta, facturas y envíos. X360 comprueba los mismos derechos de acceso que en el navegador, así que la IA solo ve lo que este usuario puede ver.
2. Pon en X360_URL la dirección con la que abres X360 en el navegador, hasta /Main o /Frames sin incluirlos, sin barra final.
3. Pon en X360_TENANT el nombre del tenant (empresa) que eliges en la pantalla de inicio de sesión de X360.
4. Pon en X360_ENDPOINT_VERSION una versión del endpoint Default que aparezca en el formulario Web Service Endpoints (SM207060), por ejemplo 24.200.001. Las versiones anteriores como 20.200.001 o 23.200.001 también sirven: los campos que usan estas herramientas son los mismos en todas.
5. Pon en X360_USERNAME y X360_PASSWORD las credenciales del usuario de integración.
6. Instala el conector y ejecuta haufe_x360_list_customers con pocos registros para comprobar la conexión.

Basado en Acumatica: Haufe X360 es la edición alemana de Acumatica, y cada tenant de X360 incluye el endpoint de servicio web predefinido Default de Acumatica. Ese es el endpoint que lee el conector.

Solo lectura por diseño: la IA lee clientes, proveedores, artículos de inventario, pedidos de venta, facturas de clientes con notas de crédito y envíos. Ninguna herramienta crea, cambia ni libera un documento.

Sesiones y licencia: tu licencia de X360 limita cuántas sesiones de API pueden estar abiertas a la vez. El conector mantiene una sola sesión, la reutiliza en cada llamada y vuelve a iniciar sesión cuando caduca.

Primero, pocos registros: sin límite la API devuelve todos los registros, así que la IA siempre pide un número limitado de registros en la primera llamada. Las líneas de pedidos y facturas solo llegan cuando expande Details; si no, lee solo la cabecera.

Lo que responde bien: qué facturas de clientes siguen abiertas y por qué importe (haufe_x360_list_invoices), pedidos de venta por estado con sus líneas (haufe_x360_list_sales_orders), qué pedidos de venta cubre un envío (haufe_x360_list_shipments), y las condiciones de pago y los ajustes de crédito de un cliente (haufe_x360_get_customer).

Crear, cambiar o liberar documentos queda fuera del alcance, igual que todo lo que vaya más allá de clientes, proveedores, artículos de inventario, pedidos de venta, facturas de clientes y envíos.

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 Haufe X360.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué facturas de clientes están vencidas y cuánto queda pendiente por cliente?"
• "Muéstrame los pedidos de venta abiertos del cliente C000123 con sus líneas y el total del pedido."
• "¿Qué envíos salieron la semana pasada y qué pedidos de venta cubrió cada uno?"
• "Enumera nuestros proveedores activos con su clase de proveedor y sus condiciones de pago."

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
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot