Guida al connettore8 minuti di lettura34 tool MCP7 lingue

VTEX MCP Server: ordini, prodotti e inventario

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.

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

VTEX

VTEX

VTEX commerce platform: orders (OMS) with handling and tracking, catalog products and SKUs, storefront search, prices, inventory per warehouse, docks and shipping policies, and customer profiles in Master Data. App key and app token.

tool

34

Regione

INTL

Categoria

E-commerce

Autenticazione

API Key

Env vars richieste

VTEX_ACCOUNT_NAMEVTEX_ENVIRONMENTVTEX_APP_KEYVTEX_APP_TOKEN
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

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.

VTEX · 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 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.

  1. 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.
  2. 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.
  3. Copia la App key in VTEX_APP_KEY e il App token in VTEX_APP_TOKEN (il token viene mostrato solo una volta).
  4. Inserisci il nome dell'account (la prima parte di https://<account>.myvtex.com) in VTEX_ACCOUNT_NAME e mantieni l'ambiente vtexcommercestable.

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

StrumentoCosa fa
vtex_list_ordersElenca gli ordini degli ultimi due anni, i più recenti per default: orderId, creationDate, clientName, totalValue in centesimi, stato e…
vtex_get_orderLeggi un ordine: stato, valore e totali in centesimi, articoli (SKU id, refId, nome, quantità, prezzo, prezzo di vendita), clientProfileData…
vtex_get_order_groupLeggi 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_orderSposta 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_interactionScrivi 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_conversationLeggi la conversazione email di un ordine: messaggi che VTEX e il negozio hanno inviato al cliente (oggetto, da, a, data, corpo)
vtex_get_payment_transactionLeggi 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_statusInvia 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_orderAnnulla un ordine che non è ancora fatturato, con un motivo. Non può essere annullato; gli ordini pagati vengono rimborsati da VTEX. Installato spento
vtex_invoice_orderInvia 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_trackingAggiungi 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_idsElenca 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_productLeggi un prodotto: Id, Nome, DepartmentId, CategoryId, BrandId, LinkId (URL slug), RefId, IsVisible, IsActive, Descrizione, Titolo…
vtex_get_product_by_ref_idTrova un prodotto tramite il suo codice di riferimento (RefId) e leggi gli stessi campi di vtex_get_product
vtex_list_product_skusElenca gli SKU di un prodotto: Id, ProductId, IsActive, Nome, RefId, campi relativi all'EAN, dimensioni, peso e unità di misura
vtex_get_skuLeggi uno SKU con il suo contesto: Id, ProductId, NomeCompleto, NomeProdotto, NomeSku, AlternateIds (EAN, RefId), immagini, dimensioni, venditori…
vtex_get_sku_by_ref_idTrova uno SKU tramite il suo codice di riferimento (RefId): Id, ProductId, IsActive, Nome, RefId, dimensioni e peso
vtex_get_sku_by_eanTrova uno SKU tramite il suo codice a barre EAN e leggi gli stessi campi di vtex_get_sku
vtex_search_productsCerca il catalogo pubblicato come fa il negozio: productId, productName, brand, link, categorie e articoli (SKU) con venditori e…
vtex_get_category_treeLeggi l'albero delle categorie fino alla profondità data: id, nome, hasChildren, url e figli per ogni categoria
vtex_list_brandsElenca tutti i marchi: id, nome, isActive, titolo, metaTagDescription e imageUrl
vtex_get_priceLeggi i prezzi di uno SKU dall'API Prezzi: itemId, listPrice, costPrice, markup, basePrice e fixedPrices per politica commerciale…
vtex_get_computed_priceLeggi il prezzo che una tabella prezzi (politica commerciale) addebita effettivamente per uno SKU dopo le regole di prezzo: tradePolicyId, listPrice, costPrice…
vtex_list_price_tablesElenca gli id delle tabelle prezzi dell'account (ad esempio 1 per la principale politica commerciale, o nomi come gold)
vtex_update_priceCrea 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_inventoryLeggi lo stock di uno SKU in ogni magazzino: warehouseId, warehouseName, totalQuantity, reservedQuantity, hasUnlimitedQuantity, timeToRefill…
vtex_update_sku_inventoryImposta 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_warehousesElenca i magazzini: id, nome, warehouseDocks (id dock con tempo e costo) e isActive
vtex_list_docksElenca i dock di carico: id, nome, priorità, dockTimeFake, salesChannels, freightTableIds e le informazioni sul negozio di ritiro
vtex_list_shipping_policiesElenca le politiche di spedizione (corrieri e tabelle di trasporto): id, nome, shippingMethod, isActive, deliveryOnWeekends, maxDimension e business…
vtex_search_customersCerca profili clienti (entità Master Data CL): email, firstName, lastName, document, phone, isCorporate, corporateName, createdIn e…
vtex_get_customerLeggi un profilo cliente (entità CL) tramite id documento: i campi nominati in fields
vtex_update_customerCambia i campi di un profilo cliente (entità CL); solo i campi forniti vengono cambiati, ad esempio telefono o isNewsletterOptIn
vtex_search_documentsCerca 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?

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.

Guide correlate

Connettori

Collegare VTEX MCP a ChatGPT: ordini e prezzi

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. Chiave app e token app.

Connettori

Collegare VTEX MCP a Claude: ordini e scorte

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. Chiave app e token app.

Connettori

Collegare VTEX MCP a Microsoft Copilot

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. Chiave app e token app.

Connettori

Collegare VTEX MCP a Cursor: prodotti e scorte

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. Chiave app e token app.

Connettori

Collegare VTEX MCP a Gemini CLI: ordini e scorte

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. Chiave app e token app.

Connettori

Collegare VTEX MCP a Meta Muse: ordini e scorte

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. Chiave app e token app.