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 Cursor 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 Cursor. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
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.
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 + Cursor
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.
- Incolla l'utente API (un indirizzo e-mail) in
EXITO_USERNAMEe la password API inEXITO_PASSWORD, entrambi tratti dalle istruzioni di Éxito. - Incolla la
x-api-keydelle stesse istruzioni inEXITO_API_KEY. - Incolla l'indirizzo
https://completo della richiesta del token inEXITO_LOGIN_URL. Non è pubblicato su developers.exito.com, quindi copialo dal documento inviato da Éxito. - Inserisci il tuo seller id numerico (idSeller, ad es.
11795) inEXITO_SELLER_ID. Lo mostra ancheexito_marketplace_get_bulk_upload_statuscomedata.idSeller. - Installa il connettore. Esegui
exito_marketplace_list_categoriesper 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:
- Scegli la categoria più specifica con
exito_marketplace_list_categoriese leggi le sue specifiche conexito_marketplace_get_category_features. Le specifiche obbligatorie devono essere inviate; una specifica con un elenco di valori accetta solo quelli. - 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. - Segui il lotto con
exito_marketplace_get_bulk_upload_status. Non viene accettato nessun nuovo lotto finché uno è in fase di avvio o elaborazione. - Il team dei contenuti di Éxito revisiona ogni prodotto.
exito_marketplace_get_products_waitingelenca quelli in revisione,exito_marketplace_get_products_rejectedquelli rifiutati con il motivo eexito_marketplace_get_products_pending_seller_approvalquelli 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. - Assegna ai prodotti approvati un prezzo e una giacenza con
exito_marketplace_upsert_offersoppure, per un singolo EAN,exito_marketplace_update_offer_price_stock.exito_marketplace_load_products_and_offersinvia 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 Cursor
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 mostraYOUR_SERVER_ID.
Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia Cursor.
- Apri Cursor → Settings → MCP e verifica che
anythingmcpsia elencato e connesso. - Inizia a chattare: l'agente ora può usare i tool di
Grupo Éxito Marketplace.
Tool disponibili
| Tool | Cosa fa |
|---|---|
exito_marketplace_get_products | Elenca 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_waiting | Prodotti 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_rejected | Prodotti 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_approval | Prodotti che richiedono una tua decisione perché differiscono dallo stesso prodotto già presente nel marketplace: ogni riga ha oldProduct e… |
exito_marketplace_get_bulk_upload_status | Stato dell'ultimo lotto di creazione prodotti (exito_marketplace_create_products). data.status: 4 in avvio, 1 in elaborazione, 2 completato… |
exito_marketplace_list_categories | Tutte le categorie del marketplace di Éxito con Id, IdParent, Name e ProductType (Technology o Clothing) |
exito_marketplace_get_category | Una categoria per id: Id, IdParent, Name e ProductType |
exito_marketplace_get_category_features | Gruppi di specifiche di una categoria: per ogni specifica il suo specName, label, se è obbligatoria e i valori consentiti (values[].label; an… |
exito_marketplace_get_orders | Ordini ricevuti tramite i siti di Éxito (exito.com, carulla.com e altri) con numero d'ordine, canale, date, stato, totali, commissione… |
exito_marketplace_get_bills | Estratti 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_products | Crea 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_offers | Invia 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_offers | Crea 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_stock | Modifica 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_tracking | Segna come spediti i prodotti di un ordine con il corriere e il numero di tracking (ordini con consegna standard) |
exito_marketplace_upload_order_invoice | Allega 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
Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.
Prossimi passi
Questa guida ti è stata utile?