Koru VTEX MCP

Conecta una tienda VTEX verificada con ChatGPT o Claude y consulta sus datos en modo de solo lectura.

Koru VTEX MCP permite consultar una tienda VTEX desde ChatGPT o Claude en modo de solo lectura. La licencia es gratuita, no requiere tarjeta y cada autorización queda limitada al sitio que elegís.

Qué instala cada parte

Koru VTEX MCP se obtiene en Koru y se agrega como servidor privado en el asistente. La conexión con VTEX la realiza la app separada Koru VTEX Connector, instalada manualmente en VTEX Admin. Esta guía enlaza el paso del Connector cuando corresponde.

Recorrido completo

Orden	Dónde	Resultado esperado
1	Koru Suite + email	Cuenta verificada y alta reanudada automáticamente
2	Koru Suite	Organización, sitio y app gratuita creados
3	VTEX Admin + Koru Suite	Connector vinculado y titularidad verificada
4	Koru Suite	Storefront autorizado; canal elegido sólo si hay más de uno
5	ChatGPT o Claude	MCP autorizado y herramientas disponibles
6	Chat	Primera auditoría útil de solo lectura

Crear la cuenta y obtener la app

Abrí Koru Suite

Entrá a korusuite.com, bajá hasta el catálogo y abrí Koru VTEX MCP. Elegí Crear cuenta gratis.

No necesitás buscar un MCP en un directorio ni publicar un plugin. Esta es una conexión personal para tu propia tienda.

Creá y verificá tu identidad

Registrate en la pantalla segura de acceso. Después abrí el email de verificación, confirmá la dirección y continuá en la pestaña que abre el enlace. Koru refresca la sesión y retoma el mismo alta sin pedirte empezar nuevamente. La pestaña original queda en un estado final que podés cerrar.

Usá siempre la misma identidad durante el alta, la vinculación VTEX y la autorización de ChatGPT o Claude.

Creá la organización y el sitio

Completá:

Nombre de la empresa;
País;
Dirección pública de tu tienda VTEX, con https:// y el dominio que ven tus clientes;
las confirmaciones legales.

Elegí Continuar. Koru crea la organización, el sitio y la licencia gratuita de Koru VTEX MCP. No ingreses la URL del Admin, una URL de workspace ni credenciales de VTEX.

Conectá VTEX

Entrá a Mis apps → Koru VTEX MCP y abrí el paso Conectá tu tienda VTEX. Instalá Koru VTEX Connector y elegí una sola vez Conectar con Koru desde VTEX Admin. Koru conserva la solicitud aunque necesites iniciar sesión o crear tu cuenta.

La evidencia firmada del Connector verifica automáticamente la titularidad cuando la cuenta y la dirección pública coinciden. Sólo si esa prueba no alcanza, Koru ofrece como recuperación un archivo HTTPS público o un registro DNS TXT.

Autorizá el storefront

Koru muestra la dirección pública elegida una sola vez. Si ese dominio tiene un único canal de venta, lo selecciona automáticamente. Si tiene varios, elegí el canal correcto y confirmá la autorización. Los datos técnicos quedan dentro del detalle desplegable.

El resultado correcto es Tu tienda ya está lista. Las etapas terminadas aparecen compactadas y Koru muestra los datos para continuar en ChatGPT o Claude. Consultá la guía detallada del Connector si necesitás instalarlo o recuperar una vinculación.

Obtener la URL privada

Cuando la tienda quede conectada, Koru muestra Usalo en ChatGPT o Claude. Copiá la URL del servidor. Tiene esta forma:

https://mcp.korusuite.com/vtex/IDENTIFICADOR_PRIVADO/mcp

La URL identifica tu conexión

No la publiques, no la compartas y no uses la URL de otra tienda. No lleva AppKey, AppToken ni ninguna credencial VTEX.

Agregarlo a ChatGPT o Claude

Activá el modo de desarrollador

En ChatGPT abrí Settings → Security and login y activá Developer mode. La disponibilidad depende de tu cuenta o de la política de tu workspace.

Creá el plugin personal

Abrí Plugins, elegí el botón + y completá:

Campo	Valor
Name	`Koru VTEX MCP`
Description	`Consulta en modo seguro datos de catálogo, precios, inventario, pedidos y logística de mi tienda VTEX conectada mediante Koru.`
Connection	Server URL
Server URL	La URL privada copiada desde Koru, incluida la terminación `/mcp`
Authentication	OAuth

Aceptá el aviso sobre servidores MCP personalizados y elegí Create. No lo agregues a un directorio público.

Autorizá la tienda

Elegí Sign in with Koru VTEX MCP, iniciá sesión en Koru y revisá la pantalla Conectá ChatGPT con Koru. Confirmá la tienda y el acceso solicitado.

Al volver a ChatGPT, revisá que aparezcan las herramientas del servidor. Después abrí un chat nuevo y seleccioná Koru VTEX MCP desde el menú de herramientas.

La ruta está alineada con la documentación oficial de OpenAI para conectar un servidor MCP.

Primera consulta útil

Pegá este prompt en un chat nuevo con Koru VTEX MCP habilitado:

Usá Koru VTEX MCP exclusivamente en modo de solo lectura.
 
1. Identificá la cuenta VTEX, workspace, canal de venta, país/locale y moneda.
2. Buscá hasta 10 productos publicados y elegí 3 SKU representativos.
3. Para cada SKU, comprobá precio, inventario y vendibilidad. Podés simular checkout
   sólo si la operación no crea ni modifica carritos, pedidos, precios o stock.
4. Entregá una tabla con: producto, SKU, precio, stock, vendible, problema detectado
   y evidencia.
5. Cerrá con las 3 acciones de mayor impacto, ordenadas por prioridad.
 
No expongas datos personales, no realices cambios y no inventes datos faltantes.
Si una consulta no está disponible, indicá exactamente cuál faltó.

El resultado esperado incluye el contexto correcto de la tienda, evidencia por SKU y recomendaciones concretas. No debe informar que modificó VTEX.

También podés empezar con consultas más acotadas:

Listá los 10 productos publicados con menor stock disponible. Incluí producto, SKU,
stock y evidencia, sin realizar cambios.

Revisá los últimos pedidos disponibles y resumí estado, canal y posibles demoras sin
mostrar datos personales de compradores.

Compará precio, inventario y vendibilidad de tres SKU representativos en el canal de
venta autorizado. Señalá inconsistencias y no modifiques VTEX.