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 Gemini en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta VTEX con la configuración guiada y añade tu URL MCP a Gemini. 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.
💡 ¿Sin 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 + Gemini
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.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
VTEX_ACCOUNT_NAME, VTEX_ENVIRONMENT, VTEX_APP_KEY, VTEX_APP_TOKEN
Paso 1 — Obtén credenciales
La configuración tarda aproximadamente 5 minutos.
- En el Admin 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. Asigna un nombre.
- Asigna roles a la clave en Roles (Licencia Manager): para lectura y escritura utiliza 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). - Introduce 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.
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 producto y SKU 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 aproximadamente 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 necesita la llamada; un 404 en un pedido de más de dos años es esperado.
Paso 2 — Instala el adaptador
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
Paso 3 — Agrega el conector en Gemini
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia
gemini. - Ejecuta
/mcpdentro de Gemini CLI (ogemini mcp listen tu terminal):anythingmcpdebería aparecer como conectado. - Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de
VTEX.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
vtex_list_orders | Lista los pedidos de los últimos dos años, el más nuevo 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 admin), 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 producto con sus ids de SKU, opcionalmente en una categoría: los datos asignan 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, NombreCompleto, NombreProducto, NombreSku, 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 niños 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 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: la cantidad 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 indicaciones
- "¿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?"
Preguntas frecuentes
¿De dónde provienen la clave de aplicación y el token? En el Admin de VTEX bajo Configuración de cuenta, Cuenta, Seguridad, Claves API: genera una clave, asigna roles como OMS, Logística, Catálogo y Precios, y copia la clave de aplicación y el token de aplicación (mostrado una vez).
¿Qué cubre? Pedidos (OMS) con manejo, interacciones y seguimiento, productos y SKUs de catálogo, búsqueda en la tienda, precios y tablas de precios, inventario por almacén, muelles y políticas de envío, y perfiles de clientes en Master Data.
¿Qué herramientas se instalan apagadas? vtex_cancel_order, vtex_invoice_order y vtex_update_invoice_tracking, porque cancelan o facturan pedidos para el cliente. Actívalas en la página del conector solo si la IA debe usarlas.
¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.
Próximos pasos
¿Te ha sido útil esta guía?