Guía de conector8 minutos de lectura16 herramientas MCP7 idiomas

Conectar Éxito a Claude vía MCP: productos y pedidos

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.

HCPor el equipo de HelpCodeActualizado 8 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Grupo Éxito Marketplace

Grupo Éxito Marketplace

Let your AI run your exito.com marketplace store in Colombia through Grupo Éxito's seller API: list your products and their approval status, create products with images, descriptions and attributes, set prices and stock, and read orders and payout statements.

herramientas

16

Región

INTL

Categoría

E-commerce

Autenticación

Sign-in token

Env vars requeridas

EXITO_USERNAMEEXITO_PASSWORDEXITO_API_KEYEXITO_LOGIN_URLEXITO_SELLER_ID
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

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 Claude 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 Claude. Sin código y sin servidores que mantener.

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.

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.

Grupo Éxito Marketplace · live vía MCP
Compartir
Opus 4.7

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 + Claude

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.

  1. Pega el usuario de la API (una dirección de correo electrónico) en EXITO_USERNAME y la contraseña de la API en EXITO_PASSWORD, ambos tal como figuran en las instrucciones de Éxito.
  2. Pega el x-api-key de las mismas instrucciones en EXITO_API_KEY.
  3. Pega la dirección https:// completa de la solicitud del token en EXITO_LOGIN_URL. No está publicada en developers.exito.com, así que cópiala del documento que te envió Éxito.
  4. Introduce tu identificador numérico de vendedor (idSeller, p. ej. 11795) en EXITO_SELLER_ID. exito_marketplace_get_bulk_upload_status también lo muestra como data.idSeller.
  5. Instala el conector. Ejecuta exito_marketplace_list_categories para 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:

  1. Elige la categoría más específica con exito_marketplace_list_categories y lee sus especificaciones con exito_marketplace_get_category_features. Las especificaciones obligatorias deben enviarse; una especificación con una lista de valores solo acepta esos valores.
  2. 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.
  3. Sigue el lote con exito_marketplace_get_bulk_upload_status. No se acepta ningún lote nuevo mientras otro se está iniciando o procesando.
  4. El equipo de contenido de Éxito revisa cada producto. exito_marketplace_get_products_waiting lista los que están en revisión, exito_marketplace_get_products_rejected los rechazados con el motivo, y exito_marketplace_get_products_pending_seller_approval los 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.
  5. Asigna precio y stock a los productos aprobados con exito_marketplace_upsert_offers o, para un solo EAN, exito_marketplace_update_offer_price_stock. exito_marketplace_load_products_and_offers enví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 Claude

La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestre YOUR_SERVER_ID.

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

  1. En Claude, abre Plugins (en algunos planes aún Customize) → Connectors.
  2. Haz clic en + Add y luego en Add custom connector.
  3. Escribe un nombre, p. ej. Grupo Éxito Marketplace, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y haz clic en Continue, deja los ajustes detectados y vuelve a hacer clic en Continue.
  4. Elige Sign in now, haz clic en Add e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas de abajo aparecen en tu chat: empieza a escribir tus prompts.

Herramientas disponibles

HerramientaQué hace
exito_marketplace_get_productsLista 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_waitingProductos 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_rejectedProductos 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_approvalProductos 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_statusEstado de tu último lote de creación de productos (exito_marketplace_create_products). data.status: 4 iniciando, 1 procesando, 2 completado…
exito_marketplace_list_categoriesTodas las categorías del marketplace de Éxito con Id, IdParent, Name y ProductType (Technology o Clothing)
exito_marketplace_get_categoryUna categoría por id: Id, IdParent, Name y ProductType
exito_marketplace_get_category_featuresGrupos 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_ordersPedidos 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_billsExtractos 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_productsCrea 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_offersEnví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_offersCrea 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_stockCambia 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_trackingMarca productos de un pedido como enviados con el transportista y el número de seguimiento (pedidos con entrega estándar)
exito_marketplace_upload_order_invoiceAdjunta 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

¿Funciona con Claude Code además de Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

¿Te ha sido útil esta guía?

Conecta Grupo Éxito Marketplace a Claude 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 Claude. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conectar Éxito a ChatGPT vía MCP: ofertas e inventario

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.

Conectores

Conectar Éxito a Microsoft Copilot vía MCP

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.

Conectores

Conectar Éxito a Cursor vía MCP: carga del catálogo

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.

Conectores

Conectar Éxito a Gemini CLI vía MCP: pedidos

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.

Conectores

Conectar Éxito a Meta Muse vía MCP: pedidos de la tienda

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.

Conectores

Éxito MCP Server: productos, ofertas y pedidos

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 pago.