Guida al connettore9 minuti di lettura34 tool MCP7 lingue

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.

HCA cura del team HelpCodeAggiornato 9 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. Chiave app e token app.

Configurazione guidata

Collega VTEX a Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega VTEX 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 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 + Cursor

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.

Requisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nel negozio dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:

VTEX_ACCOUNT_NAME, VTEX_ENVIRONMENT, VTEX_APP_KEY, VTEX_APP_TOKEN

Passo 1 — Ottieni le credenziali

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 utilizza i ruoli predefiniti OMS - Accesso completo, Accesso completo alla logistica, Catalogo, Prezzi e un ruolo di Master Data, o un ruolo personalizzato con le risorse di cui hai bisogno. Una chiave di sola lettura funziona per gli strumenti di lettura.
  3. Copia la Chiave app in VTEX_APP_KEY e il Token app in VTEX_APP_TOKEN (il token viene mostrato solo una volta).
  4. Inserisci il nome 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.

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.

Passo 2 — Installa l'adattatore

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 mostra YOUR_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" }
    }
  }
}
  1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
  2. Salva il file e riavvia Cursor.
  3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
  4. Inizia a chattare: l'agente ora può usare i tool di VTEX.

Strumenti disponibili

StrumentoCosa fa
vtex_list_ordersElenca gli ordini degli ultimi due anni, i più recenti per primi per impostazione predefinita: 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 inviati da VTEX e dal negozio 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), 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 prodotto 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 nel 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 dei prezzi dell'account (ad esempio 1 per la politica commerciale principale, o nomi come gold)
vtex_update_priceCrea o aggiorna il prezzo base di uno SKU: fornisci solo base_price (markup e costo 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 dati 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 prompt

  • "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?"

FAQ

Da dove provengono la chiave app e il token? Nell'Amministrazione VTEX sotto Impostazioni account, Account, Sicurezza, Chiavi API: genera una chiave, assegna ruoli come OMS, Logistica, Catalogo e Prezzi, e copia la chiave app e il token app (mostrati una volta).

Cosa copre? Ordini (OMS) con gestione, interazioni e tracciamento, catalogo prodotti e SKU, ricerca nel negozio, prezzi e tabelle dei prezzi, inventario per magazzino, dock e politiche di spedizione, e profili clienti in Master Data.

Quali strumenti sono installati spenti? vtex_cancel_order, vtex_invoice_order e vtex_update_invoice_tracking, perché annullano o fatturano ordini per il cliente. Attivali nella pagina del connettore solo se l'AI deve usarli.

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

Questa guida ti è stata utile?

Collega VTEX a Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega VTEX con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. 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 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.

Connettori

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.