Cómo conectar Mirakl a Cursor vía MCP

💡 ¿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 + Cursor

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

1. 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.
2. 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.
3. 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, sin Bearer. Generar una clave nueva invalida la anterior, así que cualquier otra herramienta que la use deja de funcionar.
4. Solo si tu usuario gestiona varias tiendas en este marketplace (algo frecuente en home24 y Vente-unique): pon en MIRAKL_SHOP_ID el ID numérico de la tienda que quieres usar. Déjalo vacío para usar tu tienda predeterminada.
5. 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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Mirakl.

Herramientas disponibles

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

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT