Saltar al contenido principal

Guía de Configuración: Servidor MCP de KSI Vision en ChatGPT

Esta guía detalla los pasos necesarios para conectar el servidor Model Context Protocol (MCP) de KSI Vision a ChatGPT como conector personalizado.

Una vez conectado, ChatGPT puede consultar directamente los indicadores de tus tiendas —tráfico, colas, tiempo de permanencia, conversión de ventas, zonas y más— y convertirlos en reportes, comparativas y análisis en lenguaje natural.

1. Requisitos Previos​

Antes de comenzar, asegúrate de contar con:

  • Una cuenta de KSI Vision con acceso para crear tokens de API (si no tienes acceso, solicítalo a ksi.support@ksivision.com).
  • Tu token de API de KSI (ver API – Guía de Primeros Pasos).
  • Una cuenta de ChatGPT en un plan pago (Plus, Pro, Business, Enterprise o Edu). Los conectores MCP personalizados no están disponibles en el plan gratuito.
  • En espacios de trabajo Business / Enterprise / Edu, puede ser necesario que un administrador habilite primero los conectores personalizados para el workspace.

👉 URL del servidor MCP:

  • https://mcp.ksivision.com/api/mcp

2. Habilitar el Modo Desarrollador​

Los conectores MCP personalizados con acceso completo a herramientas se gestionan a través del modo desarrollador de ChatGPT:

  1. Abre ChatGPT y ve a Configuración.
  2. Selecciona Apps y Conectores (o Conectores, según tu versión).
  3. Baja hasta Configuración avanzada.
  4. Activa el Modo desarrollador.
nota

Los nombres de los menús pueden variar ligeramente a medida que OpenAI actualiza el producto. Si no ves la opción, verifica que tu plan soporte conectores y que el administrador de tu workspace los haya habilitado.

3. Agregar el Conector de KSI Vision​

  1. Vuelve a Configuración → Apps y Conectores.
  2. Selecciona Crear (o Agregar conector).
  3. Completa los campos:
    • Nombre: KSI Vision
    • URL del servidor MCP: https://mcp.ksivision.com/api/mcp
    • Autenticación: OAuth
  4. Confirma la casilla de confianza y selecciona Crear.

Autenticación​

  1. Se abre una pestaña del navegador con la pantalla de inicio de sesión de KSI.
  2. Pega tu token de API de KSI y selecciona Autorizar.
  3. Serás redirigido de vuelta a ChatGPT — el conector aparece ahora como conectado.

No necesitarás pegar el token nuevamente hasta que expire (los tokens de acceso duran 30 días y se renuevan automáticamente mientras sigas usando el conector).

4. Usarlo en un Chat​

  1. Inicia una conversación nueva.
  2. Abre el menú + en el cuadro de mensaje, selecciona Apps y elige el conector KSI Vision de la lista.
  3. Haz tu primera pregunta:

"Diagnostica mi cuenta de KSI."

ChatGPT llamará a las herramientas del MCP de KSI de forma transparente bajo tu identidad autenticada, y mostrará qué herramientas usó en cada respuesta.

5. Verificación​

Una vez conectado, empieza siempre con la herramienta de diagnóstico de cuenta:

"Diagnostica mi cuenta de KSI."

Esto devuelve el tipo de espacio (retail, mall, aeropuerto…), los indicadores globales habilitados en la cuenta y qué capacidades tiene cada tienda (ventas, colas, zonas, sublocations) — así ChatGPT sabe qué puede pedir con seguridad antes de ejecutar un análisis.

Ejemplos de preguntas​

  • "Compara el tráfico y la conversión de mis tiendas en junio, agrupado por etiqueta."
  • "¿En qué ventanas de día y hora estoy perdiendo ventas por colas largas en la tienda 661?"
  • "¿Abrir más cajas mejoraría la conversión en horas pico?"

Notas de Seguridad​

  • El servidor MCP es de solo lectura: consulta indicadores y nunca modifica configuración, cámaras ni datos.
  • Tu token viaja con cada solicitud y nunca se almacena en el servidor MCP.
  • ChatGPT solo ve las tiendas y datos a los que tu token tiene acceso — cada usuario debe conectarse con su propio token.

Soporte​

Si necesitas ayuda para conectar ChatGPT, generar un token o resolver algún problema:

📧 ksi.support@ksivision.com