Resumen
Deja que tu IA gestione tu tienda del marketplace de exito.com en Colombia a través de la API para vendedores de Grupo Éxito: lista tus productos y su estado de aprobación, crea productos con imágenes, descripciones y atributos, define precios y stock, y consulta pedidos y extractos de pagos.
Configuración guiada
Conecta Grupo Éxito Marketplace a Cursor en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Grupo Éxito Marketplace con la configuración guiada y añade tu URL MCP a Cursor. 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 Grupo Éxito Marketplace
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 instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Grupo Éxito Marketplace, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Grupo Éxito Marketplace + Cursor
Deja que tu IA gestione tu tienda del marketplace de exito.com en Colombia a través de la API para vendedores de Grupo Éxito: lista tus productos y su estado de aprobación, crea productos con imágenes, descripciones y atributos, define precios y stock, y consulta pedidos y extractos de pagos.
Requisitos previos
Consulta las instrucciones completas de configuración incluidas en el conector (visibles en la tienda dentro de la aplicación cuando seleccionas el conector). Las variables de entorno necesarias para este conector son:
EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID
Paso 1 — Obtén las credenciales
La configuración lleva unos 10 minutos una vez que Éxito te ha concedido acceso a la API. Con ese acceso, Éxito te envía las instrucciones de autenticación: un usuario, una contraseña, una clave de API y la dirección que emite el token. También necesitas tu identificador numérico de vendedor.
No hay sandbox: Éxito no documenta ninguno, así que cada llamada, incluidas las de escritura, actúa sobre tu tienda real.
- Pega el usuario de la API (una dirección de correo electrónico) en
EXITO_USERNAMEy la contraseña de la API enEXITO_PASSWORD, ambos tal como figuran en las instrucciones de Éxito. - Pega el
x-api-keyde las mismas instrucciones enEXITO_API_KEY. - Pega la dirección
https://completa de la solicitud del token enEXITO_LOGIN_URL. No está publicada en developers.exito.com, así que cópiala del documento que te envió Éxito. - Introduce tu identificador numérico de vendedor (idSeller, p. ej.
11795) enEXITO_SELLER_ID.exito_marketplace_get_bulk_upload_statustambién lo muestra comodata.idSeller. - Instala el conector. Ejecuta
exito_marketplace_list_categoriespara comprobar la conexión.
Cómo inicia sesión: el conector solicita un token a la dirección del token con tu usuario, contraseña y clave de API, y lo envía junto con la clave de API en cada llamada. Los tokens se renuevan automáticamente, como máximo cada hora. La contraseña y la clave se almacenan cifradas y nunca se muestran a la IA.
La versión cloud y la autoalojada funcionan igual: las credenciales son las mismas y no hay que configurar ninguna URL de redirección.
Vender en Éxito es asíncrono:
- Elige la categoría más específica con
exito_marketplace_list_categoriesy lee sus especificaciones conexito_marketplace_get_category_features. Las especificaciones obligatorias deben enviarse; una especificación con una lista de valores solo acepta esos valores. - Crea productos con
exito_marketplace_create_products, hasta 400 EAN por llamada. Las imágenes son URL públicas de 1000x1000 px (733x1000 px para ropa). La marca debe existir ya en Éxito; tu gestor de cuenta de Éxito crea las que falten. - Sigue el lote con
exito_marketplace_get_bulk_upload_status. No se acepta ningún lote nuevo mientras otro se está iniciando o procesando. - El equipo de contenido de Éxito revisa cada producto.
exito_marketplace_get_products_waitinglista los que están en revisión,exito_marketplace_get_products_rejectedlos rechazados con el motivo, yexito_marketplace_get_products_pending_seller_approvallos que difieren del mismo producto que ya está en el marketplace. Tras la aprobación, un producto necesita hasta una hora antes de poder recibir una oferta. - Asigna precio y stock a los productos aprobados con
exito_marketplace_upsert_offerso, para un solo EAN,exito_marketplace_update_offer_price_stock.exito_marketplace_load_products_and_offersenvía productos y ofertas en una sola solicitud. Las ofertas llegan a los sitios en unas 4 horas.
Precios y stock: los precios son pesos colombianos enteros superiores a 8000, sin separadores (45000). El precio de oferta debe ser inferior al precio. Para cambiar solo el precio, envía el stock actual con IsUpdatedStock 0. Un cambio de precio de más del 30 % devuelve el código PEX y debe enviarse de nuevo con aprobación de precio: la IA te pregunta antes de hacerlo. Para dejar de vender un producto, pon su stock en 0: la API no permite eliminar.
Pedidos y pagos: exito_marketplace_get_orders lista los pedidos de exito.com, carulla.com y otros sitios de Éxito, con estado, totales, comisión y tipo de entrega. exito_marketplace_get_bills lista los extractos de pagos. Las listas se paginan con paginationToken.
Desactivadas en la instalación: exito_marketplace_set_order_tracking (marca los productos de un pedido como enviados, con transportista y número de seguimiento) y exito_marketplace_upload_order_invoice (adjunta la factura a un pedido). Actívalas en la página del conector cuando quieras que la IA gestione pedidos; la IA te pide confirmación en cada llamada. La creación de productos y la definición de precios y stock están activadas (exito_marketplace_create_products, exito_marketplace_load_products_and_offers, exito_marketplace_upsert_offers, exito_marketplace_update_offer_price_stock).
Lee cada respuesta: las escrituras por lotes responden HTTP 200 con un mensaje por cada EAN rechazado, así que un 200 no significa que todos los productos u ofertas se hayan aceptado. Las solicitudes y respuestas están en español.
No cubierto: etiquetas de envío, la moderación y las notificaciones de ofertas de Éxito, y cualquier cosa que haga la aplicación web Seller Center y que la API no ofrezca.
Errores comunes: si no se emite ningún token, comprueba el usuario, la contraseña y la clave de API con las instrucciones de Éxito, y que EXITO_LOGIN_URL sea la dirección del token de ese documento. 401 significa que el token fue rechazado. 403 suele significar que falta la clave de API, que es incorrecta o que la API no está habilitada para tu usuario: pregunta a Éxito qué APIs cubre tu acceso.
Paso 2 — Instala el adaptador
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ñade 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 muestraYOUR_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" }
}
}
}
- 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. - Guarda el archivo y reinicia Cursor.
- Abre Cursor → Settings → MCP y comprueba que
anythingmcpaparece en la lista y está conectado. - Empieza a chatear: el agente ya puede usar las herramientas de
Grupo Éxito Marketplace.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
exito_marketplace_get_products | Lista los productos del vendedor en el marketplace de Éxito con nombre, EAN, PLU de VTEX, imagen, fechas de creación y actualización, precio, precio de oferta, stock… |
exito_marketplace_get_products_waiting | Productos pendientes de aprobación por el equipo de contenido de Éxito (moderación), con EAN, nombre, imagen, fecha de procesamiento y referencia padre |
exito_marketplace_get_products_rejected | Productos que el equipo de contenido de Éxito rechazó y que deben corregirse, con EAN, nombre, imagen, Reason y Comment del rechazo |
exito_marketplace_get_products_pending_seller_approval | Productos que requieren tu decisión porque difieren del mismo producto que ya está en el marketplace: cada fila tiene oldProduct y… |
exito_marketplace_get_bulk_upload_status | Estado de tu último lote de creación de productos (exito_marketplace_create_products). data.status: 4 iniciando, 1 procesando, 2 completado… |
exito_marketplace_list_categories | Todas las categorías del marketplace de Éxito con Id, IdParent, Name y ProductType (Technology o Clothing) |
exito_marketplace_get_category | Una categoría por id: Id, IdParent, Name y ProductType |
exito_marketplace_get_category_features | Grupos de especificaciones de una categoría: para cada especificación, su specName, label, si es obligatoria y sus valores permitidos (values[].label; un… |
exito_marketplace_get_orders | Pedidos recibidos a través de los sitios de Éxito (exito.com, carulla.com y otros) con número de pedido, canal, fechas, estado, totales, comisión… |
exito_marketplace_get_bills | Extractos de pagos (facturación) del vendedor: número de facturación, número de pedido, orden de pago, concepto, fecha de pago, comisión, total, IVA y… |
exito_marketplace_create_products | Crea productos (o modifica los existentes: envía de nuevo el mismo EAN; ModifyImage "1" reemplaza las imágenes) con título, descripción HTML… |
exito_marketplace_load_products_and_offers | Envía productos junto con sus ofertas en una sola solicitud: cada elemento tiene un Product (los campos de exito_marketplace_create_products) y un… |
exito_marketplace_upsert_offers | Crea o actualiza ofertas (precio, precio de oferta, stock, envío y promesa de entrega) para los EAN que Éxito ya aprobó, en todos los sitios de Éxito… |
exito_marketplace_update_offer_price_stock | Cambia el precio y/o el stock de una oferta existente (un EAN). Éxito necesita EAN, Stock y Price en cada actualización: para cambiar solo el precio… |
exito_marketplace_set_order_tracking | Marca productos de un pedido como enviados con el transportista y el número de seguimiento (pedidos con entrega estándar) |
exito_marketplace_upload_order_invoice | Adjunta la factura de un pedido como PDF o ZIP en base64 |
Prompts de ejemplo
- "¿Cuáles de mis productos rechazó Éxito y por qué?"
- "Muéstrame los pedidos que me han asignado esta semana y que aún hay que enviar."
- "¿Cuál es el precio y el stock del EAN 7701234567890 en exito.com?"
- "Pon el stock del EAN 7701234567890 en 25 unidades y mantén el precio."
- "Suma la comisión de mis extractos de pagos de octubre."
Preguntas frecuentes
¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.
Siguientes pasos
¿Te ha sido útil esta guía?