Documentación

Servidor MCP de KSI Vision — la API de KSI como herramientas de análisis para asistentes de IA.

Qué hace

Expone los datos de KSI Vision —tráfico de personas, colas, tiempos de permanencia, ocupación, zonas, conversión de ventas y demografía— como herramientas que un asistente puede llamar para responder preguntas de negocio: cuánta gente entró, a qué hora conviene reforzar la caja, cómo compara una tienda contra el resto.

Sólo lee. Ninguna herramienta de datos modifica ni borra nada en tu cuenta de KSI. La única que escribe hacia afuera es la de soporte, que manda un email y siempre te pide permiso antes.

Requisitos

Una cuenta activa de KSI Vision con al menos una tienda configurada.
Un API token propio: entrá a la.ksivision.com → Mi Perfil → generar token. Tratalo como una contraseña.

Lo que veas por el MCP es exactamente lo que tu usuario ve en la plataforma: el conector no amplía permisos.

Conectar

Endpoint (transporte Streamable HTTP):

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

Hay dos formas de autenticarse, y no hace falta elegir: cada cliente usa la que soporta.

OAuth 2.1 con PKCE y registro dinámico de clientes (Claude web y escritorio, ChatGPT, Gemini). Agregás la URL del endpoint como conector y el cliente te lleva solo a la pantalla de login, donde pegás tu API token de KSI una vez.
Bearer estático (Claude Code, integraciones por API). Mandás tu API token de KSI en el header Authorization.

{
  "mcpServers": {
    "ksi": {
      "url": "https://mcp.ksivision.com/api/mcp",
      "headers": { "Authorization": "Bearer TU_API_TOKEN_DE_KSI" }
    }
  }
}

Por dónde empezar

ksi_diagnose_account — qué datos tiene realmente tu cuenta. No todas las cuentas tienen ventas, colas o zonas, y esta herramienta lo dice antes de que el asistente elija mal.
ksi_list_locations_groups — los IDs de tus location groups, que el resto de las herramientas piden. Un location group puede representar un espacio retail, un mall u otro espacio.
Preguntá en lenguaje natural: “¿cuánta gente entró la semana pasada?”, “¿a qué hora se satura la cola los sábados?”.

Si tu usuario es superadmin (sin company propia), empezá por ksi_list_companies y pasá el companyId elegido en las demás llamadas.

Herramientas (37)

De sólo lectura (36). Consultan la API de KSI y no cambian nada.

Nombre	Qué hace
`ksi_list_companies`	Listar companies (superadmin)
`ksi_diagnose_account`	Diagnóstico de cuenta KSI
`ksi_list_locations_groups`	Listar location groups
`ksi_get_locations_group_structure`	Estructura de un location group
`ksi_explain_indicator`	Explicar cómo se mide un indicador
`ksi_get_queue_metrics`	Métricas de colas
`ksi_get_traffic`	Tráfico (entradas/salidas)
`ksi_get_queue_traffic`	Tráfico por colas (probadores / checkouts / autocobros)
`ksi_get_queue_dwell_time`	Tiempos de cola: permanencia y espera (minutos)
`ksi_get_queue_waiting_histogram`	Histograma de tiempos de espera por cola
`ksi_get_traffic_by_floor`	Tráfico por planta (piso)
`ksi_get_traffic_by_line`	Tráfico por línea de conteo (accesos)
`ksi_get_sublocation_traffic`	Tráfico por sublocation
`ksi_get_dwell_time`	Tiempo de permanencia
`ksi_get_unique_visitors_per_zone`	Visitantes únicos por zona
`ksi_get_occupancy`	Ocupación
`ksi_get_visitor_patterns`	Patrones por día de semana y hora
`ksi_get_sales_conversion`	Ventas y conversión
`ksi_get_demographics`	Demografía de visitantes
`ksi_get_cars_traffic`	Tráfico de vehículos (estacionamiento)
`ksi_get_queue_compliance`	Calidad de atención — cumplimiento del estándar de colas
`ksi_get_alerts`	Alertas de cola
`ksi_get_conversion_goals`	Metas de conversión
`ksi_get_live_status`	Estado en vivo (conteo actual)
`ksi_get_infrastructure_status`	Estado de la infraestructura (camaras y nodos)
`ksi_compare_periods`	Comparar períodos
`ksi_analyze_queue_saturation`	Análisis de saturación de colas
`ksi_analyze_capacity_impact`	Impacto de la capacidad (cajas)
`ksi_benchmark_locations_groups`	Benchmark de location groups
`ksi_benchmark_sublocations`	Benchmark de sublocations (tiendas de un mall)
`ksi_recommend_staffing_windows`	Recomendacion de dotacion por ventanas
`ksi_mall_category_performance`	Performance por categoria de mall
`ksi_compare_live_to_baseline`	Comparar vivo contra baseline
`ksi_get_data_quality_report`	Reporte de calidad de datos
`ksi_export_dataset`	Exportar serie completa a CSV (link de descarga)
`ksi_agent_friction_report`	Reporte de fricción del agente

De escritura (1). Tienen efectos fuera de KSI, así que tu cliente te pide confirmación en cada llamada.

Nombre	Qué hace
`ksi_report_issue`	Reportar un problema del MCP a soporte de KSI

Reportar un problema

Si una herramienta falla o te falta un dato, pedile al asistente que lo reporte: usa ksi_report_issue, que arma el reporte, te muestra el texto exacto y sólo lo envía a soporte si aceptás. Sirve para dos cosas: corregir el caso, o evaluarlo como funcionalidad nueva. Tu API token nunca se incluye.

También podés escribir directo a ksi.soporte@ksivision.com.

Privacidad y seguridad

Tu API token no se guarda en ningún lado: vive lo que dura el request. Las sesiones de OAuth son sobres cifrados que viajan con el cliente, sin base de datos de sesiones. El detalle completo —qué se registra, cuánto se retiene y con quién se comparte— está en la política de privacidad.