In breve
Piattaforma di commercio VTEX: ordini (OMS) con gestione e tracciamento, catalogo prodotti e SKU, ricerca nel negozio, prezzi, inventario per magazzino, dock e politiche di spedizione, e profili clienti in Master Data. App key e app token.
Configurazione guidata
Collega VTEX a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega VTEX con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. 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 VTEX
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 Connettori → VTEX, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
VTEX
Piattaforma di commercio VTEX: ordini (OMS) con gestione e tracciamento, catalogo prodotti e SKU, ricerca nel negozio, prezzi, inventario per magazzino, dock e politiche di spedizione, e profili clienti in Master Data. App key e app token.
Configurazione
La configurazione richiede circa 5 minuti.
- Nell'Amministrazione VTEX apri Impostazioni account, Account, Sicurezza, Chiavi API (amministratori più vecchi: Impostazioni account, Gestione account, Chiavi applicazione) e clicca su Genera chiave. Dagli un nome.
- Assegna ruoli alla chiave in Ruoli (License Manager): per lettura e scrittura usa i ruoli predefiniti OMS - Accesso completo, Accesso completo logistica, Catalogo, Prezzi e un ruolo Master Data, o un ruolo personalizzato con le risorse di cui hai bisogno. Una chiave in sola lettura funziona per gli strumenti di lettura.
- Copia la App key in
VTEX_APP_KEYe il App token inVTEX_APP_TOKEN(il token viene mostrato solo una volta). - Inserisci il nome dell'account (la prima parte di
https://<account>.myvtex.com) inVTEX_ACCOUNT_NAMEe mantieni l'ambientevtexcommercestable.
Il connettore invia la chiave e il token negli header X-VTEX-API-AppKey e X-VTEX-API-AppToken ad ogni chiamata.
Da dove iniziare: vtex_list_orders (filtra con f_status, ad esempio ready-for-handling), poi vtex_get_order per articoli, indirizzo e pagamento. Per un prodotto inizia con vtex_search_products o vtex_get_sku_by_ref_id, poi vtex_get_sku, vtex_get_price e vtex_get_sku_inventory.
Ordini: vtex_list_orders (nessun articolo nella lista; al massimo 30 pagine di fino a 100, solo gli ultimi due anni), vtex_get_order, vtex_get_order_group, vtex_get_order_conversation, vtex_get_payment_transaction. Sposta un ordine pagato con vtex_start_handling_order, registra una nota con vtex_add_order_interaction e invia eventi di consegna con vtex_update_tracking_status. Tre strumenti sono installati spenti: vtex_cancel_order (non può essere annullato, rimborsa un ordine pagato), vtex_invoice_order (la fatturazione fa sì che VTEX catturi il pagamento e congeli l'ordine) e vtex_update_invoice_tracking (cambia una fattura). I valori monetari negli ordini sono interi in centesimi (totalValue 12990 è 129.90).
Catalogo: vtex_list_product_and_sku_ids, vtex_get_product, vtex_get_product_by_ref_id, vtex_list_product_skus, vtex_get_sku, vtex_get_sku_by_ref_id, vtex_get_sku_by_ean, vtex_search_products (ricerca nel negozio con prezzo live e quantità disponibile), vtex_get_category_tree, vtex_list_brands. Gli id di prodotto e SKU sono numeri; RefId è il codice del commerciante.
Prezzi: vtex_get_price, vtex_get_computed_price, vtex_list_price_tables, vtex_update_price. I valori di prezzo sono decimali (49.9), a differenza dei valori degli ordini.
Stock e logistica: vtex_get_sku_inventory, vtex_update_sku_inventory (imposta il totale in un magazzino), vtex_list_warehouses, vtex_list_docks, vtex_list_shipping_policies.
Clienti (Master Data v1): vtex_search_customers, vtex_get_customer, vtex_update_customer, e vtex_search_documents per qualsiasi entità (AD contiene indirizzi, collegati da userId all'id CL). Le ricerche restituiscono al massimo 100 righe per chiamata, scelte con range_start e range_end; chiedi solo i campi di cui hai bisogno, perché una chiave senza diritti su un campo riceve 403 quando viene usato _all.
Limiti e insidie: VTEX consente circa 6.000 letture di ordini al minuto per account e risponde 429 quando un'API è sovraccarica. Le date nei filtri sono UTC. Un 403 significa che il ruolo della chiave manca della risorsa di cui ha bisogno la chiamata; un 404 su un ordine più vecchio di due anni è previsto.
Prerequisiti: VTEX_ACCOUNT_NAME, VTEX_ENVIRONMENT, VTEX_APP_KEY, VTEX_APP_TOKEN
Installa il connettore localmente
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
Apri http://localhost:3000/connectors/store, scegli VTEX e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
vtex_list_orders | Elenca gli ordini degli ultimi due anni, i più recenti per default: orderId, creationDate, clientName, totalValue in centesimi, stato e… |
vtex_get_order | Leggi un ordine: stato, valore e totali in centesimi, articoli (SKU id, refId, nome, quantità, prezzo, prezzo di vendita), clientProfileData… |
vtex_get_order_group | Leggi tutti gli ordini di un checkout (un gruppo di ordini si divide in un ordine per venditore): gli stessi campi di vtex_get_order per ogni ordine |
vtex_start_handling_order | Sposta un ordine da pronto per la gestione a in gestione, il che informa VTEX che il venditore ha iniziato a prepararlo. VTEX risponde 204 senza corpo… |
vtex_add_order_interaction | Scrivi una riga nel registro delle interazioni dell'ordine (mostrato nella cronologia dell'ordine nell'amministrazione), ad esempio una nota dal magazzino. Non cambia… |
vtex_get_order_conversation | Leggi la conversazione email di un ordine: messaggi che VTEX e il negozio hanno inviato al cliente (oggetto, da, a, data, corpo) |
vtex_get_payment_transaction | Leggi la transazione di pagamento di un ordine: id transazione, stato, pagamenti con metodo, valore in centesimi, rate e la cronologia degli eventi.… |
vtex_update_tracking_status | Invia eventi di tracciamento a una fattura che ha già un numero di tracciamento (isDelivered, deliveredDate e l'elenco degli eventi con città, stato… |
vtex_cancel_order | Annulla un ordine che non è ancora fatturato, con un motivo. Non può essere annullato; gli ordini pagati vengono rimborsati da VTEX. Installato spento |
vtex_invoice_order | Invia la fattura di un ordine (tipo Output per una vendita), il che lo sposta a fatturato e fa sì che VTEX regoli (catturi) il pagamento. invoiceValue… |
vtex_update_invoice_tracking | Aggiungi un numero di tracciamento, un link di tracciamento, un corriere e una data di spedizione a una fattura esistente di un ordine. Cambia la fattura; installato spento… |
vtex_list_product_and_sku_ids | Elenca gli id dei prodotti con i loro id SKU, eventualmente in una categoria: i dati mappano ogni productId ai suoi id SKU, range.total fornisce il totale. Pagina… |
vtex_get_product | Leggi un prodotto: Id, Nome, DepartmentId, CategoryId, BrandId, LinkId (URL slug), RefId, IsVisible, IsActive, Descrizione, Titolo… |
vtex_get_product_by_ref_id | Trova un prodotto tramite il suo codice di riferimento (RefId) e leggi gli stessi campi di vtex_get_product |
vtex_list_product_skus | Elenca gli SKU di un prodotto: Id, ProductId, IsActive, Nome, RefId, campi relativi all'EAN, dimensioni, peso e unità di misura |
vtex_get_sku | Leggi uno SKU con il suo contesto: Id, ProductId, NomeCompleto, NomeProdotto, NomeSku, AlternateIds (EAN, RefId), immagini, dimensioni, venditori… |
vtex_get_sku_by_ref_id | Trova uno SKU tramite il suo codice di riferimento (RefId): Id, ProductId, IsActive, Nome, RefId, dimensioni e peso |
vtex_get_sku_by_ean | Trova uno SKU tramite il suo codice a barre EAN e leggi gli stessi campi di vtex_get_sku |
vtex_search_products | Cerca il catalogo pubblicato come fa il negozio: productId, productName, brand, link, categorie e articoli (SKU) con venditori e… |
vtex_get_category_tree | Leggi l'albero delle categorie fino alla profondità data: id, nome, hasChildren, url e figli per ogni categoria |
vtex_list_brands | Elenca tutti i marchi: id, nome, isActive, titolo, metaTagDescription e imageUrl |
vtex_get_price | Leggi i prezzi di uno SKU dall'API Prezzi: itemId, listPrice, costPrice, markup, basePrice e fixedPrices per politica commerciale… |
vtex_get_computed_price | Leggi il prezzo che una tabella prezzi (politica commerciale) addebita effettivamente per uno SKU dopo le regole di prezzo: tradePolicyId, listPrice, costPrice… |
vtex_list_price_tables | Elenca gli id delle tabelle prezzi dell'account (ad esempio 1 per la principale politica commerciale, o nomi come gold) |
vtex_update_price | Crea o aggiorna il prezzo base di uno SKU: fornisci base_price da solo (markup e cost sono poi derivati), o cost_price con markup in percentuale… |
vtex_get_sku_inventory | Leggi lo stock di uno SKU in ogni magazzino: warehouseId, warehouseName, totalQuantity, reservedQuantity, hasUnlimitedQuantity, timeToRefill… |
vtex_update_sku_inventory | Imposta lo stock di uno SKU in un magazzino: la quantità sostituisce la quantità totale (le prenotazioni sono mantenute separate); unlimited_quantity true mantiene… |
vtex_list_warehouses | Elenca i magazzini: id, nome, warehouseDocks (id dock con tempo e costo) e isActive |
vtex_list_docks | Elenca i dock di carico: id, nome, priorità, dockTimeFake, salesChannels, freightTableIds e le informazioni sul negozio di ritiro |
vtex_list_shipping_policies | Elenca le politiche di spedizione (corrieri e tabelle di trasporto): id, nome, shippingMethod, isActive, deliveryOnWeekends, maxDimension e business… |
vtex_search_customers | Cerca profili clienti (entità Master Data CL): email, firstName, lastName, document, phone, isCorporate, corporateName, createdIn e… |
vtex_get_customer | Leggi un profilo cliente (entità CL) tramite id documento: i campi nominati in fields |
vtex_update_customer | Cambia i campi di un profilo cliente (entità CL); solo i campi forniti vengono cambiati, ad esempio telefono o isNewsletterOptIn |
vtex_search_documents | Cerca qualsiasi entità Master Data v1 tramite il suo acronimo di due lettere, ad esempio AD per indirizzi clienti (filtra su userId), o un'entità personalizzata: il… |
Esempi di richieste
- "Quali ordini VTEX sono pronti per la gestione in questo momento?"
- "Mostra l'ordine 1478920512345-01 con i suoi articoli, indirizzo e pagamento."
- "Qual è il prezzo e lo stock per magazzino dello SKU ref TSHIRT-BLK-M?"
- "Imposta lo stock dello SKU 2001 nel magazzino 1_1 a 80."
- "Quali politiche di spedizione e dock sono attivi?"
Prossimi passi
Questa guida ti è stata utile?