Guía de conector8 minutos de lectura34 herramientas MCP7 idiomas

Servidor VTEX MCP: pedidos, catálogo e inventario

Plataforma de comercio VTEX: pedidos (OMS) con manejo y seguimiento, productos y SKUs de catálogo, búsqueda en la tienda, precios, inventario por almacén, muelles y políticas de envío, y perfiles de clientes en Master Data. Clave de aplicación y token de aplicación.

HCPor el equipo de HelpCodeActualizado 8 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

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.

herramientas

34

Región

INTL

Categoría

E-commerce

Autenticación

API Key

Env vars requeridas

VTEX_ACCOUNT_NAMEVTEX_ENVIRONMENTVTEX_APP_KEYVTEX_APP_TOKEN
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

Resumen

Plataforma de comercio VTEX: pedidos (OMS) con manejo y seguimiento, productos y SKUs de catálogo, búsqueda en la tienda, precios, inventario por almacén, muelles y políticas de envío, y perfiles de clientes en Master Data. Clave de aplicación y token de aplicación.

Configuración guiada

Conecta VTEX a Claude, ChatGPT o Copilot en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta VTEX con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Prueba a pedir

Prompts de ejemplo para VTEX

Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.

VTEX · live vía MCP
Compartir
Opus 4.7

Claude es IA y puede equivocarse. Verifica siempre las respuestas.

💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → VTEX, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

VTEX

Plataforma de comercio VTEX: pedidos (OMS) con manejo y seguimiento, productos y SKUs de catálogo, búsqueda en la tienda, precios, inventario por almacén, muelles y políticas de envío, y perfiles de clientes en Master Data. Clave de aplicación y token de aplicación.

Configuración

