Resumen
Gestiona tu tienda en cualquier marketplace que funcione con Mirakl (Leroy Merlin, Conforama, BUT, home24, Maisons du Monde, Vente-unique, ePrice, Decathlon, Carrefour y muchos más) desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidencias, ofertas con precios y stock, importaciones de ofertas y productos, mensajes con clientes y con el operador, devoluciones, documentos de pedidos, facturas y transacciones. Una instalación por marketplace.
Configuración guiada
Conecta Mirakl Seller API a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Mirakl Seller API 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 Mirakl Seller API
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 → Mirakl Seller API, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Mirakl + Microsoft Copilot
Gestiona tu tienda en cualquier marketplace que funcione con Mirakl (Leroy Merlin, Conforama, BUT, home24, Maisons du Monde, Vente-unique, ePrice, Decathlon, Carrefour y muchos más) desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidencias, ofertas con precios y stock, importaciones de ofertas y productos, mensajes con clientes y con el operador, devoluciones, documentos de pedidos, facturas y transacciones. Una instalación por marketplace.
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:
MIRAKL_URL, MIRAKL_API_KEY
Paso 1 — Obtener credenciales
- Inicia sesión en el back office de vendedor del marketplace (el portal Mirakl que te dio el operador). Cada operador tiene su propia instancia de Mirakl, así que instala el conector una vez por marketplace (por ejemplo Leroy Merlin y Conforama) y nombra cada instalación según su marketplace.
- Copia la dirección del portal sin ninguna ruta en
MIRAKL_URL(más abajo están las direcciones de los marketplaces más habituales). No añadas/api: el conector lo añade solo. - Haz clic en tu nombre de usuario arriba a la derecha, abre My user settings y la pestaña API Key, genera una clave (o copia la existente) y pégala en
MIRAKL_API_KEY, sinBearer. Generar una clave nueva invalida la anterior, así que cualquier otra herramienta que la use deja de funcionar. - Solo si tu usuario gestiona varias tiendas en este marketplace (algo frecuente en home24 y Vente-unique): pon en
MIRAKL_SHOP_IDel ID numérico de la tienda que quieres usar. Déjalo vacío para usar tu tienda predeterminada. - Instala el conector y ejecuta
mirakl_get_account. Muestra la tienda a la que pertenece la clave.
Marketplaces que funcionan con Mirakl: el conector es el mismo en todos; solo cambian la dirección y la clave.
- Leroy Merlin (ADEO):
https://adeo-marketplace.mirakl.net - Conforama:
https://conforama-prod.mirakl.net - BUT:
https://but-prod.mirakl.net - home24:
https://home24.mirakl.net - Maisons du Monde:
https://maisonsdumonde-prod.mirakl.net - Vente-unique:
https://venteunique-prod.mirakl.net - ePrice:
https://marketplace.eprice.it
Los demás operadores funcionan igual, también los que tienen dominio propio: usa la dirección del back office de vendedor en el que inicias sesión.
Pedidos e incidencias: la IA lista los pedidos que esperan aceptación, acepta o rechaza cada línea, guarda el transportista y el número de seguimiento y confirma el envío. También encuentra pedidos con una incidencia abierta y, cuando el problema del cliente está resuelto, cierra la incidencia de esa línea con mirakl_resolve_incident. Los documentos adjuntos a un pedido (albaranes, etiquetas de envío, facturas al cliente) aparecen con nombre, tipo y fecha de subida; el archivo se abre en el back office.
Devoluciones: la IA lista las solicitudes de devolución con motivo, RMA, seguimiento y pedido vinculado. En los marketplaces que usan las devoluciones de Mirakl y dejan la decisión a la tienda, puede aceptar o rechazar una solicitud y confirmar que la mercancía llegó a tu almacén. Los reembolsos se quedan en el back office.
Primero confirma: la aceptación de pedidos, el seguimiento, el envío, el cierre de incidencias, las decisiones sobre devoluciones, los cambios de ofertas, los mensajes y las importaciones de productos actúan sobre el marketplace real. La IA te muestra qué va a cambiar (líneas del pedido, número de seguimiento, precio o stock anterior y nuevo, texto del mensaje) y espera tu sí. Rechazar una línea de pedido la cancela para siempre, y un mensaje enviado no se puede retirar.
Precios y stock: mirakl_update_offers sustituye la oferta completa y cada campo que falte se restablece (una cantidad que falta pasa a 0), así que la IA lee primero la oferta y la devuelve completa solo con tu cambio. mirakl_import_offers está desactivada al instalar, porque su modo REPLACE borra todas las ofertas que no estén en el archivo.
Qué lee: pedidos con cliente, dirección e incidencias, tus ofertas y las de otras tiendas para los mismos productos, mensajes, devoluciones, documentos de pedidos, las facturas del operador y las líneas de transacción (ventas, comisiones, reembolsos, pagos), además de los canales (sitios por país), transportistas, zonas de envío, métodos de envío y clases logísticas del marketplace. Con Enhanced Seller Invoicing la lista de facturas no muestra documentos nuevos, así que la IA lee las solicitudes de documentos contables y las transacciones.
Límites: Mirakl limita cada API por separado y los operadores pueden endurecer los límites. Las importaciones de productos y ofertas se ejecutan como mucho cada 15 minutos, y comparar ofertas de la competencia permite unas 5 llamadas por minuto. Una respuesta 429 indica cuántos segundos esperar.
Errores comunes: 401: la clave es incorrecta, se sustituyó por una más nueva o pertenece a otro marketplace. 403: a tu usuario le falta el permiso para esta acción. 404: el pedido, la oferta o la conversación no existe para esta tienda, o MIRAKL_URL no es la dirección del back office de vendedor. 400: un parámetro incorrecto o un pedido en el estado equivocado.
El conector no hace reembolsos, no cancela pedidos ni mueve dinero, y cada instalación trabaja con un marketplace y una tienda.
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
Mirakl. - 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 |
|---|---|
mirakl_get_account | Read the shop behind the API key on this marketplace (A01): shop id and name, state, channels, currency, grade and approval rate, contact… |
mirakl_list_orders | List orders (OR11) with their lines, customer, shipping address, prices, state and incidents |
mirakl_list_offers | List the shop's offers (OF21): SKU, product, price and discount, all channel prices, quantity in stock, condition, lead time and whether… |
mirakl_get_offer | Read one offer in full by its Mirakl offer id (OF22): every price field, discount, quantity, condition, logistic class, lead time and… |
mirakl_list_offer_conditions | List the offer conditions (OF61) the marketplace accepts, e.g. new or used, with the code to put in state_code when updating offers |
mirakl_list_offer_imports | List offer imports and updates (OF04), from files and from mirakl_update_offers: status (WAITING, RUNNING, COMPLETE, FAILED), lines read… |
mirakl_get_offer_import | Read the status of one offer import or offer update (OF02) by its import_id, as returned by mirakl_update_offers or mirakl_import_offers… |
mirakl_list_product_imports | List product imports (P51) with their status (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), the transformation counts and the… |
mirakl_get_product_import | Read the status of one product import (P42) by its import_id: import status, reason, transformation counts and the integration details… |
mirakl_get_products | Look up products in the marketplace catalog by their identifiers (P31), e.g |
mirakl_list_product_offers | List the offers of every shop for given products (P11), sorted by best price, to compare your price with the competition |
mirakl_list_threads | List message threads (M11) with customers and the operator: topic, linked order or offer, participants, last message date and since when a… |
mirakl_get_thread | Read one message thread (M10) with all its messages, senders, recipients, attachments and the linked order or offer |
mirakl_list_returns | List return requests (RT11) with their state, return lines, reason, RMA, tracking and the linked order |
mirakl_list_reasons | List the marketplace's reason codes (RE01): incident, cancellation, refund and message reasons, with their labels and whether the shop may… |
mirakl_list_carriers | List the carriers the marketplace knows (SH21) with their code, label and tracking URL |
mirakl_list_invoices | List the operator's accounting documents for the shop (IV01): invoices and credit notes with period, totals with and without tax… |
mirakl_list_transactions | List the shop's transaction lines (TL02): order amounts, shipping, commissions, refunds, manual credits and payouts, with amount, type… |
mirakl_list_document_requests | List accounting document requests (DR11), used on marketplaces with Enhanced Seller Invoicing: invoices and credit notes the operator or… |
mirakl_list_order_documents | List the documents attached to one or more orders (OR72): delivery notes, shipping labels, customer invoices and other files, with id, file… |
mirakl_list_channels | List the marketplace's sales channels (CH11), usually one per country site, with code and label |
mirakl_list_shipping_zones | List the active shipping zones of the marketplace (SH11) with code and label, e.g. mainland France or Corsica |
mirakl_list_shipping_methods | List the active shipping methods of the marketplace (SH12), e.g. standard, express or pick-up, with code, label, whether a tracking number… |
mirakl_list_logistic_classes | List the marketplace's logistic classes (SH31), the size or weight bands that decide shipping prices, with code and label |
mirakl_accept_order | Accept or refuse the lines of an order waiting for acceptance (OR21) |
mirakl_update_tracking | Set the carrier and tracking number of an order (OR23) |
mirakl_ship_order | Confirm that an order in SHIPPING has been shipped (OR24); it moves to SHIPPED and the customer is notified |
mirakl_update_offers | Create or update offers, including price and stock (OF24) |
mirakl_reply_thread | Reply in a message thread (M12) to the customer or the operator |
mirakl_create_order_thread | Start a new message thread on an order (OR43) with the customer, the operator or both |
mirakl_resolve_incident | Mark the open incident on one order line as resolved (OR64), once the customer's problem is solved. reason_code must be an INCIDENT_CLOSE… |
mirakl_accept_return | Accept or refuse a return request in WAITING_ACCEPTANCE (RT21) |
mirakl_receive_return | Confirm that the goods of an accepted return arrived at your warehouse (RT25) |
mirakl_import_products | Send a product file to the marketplace (P41) to create or enrich products in its catalog. file_url is the address of a CSV, XLSX or XML… |
mirakl_import_offers | Import an offer file (OF01) to create, update or delete offers in bulk |
Ejemplos de prompts
- "¿Qué pedidos están esperando aceptación ahora mismo y cuáles tienen una incidencia abierta?"
- "Compara nuestro precio para el EAN 3700123456789 con las ofertas de las otras tiendas en este marketplace."
- "Pon el stock del SKU LAMP-042 en 25, pero muéstrame antes la oferta actual y los nuevos valores."
- "Redacta una respuesta al mensaje del cliente sobre el pedido 20481937-A y enséñamela antes de enviarla."
- "¿Qué solicitudes de devolución en Leroy Merlin esperan nuestra decisión y qué motivo dio cada cliente?"
- "El cliente del pedido 20481937-A recibió un producto de sustitución. Cierra la incidencia de esa línea, pero enséñame antes el código de motivo."
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?