Cómo conectar Mirakl Connect a Microsoft Copilot vía MCP

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

Mirakl Connect + Microsoft Copilot

Mirakl Connect para vendedores: pedidos de todos los marketplaces y canales conectados en un solo lugar, devoluciones, documentos, conversaciones con clientes y el catálogo de Connect con precios y stock. No es la Mirakl Seller API de un único marketplace. Envío, cancelación y aceptación vienen desactivados.

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_CONNECT_CLIENT_ID, MIRAKL_CONNECT_CLIENT_SECRET

Paso 1 — Obtener credenciales

No es la Mirakl Seller API: el conector aparte Mirakl Seller API (mirakl) habla con un marketplace basado en Mirakl cada vez, a través de su propia https://<marketplace>.mirakl.net/api con una clave API de tienda. Mirakl Connect es la plataforma de canales del lado del vendedor que está por encima: un solo login y una sola API (https://miraklconnect.com/api) para todos los marketplaces y canales de venta de tu empresa, con sus propios id de pedido, credenciales OAuth2 y endpoints. Instala este cuando tu empresa trabaje en Mirakl Connect.

La configuración lleva unos 5 minutos.

1. Crea en Mirakl Connect credenciales API OAuth2 para tu empresa, como describe la guía de Mirakl Integrating with Connect APIs (ayuda de Mirakl Connect para vendedores). Obtienes un client ID y un client secret; el secret se muestra una sola vez.
2. Pégalos en MIRAKL_CONNECT_CLIENT_ID y MIRAKL_CONNECT_CLIENT_SECRET. AnythingMCP los cambia en el Mirakl Authentication System (https://auth.mirakl.net/oauth/token, grant client credentials) por un token bearer de aproximadamente una hora y lo renueva por su cuenta.
3. Instala el conector y ejecuta mirakl_connect_list_orders: lista tus últimos pedidos y confirma las credenciales.

Id de pedido y canales: cada pedido tiene un id de pedido de Connect (id), que piden mirakl_connect_get_order y las herramientas de escritura, y el número de pedido propio del canal en channel_order_id. El canal de venta y la tienda están en origin (channel_name, channel_store_name). La Mirakl Connect API no tiene un endpoint que liste tus canales conectados; la IA los obtiene del origin de los pedidos.

Qué lee: los pedidos de todos los canales conectados, primero los actualizados más recientemente, con estado, origen, líneas de pedido (producto, cantidad, precio, impuestos, estado de la línea), datos de envío y facturación y tipo de gestión (FULFILLED_BY_SELLER o FULFILLED_BY_PARTNER); sin updated_from ni id, Mirakl devuelve los últimos 30 días. El catálogo de productos de Connect con títulos, marca, categoría, GTIN, imágenes, precios estándar y con descuento, cantidades de stock y atributos. Las devoluciones de todos los canales, con estado (REQUEST_INITIATED, REQUEST_DECLINED, OPENED, RECEIVED, CLOSED), líneas de devolución, método, id de RMA, URL de la etiqueta, seguimiento y motivo de rechazo. Los documentos de los pedidos como facturas al cliente, albaranes y etiquetas de devolución. Las conversaciones de clientes sobre pedidos y los mensajes de una conversación con autor, texto y adjuntos. El resultado de una acción asíncrona sobre un pedido.

Filtros: los pedidos se filtran por statuses, updated_from, fulfillment_type e id de pedido. Las devoluciones necesitan updated_from. Los documentos necesitan id de pedido o updated_from, y las conversaciones updated_from o id de conversación.

Desactivadas al instalar: mirakl_connect_ship_order (marca las líneas como enviadas y pasa transportista y seguimiento al canal, que normalmente avisa al cliente), mirakl_connect_cancel_order_lines (al cliente se le reembolsa y avisa en el canal; no se puede deshacer) y mirakl_connect_accept_order_lines (acepta o rechaza líneas en AWAITING_ACCEPTANCE; rechazar cancela la línea y no se puede deshacer). Actúan sobre el canal de venta en vivo, así que un admin las activa de forma deliberada. Aun así, la IA te muestra el pedido, las líneas y los valores y espera tu sí, tomando los id de línea de order_lines[].id del pedido. Estas llamadas son asíncronas: devuelven un action_id, y la IA comprueba el resultado con mirakl_connect_get_action_status, porque el canal todavía puede rechazar la acción.

Paginación y límites: cada lista responde con next_page_token mientras haya más elementos, y la IA lo pasa como page_token. Pedidos y devoluciones vienen por defecto de 10 en 10 (hasta 100), documentos y conversaciones de 50 en 50 (hasta 100); los productos llegan hasta 1000 por página, y la IA usa un tamaño pequeño salvo que necesite todo el catálogo. Mirakl pide llamar a las listas de pedidos, devoluciones y productos como máximo una vez por minuto al sincronizar. Las fechas son ISO 8601 con zona horaria.

Errores comunes: 401 significa client ID o secret incorrectos, o un token caducado. 403 significa que al cliente API le falta el scope para esa llamada, p. ej. connect:order:read o connect:shipment:create. 402 significa que la función, p. ej. las conversaciones, no forma parte del plan de Mirakl Connect de la cuenta. 404 indica un id de pedido o de conversación desconocido. 429 significa demasiadas llamadas: espera a Retry-After.

El conector no cambia precios ni stock, no responde a conversaciones, no crea devoluciones y no conecta canales nuevos. Para un único marketplace de Mirakl sin Mirakl Connect, usa el conector Mirakl Seller API.

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 Mirakl Connect.
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é pedidos han entrado desde ayer en todos nuestros canales, agrupados por canal?"
• "Busca el pedido con número de pedido del canal 405-1234567-1234567 y muestra sus líneas y su estado."
• "Lista las devoluciones abiertas esta semana con canal, motivo y seguimiento."
• "Muestra las conversaciones de clientes actualizadas hoy y resume qué quiere cada cliente."
• "Envía la línea 1 de este pedido con el seguimiento de DHL 00340434161234567890. Muéstrame antes el pedido y las líneas."

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