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.
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.
- 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.
- 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.
- Copia la Clave de aplicación en
VTEX_APP_KEYy el Token de aplicación enVTEX_APP_TOKEN(el token se muestra solo una vez). - Ingresa el nombre de cuenta (la primera parte de
https://<account>.myvtex.com) enVTEX_ACCOUNT_NAMEy mantén el entornovtexcommercestable.
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
| Herramienta | Qué hace |
|---|---|
vtex_list_orders | Lista 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_order | Lee un pedido: estado, valor y totales en centavos, artículos (SKU id, refId, nombre, cantidad, precio, precio de venta), clientProfileData… |
vtex_get_order_group | Lee 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_order | Mueve 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_interaction | Escribe 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_conversation | Lee 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_transaction | Lee 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_status | Enví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_order | Cancela 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_order | Enví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_tracking | Agrega 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_ids | Lista 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_product | Lee un producto: Id, Nombre, DepartmentId, CategoryId, BrandId, LinkId (URL slug), RefId, IsVisible, IsActive, Descripción, Título… |
vtex_get_product_by_ref_id | Encuentra un producto por su código de referencia (RefId) y lee los mismos campos que vtex_get_product |
vtex_list_product_skus | Lista los SKUs de un producto: Id, ProductId, IsActive, Nombre, RefId, campos relacionados con EAN, dimensiones, peso y unidad de medida |
vtex_get_sku | Lee un SKU con su contexto: Id, ProductId, NameComplete, ProductName, SkuName, AlternateIds (EAN, RefId), imágenes, dimensiones, vendedores… |
vtex_get_sku_by_ref_id | Encuentra un SKU por su código de referencia (RefId): Id, ProductId, IsActive, Nombre, RefId, dimensiones y peso |
vtex_get_sku_by_ean | Encuentra un SKU por su código de barras EAN y lee los mismos campos que vtex_get_sku |
vtex_search_products | Busca 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_tree | Lee el árbol de categorías hasta la profundidad dada: id, nombre, hasChildren, url y hijos para cada categoría |
vtex_list_brands | Lista todas las marcas: id, nombre, isActive, título, metaTagDescription y imageUrl |
vtex_get_price | Lee los precios de un SKU desde la API de Precios: itemId, listPrice, costPrice, markup, basePrice y fixedPrices por política comercial… |
vtex_get_computed_price | Lee 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_tables | Lista 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_price | Crea 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_inventory | Lee el stock de un SKU en cada almacén: warehouseId, warehouseName, totalQuantity, reservedQuantity, hasUnlimitedQuantity, timeToRefill… |
vtex_update_sku_inventory | Establece 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_warehouses | Lista almacenes: id, nombre, warehouseDocks (ids de muelle con tiempo y costo) y isActive |
vtex_list_docks | Lista muelles de carga: id, nombre, prioridad, dockTimeFake, salesChannels, freightTableIds y la información de la tienda de recogida |
vtex_list_shipping_policies | Lista políticas de envío (transportistas y tablas de flete): id, nombre, shippingMethod, isActive, deliveryOnWeekends, maxDimension y negocio… |
vtex_search_customers | Busca perfiles de clientes (entidad Master Data CL): email, firstName, lastName, documento, teléfono, isCorporate, corporateName, createdIn y… |
vtex_get_customer | Lee un perfil de cliente (entidad CL) por id de documento: los campos nombrados en fields |
vtex_update_customer | Cambia campos de un perfil de cliente (entidad CL); solo se cambian los campos dados, por ejemplo, teléfono o isNewsletterOptIn |
vtex_search_documents | Busca 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?