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, o completar el alta desde el mismo recorrido del Connector.

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.8

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.8.

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 el estado No conectada y el botón Conectar con Koru.

VTEX puede tardar hasta 5 minutos

Después de instalar, el enlace puede aparecer en la barra lateral antes de que VTEX Admin termine de refrescar su caché. Si al abrirlo ves un 404, esperá hasta cinco minutos y recargá la página. No reinstales la app durante ese intervalo.

Vincular la tienda con Koru

Elegí “Conectar con Koru”

Koru se abre con una solicitud temporal firmada por VTEX. La pestaña del Connector queda bloqueada con una indicación de que el proceso continúa en Koru y que podés cerrarla. No copies la URL ni empieces otro intento mientras la 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.

Dejá que Koru valide la conexión

El click en Conectar con Koru ya inicia la vinculación: no existe un segundo botón redundante para volver a comenzar. Koru muestra la cuenta detectada e intenta 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 elegida durante el alta. Koru no vuelve a pedir el mismo dominio. Si ese dominio tiene más de un canal de venta, elegí el correcto; con uno solo, queda seleccionado automáticamente. El canal y la moneda aparecen en Detalles técnicos de la tienda sólo para ayudarte a distinguirlos.

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.

La pantalla final prioriza Tu tienda ya está lista y compacta los pasos completados para que no tengas que volver a recorrerlos.

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.8