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 Microsoft Copilot 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 Microsoft Copilot. 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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Grupo Éxito Marketplace. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?