Cómo conectar Mirakl Connect a Claude 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 + Claude

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 Claude

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.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo Mirakl Connect, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

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

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

• Página del conector
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot