Saltar al contenido principal

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

Esta guía detalla los pasos necesarios para conectar el servidor Model Context Protocol (MCP) de KSI Vision a Claude — la app web (claude.ai), las apps de escritorio y móvil, y la CLI Claude Code.

Una vez conectado, Claude 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 Claude en un plan que soporte conectores personalizados (Pro, Max, Team o Enterprise).

👉 URL del servidor MCP:

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

2. Claude.ai (Apps Web, de Escritorio y Móvil)​

Los conectores se configuran una sola vez en tu cuenta de Claude y quedan disponibles en la app web, la de escritorio y las móviles.

Paso 2.1: Agregar el Conector​

  1. Abre claude.ai y ve a Configuración → Conectores.
  2. Baja hasta el final y selecciona Agregar conector personalizado.
  3. Completa los campos:
    • Nombre: KSI Vision
    • URL del servidor MCP remoto: https://mcp.ksivision.com/api/mcp
  4. Selecciona Agregar.

Paso 2.2: Autenticación​

  1. Junto al nuevo conector KSI Vision, selecciona Conectar.
  2. Se abre una pestaña del navegador con la pantalla de inicio de sesión de KSI.
  3. Pega tu token de API de KSI y selecciona Autorizar.
  4. Serás redirigido de vuelta a Claude — 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).

Paso 2.3: Usarlo en un Chat​

  1. Inicia una conversación nueva.
  2. Abre el menú de búsqueda y herramientas (ícono de controles deslizantes) en el cuadro de mensaje y confirma que KSI Vision esté habilitado.
  3. Haz tu primera pregunta:

"Diagnostica mi cuenta de KSI."

nota

Los nombres de los menús pueden variar ligeramente a medida que Anthropic actualiza el producto. Si no ves Conectores, búscalo en Configuración → Extensiones o verifica que tu plan soporte conectores personalizados.

3. Claude Code (CLI)​

Claude Code soporta tanto OAuth interactivo como un token Bearer estático.

Opción A – OAuth (recomendada)​

  1. Agrega el servidor:

    claude mcp add --transport http ksi https://mcp.ksivision.com/api/mcp

  2. Inicia claude y luego ejecuta:

    /mcp

  3. Selecciona el servidor ksi y presiona Enter para autenticarte. Tu navegador abrirá la pantalla de inicio de sesión de KSI — pega tu token de API y selecciona Autorizar.

Opción B – Token Bearer estático​

claude mcp add --transport http ksi https://mcp.ksivision.com/api/mcp \
  --header "Authorization: Bearer <TU_TOKEN_KSI>"

Usa esta opción para entornos automatizados o sin interfaz, donde no es posible un inicio de sesión interactivo.

4. Verificación​

Una vez conectado, empieza siempre con la herramienta de diagnóstico de cuenta. Pídele a Claude:

"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í Claude 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.
  • Claude 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 Claude, generar un token o resolver algún problema:

📧 ksi.support@ksivision.com