Configurar toma aproximadamente 5 minutos.

  1. En el Administrador de VTEX abre Configuración de cuenta, Cuenta, Seguridad, Claves API (administradores antiguos: Configuración de cuenta, Gestión de cuentas, Claves de aplicación) y haz clic en Generar clave. Dale un nombre.
  2. Asigna roles a la clave en Roles (Licencia Manager): para lectura y escritura usa los roles predefinidos OMS - Acceso completo, Acceso completo a logística, Catálogo, Precios y un rol de Master Data, o un rol personalizado con los recursos que necesites. Una clave de solo lectura funciona para las herramientas de lectura.
  3. Copia la Clave de aplicación en VTEX_APP_KEY y el Token de aplicación en VTEX_APP_TOKEN (el token se muestra solo una vez).
  4. Ingresa el nombre de cuenta (la primera parte de https://<account>.myvtex.com) en VTEX_ACCOUNT_NAME y mantén el entorno vtexcommercestable.

El conector envía la clave y el token en los encabezados X-VTEX-API-AppKey y X-VTEX-API-AppToken en cada llamada.

Por dónde empezar: vtex_list_orders (filtra con f_status, por ejemplo ready-for-handling), luego vtex_get_order para artículos, dirección y pago. Para un producto comienza en vtex_search_products o vtex_get_sku_by_ref_id, luego vtex_get_sku, vtex_get_price y vtex_get_sku_inventory.

Pedidos: vtex_list_orders (sin artículos en la lista; como máximo 30 páginas de hasta 100, solo los últimos dos años), vtex_get_order, vtex_get_order_group, vtex_get_order_conversation, vtex_get_payment_transaction. Mueve un pedido pagado con vtex_start_handling_order, registra una nota con vtex_add_order_interaction y envía eventos de entrega con vtex_update_tracking_status. Tres herramientas están instaladas apagadas: vtex_cancel_order (no se puede deshacer, reembolsa un pedido pagado), vtex_invoice_order (la facturación hace que VTEX capture el pago y congele el pedido) y vtex_update_invoice_tracking (cambia una factura). Los valores monetarios en los pedidos son enteros en centavos (totalValue 12990 es 129.90).

Catálogo: 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 (búsqueda en la tienda con precio en vivo y cantidad disponible), vtex_get_category_tree, vtex_list_brands. Los ids de productos y SKUs son números; RefId es el código propio del comerciante.

Precios: vtex_get_price, vtex_get_computed_price, vtex_list_price_tables, vtex_update_price. Los valores de precios son decimales (49.9), a diferencia de los valores de pedidos.

Inventario y logística: vtex_get_sku_inventory, vtex_update_sku_inventory (establece el total en un almacén), vtex_list_warehouses, vtex_list_docks, vtex_list_shipping_policies.

Clientes (Master Data v1): vtex_search_customers, vtex_get_customer, vtex_update_customer, y vtex_search_documents para cualquier entidad (AD contiene direcciones, vinculadas por userId al id de CL). Las búsquedas devuelven como máximo 100 filas por llamada, elegidas con range_start y range_end; pide solo los campos que necesites, porque una clave sin derechos en un campo recibe 403 cuando se usa _all.

Límites y trampas: VTEX permite alrededor de 6,000 lecturas de pedidos por minuto por cuenta y responde 429 cuando una API está sobrecargada. Las fechas en los filtros son UTC. Un 403 significa que el rol de la clave carece del recurso que la llamada necesita; un 404 en un pedido de más de dos años es esperado.

Requisitos previos: VTEX_ACCOUNT_NAME, VTEX_ENVIRONMENT, VTEX_APP_KEY, VTEX_APP_TOKEN

Instalar el conector 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

Abre http://localhost:3000/connectors/store, elige VTEX y pega las variables de entorno listadas en Requisitos previos.

Herramientas disponibles

HerramientaQué hace
vtex_list_ordersLista los pedidos de los últimos dos años, los más nuevos primero por defecto: orderId, creationDate, clientName, totalValue en centavos, estado y…
vtex_get_orderLee un pedido: estado, valor y totales en centavos, artículos (SKU id, refId, nombre, cantidad, precio, precio de venta), clientProfileData…
vtex_get_order_groupLee todos los pedidos de un checkout (un grupo de pedidos se divide en un pedido por vendedor): los mismos campos que vtex_get_order para cada pedido
vtex_start_handling_orderMueve un pedido de listo para manejar a en manejo, lo que le indica a VTEX que el vendedor ha comenzado a prepararlo. VTEX responde 204 sin cuerpo…
vtex_add_order_interactionEscribe una línea en el registro de interacción del pedido (mostrado en el historial del pedido en el administrador), por ejemplo, una nota del almacén. No cambia…
vtex_get_order_conversationLee la conversación por correo electrónico de un pedido: mensajes que VTEX y la tienda enviaron al cliente (asunto, de, para, fecha, cuerpo)
vtex_get_payment_transactionLee la transacción de pago de un pedido: id de transacción, estado, pagos con método, valor en centavos, cuotas y el historial de eventos.…
vtex_update_tracking_statusEnvía eventos de seguimiento a una factura que ya tiene un número de seguimiento (isDelivered, deliveredDate y la lista de eventos con ciudad, estado…
vtex_cancel_orderCancela un pedido que aún no ha sido facturado, con un motivo. No se puede deshacer; los pedidos pagados son reembolsados por VTEX. Instalado apagado
vtex_invoice_orderEnvía la factura de un pedido (tipo Salida para una venta), lo que lo mueve a facturado y hace que VTEX liquide (capture) el pago. invoiceValue…
vtex_update_invoice_trackingAgrega un número de seguimiento, enlace de seguimiento, transportista y fecha de despacho a una factura existente de un pedido. Cambia la factura; instalado apagado…
vtex_list_product_and_sku_idsLista los ids de productos con sus ids de SKU, opcionalmente en una categoría: los datos mapean cada productId a sus ids de SKU, range.total da el total. Página…
vtex_get_productLee un producto: Id, Nombre, DepartmentId, CategoryId, BrandId, LinkId (URL slug), RefId, IsVisible, IsActive, Descripción, Título…
vtex_get_product_by_ref_idEncuentra un producto por su código de referencia (RefId) y lee los mismos campos que vtex_get_product
vtex_list_product_skusLista los SKUs de un producto: Id, ProductId, IsActive, Nombre, RefId, campos relacionados con EAN, dimensiones, peso y unidad de medida
vtex_get_skuLee un SKU con su contexto: Id, ProductId, NameComplete, ProductName, SkuName, AlternateIds (EAN, RefId), imágenes, dimensiones, vendedores…
vtex_get_sku_by_ref_idEncuentra un SKU por su código de referencia (RefId): Id, ProductId, IsActive, Nombre, RefId, dimensiones y peso
vtex_get_sku_by_eanEncuentra un SKU por su código de barras EAN y lee los mismos campos que vtex_get_sku
vtex_search_productsBusca en el catálogo publicado como lo hace la tienda: productId, productName, marca, enlace, categorías y artículos (SKUs) con vendedores y…
vtex_get_category_treeLee el árbol de categorías hasta la profundidad dada: id, nombre, hasChildren, url y hijos para cada categoría
vtex_list_brandsLista todas las marcas: id, nombre, isActive, título, metaTagDescription y imageUrl
vtex_get_priceLee los precios de un SKU desde la API de Precios: itemId, listPrice, costPrice, markup, basePrice y fixedPrices por política comercial…
vtex_get_computed_priceLee el precio que una tabla de precios (política comercial) realmente cobra por un SKU después de las reglas de precios: tradePolicyId, listPrice, costPrice…
vtex_list_price_tablesLista los ids de las tablas de precios de la cuenta (por ejemplo 1 para la política comercial principal, o nombres como oro)
vtex_update_priceCrea o actualiza el precio base de un SKU: da base_price solo (markup y cost se derivan entonces), o cost_price con markup en porcentaje…
vtex_get_sku_inventoryLee el stock de un SKU en cada almacén: warehouseId, warehouseName, totalQuantity, reservedQuantity, hasUnlimitedQuantity, timeToRefill…
vtex_update_sku_inventoryEstablece el stock de un SKU en un almacén: quantity reemplaza la cantidad total (las reservas se mantienen por separado); unlimited_quantity verdadero mantiene…
vtex_list_warehousesLista almacenes: id, nombre, warehouseDocks (ids de muelle con tiempo y costo) y isActive
vtex_list_docksLista muelles de carga: id, nombre, prioridad, dockTimeFake, salesChannels, freightTableIds y la información de la tienda de recogida
vtex_list_shipping_policiesLista políticas de envío (transportistas y tablas de flete): id, nombre, shippingMethod, isActive, deliveryOnWeekends, maxDimension y negocio…
vtex_search_customersBusca perfiles de clientes (entidad Master Data CL): email, firstName, lastName, documento, teléfono, isCorporate, corporateName, createdIn y…
vtex_get_customerLee un perfil de cliente (entidad CL) por id de documento: los campos nombrados en fields
vtex_update_customerCambia campos de un perfil de cliente (entidad CL); solo se cambian los campos dados, por ejemplo, teléfono o isNewsletterOptIn
vtex_search_documentsBusca cualquier entidad Master Data v1 por su acrónimo de dos letras, por ejemplo, AD para direcciones de clientes (filtra por userId), o una entidad personalizada: el…

Ejemplos de prompts

  • "¿Qué pedidos de VTEX están listos para manejar ahora mismo?"
  • "Muestra el pedido 1478920512345-01 con sus artículos, dirección y pago."
  • "¿Cuál es el precio y stock por almacén del SKU ref TSHIRT-BLK-M?"
  • "Establece el stock del SKU 2001 en el almacén 1_1 a 80."
  • "¿Qué políticas de envío y muelles están activos?"

Próximos pasos

¿Te ha sido útil esta guía?

Conecta VTEX a Claude, ChatGPT o Copilot en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta VTEX con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conectar VTEX MCP con ChatGPT: pedidos y precios

Plataforma de comercio VTEX: pedidos (OMS) con manejo y seguimiento, productos y SKUs de catálogo, búsqueda en la tienda, precios, inventario por almacén, muelles y políticas de envío, y perfiles de clientes en Master Data. Clave de aplicación y token de aplicación.

Conectores

Conectar VTEX MCP con Claude: pedidos y stock

Plataforma de comercio VTEX: pedidos (OMS) con manejo y seguimiento, productos y SKUs de catálogo, búsqueda en la tienda, precios, inventario por almacén, muelles y políticas de envío, y perfiles de clientes en Master Data. Clave de aplicación y token de aplicación.

Conectores

Conectar VTEX MCP con Microsoft Copilot

Plataforma de comercio VTEX: pedidos (OMS) con manejo y seguimiento, productos y SKUs de catálogo, búsqueda en la tienda, precios, inventario por almacén, muelles y políticas de envío, y perfiles de clientes en Master Data. Clave de aplicación y token de aplicación.

Conectores

Conectar VTEX MCP con Cursor: productos y stock

Plataforma de comercio VTEX: pedidos (OMS) con manejo y seguimiento, productos y SKUs de catálogo, búsqueda en la tienda, precios, inventario por almacén, muelles y políticas de envío, y perfiles de clientes en Master Data. Clave de aplicación y token de aplicación.

Conectores

Conectar VTEX MCP con Gemini CLI: pedidos y stock

Plataforma de comercio VTEX: pedidos (OMS) con manejo y seguimiento, productos y SKUs de catálogo, búsqueda en la tienda, precios, inventario por almacén, muelles y políticas de envío, y perfiles de clientes en Master Data. Clave de aplicación y token de aplicación.

Conectores

Conectar VTEX MCP con Meta Muse: pedidos y stock

Plataforma de comercio VTEX: pedidos (OMS) con manejo y seguimiento, productos y SKUs de catálogo, búsqueda en la tienda, precios, inventario por almacén, muelles y políticas de envío, y perfiles de clientes en Master Data. Clave de aplicación y token de aplicación.