Koru VTEX Connector

Instala y vincula una tienda VTEX con Koru para habilitar consultas seguras de solo lectura.

Koru VTEX Connector es la app que se instala dentro de VTEX. Identifica la cuenta y el workspace actuales y crea una conexión segura con Koru sin pedirte AppKey, AppToken ni contraseñas.

Son dos apps diferentes

El Connector vive en VTEX Admin. Koru VTEX MCP vive en Koru y es el servidor que después agregás a ChatGPT o Claude. Necesitás las dos piezas para completar el recorrido. Si todavía no obtuviste la app gratuita, empezá por la guía de Koru VTEX MCP.

Antes de empezar

Necesitás:

permiso para instalar apps en la cuenta VTEX elegida;
la VTEX IO CLI;
el nombre exacto de la cuenta VTEX y del workspace donde vas a probar;
una cuenta Koru con Koru VTEX MCP activa para el sitio correcto.

Instalación manual durante la prueba

El Connector todavía no está publicado en el marketplace de VTEX. Se instala por CLI. pardosit es el publisher de la app; no es la cuenta de tu tienda.

Instalación manual en VTEX

Iniciá sesión en la cuenta correcta

Reemplazá los valores de ejemplo por los de tu entorno:

vtex login TU_CUENTA_VTEX
vtex use TU_WORKSPACE
vtex whoami

Antes de seguir, vtex whoami debe mostrar exactamente la cuenta y el workspace que querés conectar. Para producción normalmente el workspace es master.

Instalá la versión publicada del Connector

vtex install pardosit.koru-vtex-connector@0.1.4

Confirmá la instalación si la CLI lo solicita y verificá el resultado:

vtex list

La lista debe incluir pardosit.koru-vtex-connector@0.1.4.

Abrí Koru VTEX Connector

Entrá a VTEX Admin, elegí la misma cuenta y abrí Configuración de la tienda → Koru VTEX Connector.

También podés abrir la ruta directamente:

https://TU_CUENTA_VTEX.myvtex.com/admin/koru-vtex-connector

En un workspace que no sea master, usá:

https://TU_WORKSPACE--TU_CUENTA_VTEX.myvtex.com/admin/koru-vtex-connector

La pantalla debe mostrar la cuenta y el entorno detectados, el estado No conectada y el botón Conectar con Koru.

Vincular la tienda con Koru

Elegí “Conectar con Koru”

Se abre Koru en otra pestaña con una solicitud temporal firmada por VTEX. No copies la URL ni empieces otro intento mientras esta solicitud esté abierta.

Iniciá sesión en la misma cuenta Koru

Usá la cuenta con la que obtuviste Koru VTEX MCP. Koru muestra la tienda detectada por VTEX y no te pide credenciales técnicas.

Si todavía no tenés una cuenta, el mismo recorrido permite crearla sin perder la solicitud del Connector.

Confirmá la conexión

En Conectá tu tienda VTEX comprobá que la cuenta coincida y elegí Conectar mi tienda. Koru intentará verificar el sitio automáticamente con la evidencia firmada por el Connector.

Si la dirección pública exacta no puede validarse de forma automática, Koru te ofrece dos métodos:

Archivo HTTPS público: publicá el archivo y el valor exactamente en la URL indicada.
Registro DNS: agregá el TXT con el nombre y valor indicados.

Después elegí Comprobar verificación. No cambies mayúsculas, espacios ni el valor generado.

Elegí la tienda que podrá consultar el asistente

Revisá la dirección pública. Si VTEX devuelve más de una, elegí la correcta y marcá la confirmación. El canal de venta y la moneda aparecen en Detalles técnicos de la tienda sólo para ayudarte a distinguirlas.

Elegí Conectar esta tienda. Es posible que Koru vuelva a pedirte iniciar sesión para confirmar una operación sensible.

Confirmá el resultado

El resultado correcto es:

en Koru: Koru VTEX MCP está conectado;
en VTEX Admin: Conectada;
cuenta y workspace iguales a los verificados con vtex whoami.

Volvé a la guía de Koru VTEX MCP para agregar el asistente y ejecutar la primera consulta.

Qué acceso concede

El Connector permite consultar catálogo, búsqueda, precios, inventario, logística y pedidos, además de simular disponibilidad y entrega. La simulación no crea carritos ni pedidos. Koru no puede modificar precios, stock, promociones ni órdenes.

Resolución de problemas

VTEX dice que la app no existe

Comprobá que ejecutaste el identificador completo y la versión exacta:

vtex install pardosit.koru-vtex-connector@0.1.4