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	Cuenta y email verificados
2	Koru Suite	Organización, sitio y app gratuita creados
3	Koru Suite	Sitio verificado
4	VTEX Admin	Connector instalado y tienda vinculada
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 volvé a Koru con Ya verifiqué mi email.

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.

Verificá el sitio

Desde el panel abrí Mis sitios web, buscá el sitio nuevo y elegí Verificar tienda. Elegí uno de estos métodos:

Archivo HTTPS público: publicá un archivo de texto en la dirección exacta que muestra Koru.
Registro del dominio (DNS): creá el registro TXT con el nombre y valor exactos.

Elegí Comprobar verificación. El resultado debe ser Tienda verificada.

Abrí la configuración de Koru VTEX MCP

Entrá a Mis apps → Koru VTEX MCP. La primera tarjeta indica que falta conectar VTEX y ofrece Abrir VTEX Admin.

Seguí ahora la instalación y vinculación de Koru VTEX Connector. Cuando termine, volvé a esta guía.

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.