Cómo conectar Haufe X360 a Microsoft Copilot 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 + Microsoft Copilot

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

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. 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.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Haufe X360.
6. 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

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

¿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