Guida al connettore8 minuti di lettura16 tool MCP7 lingue

Collegare Éxito a Claude via MCP: prodotti e ordini

Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.

HCA cura del team HelpCodeAggiornato 8 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

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.

tool

16

Regione

INTL

Categoria

E-commerce

Autenticazione

Sign-in token

Env vars richieste

EXITO_USERNAMEEXITO_PASSWORDEXITO_API_KEYEXITO_LOGIN_URLEXITO_SELLER_ID
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

In breve

Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.

Configurazione guidata

Collega Grupo Éxito Marketplace a Claude in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Grupo Éxito Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.

Prova a chiedere

Prompt di esempio per Grupo Éxito Marketplace

Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.

Grupo Éxito Marketplace · live via MCP
Condividi
Opus 4.7

Claude è un'AI e può sbagliare. Verifica sempre le risposte.

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → Grupo Éxito Marketplace, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente git clone, nessun server locale.

Grupo Éxito Marketplace + Claude

Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.

Prerequisiti

Consulta le istruzioni di configurazione complete incluse nel connettore (visibili nello store in-app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 10 minuti una volta che Éxito ti ha concesso l'accesso all'API. Insieme all'accesso, Éxito invia le istruzioni di autenticazione: un nome utente, una password, una chiave API e l'indirizzo che emette il token. Ti serve anche il tuo seller id numerico.

Non esiste una sandbox: Éxito non ne documenta nessuna, quindi ogni chiamata, scritture incluse, agisce sul tuo negozio reale.

  1. Incolla l'utente API (un indirizzo e-mail) in EXITO_USERNAME e la password API in EXITO_PASSWORD, entrambi tratti dalle istruzioni di Éxito.
  2. Incolla la x-api-key delle stesse istruzioni in EXITO_API_KEY.
  3. Incolla l'indirizzo https:// completo della richiesta del token in EXITO_LOGIN_URL. Non è pubblicato su developers.exito.com, quindi copialo dal documento inviato da Éxito.
  4. Inserisci il tuo seller id numerico (idSeller, ad es. 11795) in EXITO_SELLER_ID. Lo mostra anche exito_marketplace_get_bulk_upload_status come data.idSeller.
  5. Installa il connettore. Esegui exito_marketplace_list_categories per verificare la connessione.

Come effettua l'accesso: il connettore richiede un token all'indirizzo del token con il tuo nome utente, la password e la chiave API, e lo invia insieme alla chiave API a ogni chiamata. I token vengono rinnovati automaticamente, al più tardi ogni ora. La password e la chiave sono memorizzate cifrate e non vengono mai mostrate all'AI.

Cloud e self-hosted funzionano allo stesso modo: le credenziali sono le stesse e non c'è nessun URL di reindirizzamento da impostare.

Vendere su Éxito è asincrono:

  1. Scegli la categoria più specifica con exito_marketplace_list_categories e leggi le sue specifiche con exito_marketplace_get_category_features. Le specifiche obbligatorie devono essere inviate; una specifica con un elenco di valori accetta solo quelli.
  2. Crea i prodotti con exito_marketplace_create_products, fino a 400 EAN per chiamata. Le immagini sono URL pubblici, da 1000x1000 px (733x1000 px per l'abbigliamento). Il marchio deve già esistere presso Éxito; il tuo account manager di Éxito crea quelli mancanti.
  3. Segui il lotto con exito_marketplace_get_bulk_upload_status. Non viene accettato nessun nuovo lotto finché uno è in fase di avvio o elaborazione.
  4. Il team dei contenuti di Éxito revisiona ogni prodotto. exito_marketplace_get_products_waiting elenca quelli in revisione, exito_marketplace_get_products_rejected quelli rifiutati con il motivo e exito_marketplace_get_products_pending_seller_approval quelli che differiscono dallo stesso prodotto già presente nel marketplace. Dopo l'approvazione, un prodotto ha bisogno fino a un'ora prima di poter ricevere un'offerta.
  5. Assegna ai prodotti approvati un prezzo e una giacenza con exito_marketplace_upsert_offers oppure, per un singolo EAN, exito_marketplace_update_offer_price_stock. exito_marketplace_load_products_and_offers invia prodotti e offerte in un'unica richiesta. Le offerte raggiungono i siti entro circa 4 ore.

Prezzi e giacenze: i prezzi sono in pesos colombiani interi, superiori a 8000, senza separatori (45000). Un prezzo di vendita scontato deve essere inferiore al prezzo. Per modificare solo il prezzo, invia la giacenza attuale con IsUpdatedStock 0. Una variazione di prezzo superiore al 30% restituisce il codice PEX e deve essere inviata di nuovo con l'approvazione del prezzo: l'AI ti chiede conferma prima di farlo. Per smettere di vendere un prodotto, imposta la sua giacenza a 0: l'API non prevede l'eliminazione.

Ordini e pagamenti: exito_marketplace_get_orders elenca gli ordini di exito.com, carulla.com e degli altri siti di Éxito, con stato, totali, commissione e tipo di consegna. exito_marketplace_get_bills elenca gli estratti dei pagamenti. Gli elenchi si paginano con paginationToken.

Disattivati all'installazione: exito_marketplace_set_order_tracking (segna come spediti i prodotti di un ordine, con corriere e numero di tracking) e exito_marketplace_upload_order_invoice (allega la fattura a un ordine). Attivali nella pagina del connettore quando vuoi che l'AI gestisca gli ordini; l'AI ti chiede di confermare ogni chiamata. La creazione di prodotti e l'impostazione di prezzi e giacenze sono attivate (exito_marketplace_create_products, exito_marketplace_load_products_and_offers, exito_marketplace_upsert_offers, exito_marketplace_update_offer_price_stock).

Leggi ogni risposta: le scritture in batch rispondono con HTTP 200 e un messaggio per ogni EAN rifiutato, quindi un 200 non significa che ogni prodotto o offerta sia stato accettato. Richieste e risposte sono in spagnolo.

Non coperto: etichette di spedizione, moderazione e notifiche delle offerte di Éxito, e tutto ciò che l'app web Seller Center fa e che l'API non offre.

Errori comuni: se non viene emesso nessun token, controlla nome utente, password e chiave API rispetto alle istruzioni di Éxito, e verifica che EXITO_LOGIN_URL sia l'indirizzo del token indicato in quel documento. 401 significa che il token è stato rifiutato. 403 di solito significa che la chiave API manca o è errata, oppure che l'API non è abilitata per il tuo utente: chiedi a Éxito quali API copre il tuo accesso.

Passo 2 — Installa l'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

Passo 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP, apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostri YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.

  1. In Claude, apri Plugins (in alcuni piani ancora Customize) → Connectors.
  2. Clicca su + Add, poi su Add custom connector.
  3. Inserisci un nome, ad es. Grupo Éxito Marketplace, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca su Continue, mantieni le impostazioni rilevate e clicca di nuovo su Continue.
  4. Scegli Sign in now, clicca su Add e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool qui sotto compaiono nella tua chat: inizia a scrivere i prompt.

Tool disponibili

ToolCosa fa
exito_marketplace_get_productsElenca i prodotti del venditore nel marketplace di Éxito con nome, EAN, VTEX PLU, immagine, date di creazione e aggiornamento, prezzo, prezzo di vendita, giacenza…
exito_marketplace_get_products_waitingProdotti in attesa di approvazione da parte del team dei contenuti di Éxito (moderazione), con EAN, nome, immagine, data di elaborazione e riferimento padre
exito_marketplace_get_products_rejectedProdotti che il team dei contenuti di Éxito ha rifiutato e che devono essere corretti, con EAN, nome, immagine, Reason e Comment del rifiuto
exito_marketplace_get_products_pending_seller_approvalProdotti che richiedono una tua decisione perché differiscono dallo stesso prodotto già presente nel marketplace: ogni riga ha oldProduct e…
exito_marketplace_get_bulk_upload_statusStato dell'ultimo lotto di creazione prodotti (exito_marketplace_create_products). data.status: 4 in avvio, 1 in elaborazione, 2 completato…
exito_marketplace_list_categoriesTutte le categorie del marketplace di Éxito con Id, IdParent, Name e ProductType (Technology o Clothing)
exito_marketplace_get_categoryUna categoria per id: Id, IdParent, Name e ProductType
exito_marketplace_get_category_featuresGruppi di specifiche di una categoria: per ogni specifica il suo specName, label, se è obbligatoria e i valori consentiti (values[].label; an…
exito_marketplace_get_ordersOrdini ricevuti tramite i siti di Éxito (exito.com, carulla.com e altri) con numero d'ordine, canale, date, stato, totali, commissione…
exito_marketplace_get_billsEstratti dei pagamenti (fatturazione) del venditore: numero di fatturazione, numero d'ordine, ordine di pagamento, concetto, data di pagamento, commissione, totale, IVA e…
exito_marketplace_create_productsCrea prodotti (o modifica quelli esistenti: invia di nuovo lo stesso EAN; ModifyImage "1" sostituisce le immagini) con titolo, descrizione HTML…
exito_marketplace_load_products_and_offersInvia prodotti insieme alle loro offerte in un'unica richiesta: ogni elemento ha un Product (i campi di exito_marketplace_create_products) e un…
exito_marketplace_upsert_offersCrea o aggiorna offerte (prezzo, prezzo di vendita, giacenza, spedizione e tempi di consegna promessi) per gli EAN già approvati da Éxito, in tutti i siti di Éxito…
exito_marketplace_update_offer_price_stockModifica il prezzo e/o la giacenza di una singola offerta esistente (un EAN). Éxito richiede EAN, Stock e Price a ogni aggiornamento: per modificare solo il prezzo…
exito_marketplace_set_order_trackingSegna come spediti i prodotti di un ordine con il corriere e il numero di tracking (ordini con consegna standard)
exito_marketplace_upload_order_invoiceAllega la fattura di un ordine come PDF o ZIP in base64

Prompt di esempio

  • "Quali dei miei prodotti ha rifiutato Éxito, e perché?"
  • "Mostrami gli ordini a me assegnati questa settimana che devono ancora essere spediti."
  • "Qual è il prezzo e la giacenza dell'EAN 7701234567890 su exito.com?"
  • "Imposta la giacenza dell'EAN 7701234567890 a 25 unità e mantieni il prezzo."
  • "Somma la commissione nei miei estratti dei pagamenti di ottobre."

FAQ

Funziona con Claude Code oltre che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

Questa guida ti è stata utile?

Collega Grupo Éxito Marketplace a Claude in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Grupo Éxito Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare Éxito a ChatGPT via MCP: offerte e stock

Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.

Connettori

Collegare Éxito a Microsoft Copilot via MCP

Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.

Connettori

Collegare Éxito a Cursor via MCP: caricamento catalogo

Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.

Connettori

Collegare Éxito a Gemini CLI via MCP: ordini

Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.

Connettori

Collegare Éxito a Meta Muse via MCP: ordini del negozio

Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.

Connettori

Éxito MCP Server: prodotti, offerte e ordini

Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.