Resumen
JTL Fulfillment Network (JTL-FFN) para comerciantes: productos, existencias por almacén, pedidos de salida con estado de envío y seguimiento, entradas de mercancía, devoluciones, almacenes y métodos de envío de tus proveedores de fulfillment. Crea o cancela pedidos de salida cuando lo pidas. OAuth2.
Configuración guiada
Conecta JTL Fulfillment Network a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta JTL Fulfillment Network con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para JTL Fulfillment Network
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → JTL Fulfillment Network, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin
git clone, sin servidor local.
JTL Fulfillment Network + Microsoft Copilot
JTL Fulfillment Network (JTL-FFN) para comerciantes: productos, existencias por almacén, pedidos de salida con estado de envío y seguimiento, entradas de mercancía, devoluciones, almacenes y métodos de envío de tus proveedores de fulfillment. Crea o cancela pedidos de salida cuando lo pidas. OAuth2.
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:
JTL_FFN_CLIENT_ID, JTL_FFN_CLIENT_SECRET
Paso 1 — Obtener credenciales
- Inicia sesión una vez en fulfillment.jtl-software.com con tu cuenta de JTL, que necesita el rol Merchant. Hasta ese primer inicio de sesión, la API responde 404 para tu usuario.
- Abre kundencenter.jtl-software.de/oauth (la página no aparece en el menú del Kundencenter) y crea un cliente OAuth con los scopes
ffn.merchant.readyffn.merchant.write. URI de redirección:https://cloud.anythingmcp.com/api/mcp-oauth/callbacken AnythingMCP Cloud, o<your AnythingMCP URL>/api/mcp-oauth/callbacksi lo alojas en tu propio servidor. - Pega el ID y el secreto del cliente en
JTL_FFN_CLIENT_IDyJTL_FFN_CLIENT_SECRET, instala el conector y luego haz clic en Authorize with Provider en la página del conector. Los tokens de acceso duran 30 minutos y se renuevan automáticamente. - Empieza con
jtl_ffn_get_current_usery luego usajtl_ffn_list_warehousesyjtl_ffn_list_products. Para un pedido,jtl_ffn_get_outboundmuestra su estado yjtl_ffn_list_outbound_shipping_notifications, los paquetes con su seguimiento.
Un jfsku es el identificador de producto de 11 caracteres de JTL (p. ej. MERC01PRDCT), no tu propio SKU (merchantSku); las herramientas de pedidos de salida y de entradas de mercancía aceptan tanto el ID de FFN como tu propio número de pedido. filter admite expresiones de estilo OData como status eq 'Shipped'. jtl_ffn_create_outbound y jtl_ffn_cancel_outbound se instalan desactivadas: actívalas de forma consciente y confirma los datos antes de cada llamada. Las listas admiten limit (50 por defecto) y offset.
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 muestraYOUR_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.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - 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.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
JTL Fulfillment Network. - 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
| Tool | What it does |
|---|---|
jtl_ffn_get_current_user | Return the JTL-FFN user behind the authorization: user id (your 4-character merchant id), address and roles |
jtl_ffn_list_warehouses | List the fulfiller warehouses authorized for this merchant, with warehouseId, fulfillerId, name, address and the shippingMethodIds each… |
jtl_ffn_list_fulfillers | List the fulfillment providers this merchant works with: 4-character userId (the fulfillerId used elsewhere), active flag and address |
jtl_ffn_list_shipping_methods | List the shipping methods the fulfillers allow this merchant to use: shippingMethodId, name, carrierName, carrierCode, shippingType… |
jtl_ffn_list_products | List the merchant's products in JTL-FFN with jfsku, merchantSku, name, identifiers (EAN, ASIN, MPN), dimensions, weight and attributes |
jtl_ffn_get_product | Get one product by its jfsku with all master data: name, merchantSku, identifiers, specifications (batch, best-before, serial number, bill… |
jtl_ffn_list_stock_levels | List stock for all products across all warehouses: per jfsku the available stockLevel, stockLevelReserved (held by outbounds)… |
jtl_ffn_get_product_stock | Get the stock of one product by jfsku: available, reserved, announced and blocked quantities, split by warehouse and fulfiller, by batch… |
jtl_ffn_list_warehouse_stock | List the stock of all products in one warehouse: per jfsku and merchantSku the available, reserved, announced and blocked quantities |
jtl_ffn_list_outbounds | List outbound orders (shipments the fulfiller sends to customers) with outboundId, merchantOutboundNumber, status (Preparation, Pending… |
jtl_ffn_get_outbound | Get one outbound order with its status, status timestamps, shipping address, items with open quantities, shipping method, notes and cancel… |
jtl_ffn_list_outbound_shipping_notifications | Get the shipping notifications the fulfiller posted for an outbound: shipped items with batch and serial numbers, and the packages with… |
jtl_ffn_list_outbound_changes | Change feed of outbounds modified within a time window (status changes, shipments, cancellations) |
jtl_ffn_list_inbounds | List inbound deliveries announced to the fulfillers' warehouses with inboundId, merchantInboundNumber, status (Preparation, Pending… |
jtl_ffn_get_inbound | Get one inbound delivery with its status, warehouse, supplier, purchase order number, note and items with announced quantities |
jtl_ffn_list_inbound_shipping_notifications | Get the shipping notifications of an inbound delivery, i.e. what is on its way to the warehouse: packages with tracking identifiers… |
jtl_ffn_list_returns | List customer returns with returnId, merchantReturnNumber, state (Announced, Arrived, Completed), warehouse, customer address, returned… |
jtl_ffn_get_return | Get one customer return by returnId with its state, items (condition, linked outbound), labels and notes |
jtl_ffn_list_cancel_reasons | List the standard cancel reasons of JTL-FFN (code and name) |
jtl_ffn_create_outbound | Create a new outbound order: the fulfiller will pick, pack and ship these items to the address, which costs money and cannot be undone once… |
jtl_ffn_cancel_outbound | Cancel an outbound order by setting its status to Canceled |
jtl_ffn_create_inbound | Announce an inbound delivery (Anlieferung, e.g. new stock from a supplier or production) to the fulfiller's warehouse, so the fulfiller can… |
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
¿Te ha sido útil esta guía?