Conector MCP de AlterVision 🤖
Qué es
El conector oficial de AlterVision da a tu asistente de IA acceso de solo lectura a los indicadores de tus tiendas físicas, permitiéndote preguntar en lenguaje natural sobre flujo de visitantes, conversión, metas, carreras y motivos de no conversión — sin abrir el panel ni armar un informe.
Es un servidor MCP (Model Context Protocol), el protocolo abierto que estandariza cómo los asistentes de IA acceden a herramientas y datos externos. Cualquier cliente compatible con MCP puede usarlo — Claude y ChatGPT, entre otros.
| URL del servidor | https://api.painelalter.com/mcp |
| Transporte | Streamable HTTP |
| Autenticación | OAuth 2.1 con PKCE y client ID metadata documents (CIMD) |
| Pantalla de consentimiento | https://painelalter.com/mcp/authorize |
| Herramientas | 9, todas de solo lectura |
| Compatibilidad | Cualquier cliente MCP con soporte para HTTP remoto y OAuth |
Solo lectura
Todas las herramientas del conector únicamente consultan información. Ninguna escribe, modifica ni elimina datos en PainelAlter.
Requisitos previos
- Cuenta AlterVision activa en painelalter.com.
- Acceso a por lo menos una tienda.
- Para algunas herramientas, tiendas con el producto AlterVez activo — consulta la Referencia de herramientas.
Tiendas sin AlterVez
Las herramientas de carreras, motivos de no conversión y transcripciones solo reportan tiendas con AlterVez activo. Una tienda sin AlterVez se excluye silenciosamente del resultado — no genera error. Si esperas ver una tienda y no aparece en esas respuestas, es probable que no tenga el producto activo.
Cómo conectar
Los pasos cambian de un cliente a otro, pero el procedimiento es el mismo en todos: agregar un conector remoto indicando la URL del servidor. No hay registro previo ni clave de API que generar — al agregar el conector, el flujo OAuth inicia por sí solo.
https://api.painelalter.com/mcpEn Claude
- Abre Configuración → Conectores.
- Elige agregar conector personalizado.
- Pega la URL del servidor.
- Claude abre la pantalla de consentimiento en
https://painelalter.com/mcp/authorize. Ingresa con las credenciales de tu panel AlterVision. - Aprueba el acceso. El conector queda disponible en tus conversaciones.
TODO
Incluir las capturas de pantalla de cada paso en Claude (Configuración → Conectores, campo de la URL, pantalla de consentimiento de PainelAlter y pantalla de aprobación).
En ChatGPT
ChatGPT permite agregar conectores MCP remotos en la configuración de conectores. Después de indicar la URL del servidor, el resto del flujo es idéntico: se abre la pantalla de consentimiento de PainelAlter, ingresas con tus credenciales y apruebas el acceso.
TODO
Confirmar y describir la ruta exacta en la interfaz actual de ChatGPT (planes en los que está disponible la función, nombre del menú y si se requiere algún modo de desarrollador), e incluir las capturas correspondientes.
En otros clientes MCP
Cualquier cliente con soporte para servidores MCP remotos vía HTTP y autenticación OAuth puede usar el conector. Indica la URL del servidor en el formato que pida el cliente y completa el inicio de sesión en la pantalla de consentimiento de PainelAlter.
Independiente del cliente
El conector no depende de ningún asistente específico: las mismas 9 herramientas, el mismo alcance de datos y el mismo flujo de autenticación valen para todos los clientes.
El token generado da acceso exactamente a las tiendas que ya ves en el panel — ni más, ni menos.
Qué puedes preguntar
No necesitas saber el nombre de las herramientas ni los ids de las tiendas: pregunta como le hablarías a un analista. Algunos ejemplos:
Flujo y conversión
- "¿Cómo fue la conversión de mis tiendas esta semana?"
- "¿Cuántos visitantes recibió mi tienda del centro por día el mes pasado?"
- "¿Qué tienda tuvo el mejor PA en agosto?"
- "¿Las cámaras estuvieron activas todo el período?"
Metas
- "¿Estoy cumpliendo la meta del mes?"
- "Si el ritmo continúa así, ¿dónde van a cerrar mis metas?"
- "¿Qué vendedores están contribuyendo a la meta de la tienda X?"
Carreras
- "¿Quién va ganando la carrera?"
- "¿Cómo está la clasificación de la carrera de conversión entre las tiendas?"
- "¿Qué vendedor va adelante en la carrera de la tienda X?"
No conversión
- "¿Por qué los clientes no están comprando en la tienda X?"
- "¿Cuánto ingreso perdí por quiebre de stock el último mes?"
- "¿Los motivos de no conversión empeoraron respecto al período anterior?"
- "¿Qué pidieron los clientes y no había? Muéstrame las atenciones."
Referencia de herramientas
Todas las herramientas con período exigen dateBegin y dateEnd en formato YYYY-MM-DD. Todas aceptan storeIds opcional (lista de ids); omitirlo significa "todas las tiendas a las que el usuario tiene acceso".
| Herramienta | Qué devuelve | Requiere AlterVez |
|---|---|---|
whoami | Id, nombre de usuario y correo del usuario autenticado. Sin parámetros. | — |
get_stores | Tiendas a las que el usuario tiene acceso, con id, alias y nombre. Sin parámetros. Sirve para resolver el nombre de una tienda en el id que esperan las demás herramientas. | — |
get_flow_per_day | Conteo de visitantes y promedio diario por tienda, día por día. | — |
conversion_rate_per_date | Facturación, número de ventas, tasa de conversión, PA, precio promedio por pieza y uptime de las cámaras, por tienda. | — |
metas_infos | Compara facturación, flujo, conversión y PA realizados contra lo proyectado de cada meta activa en el período, y proyecta dónde cierra cada meta. | — |
corridas_infos | Carreras entre tiendas o entre vendedores de una tienda, con KPI, fechas y participantes. | Sí |
get_noc_reason_classifications_available | Clasificaciones y subclasificaciones que puede tener un motivo de no conversión. Sin parámetros. | — |
noc_reasons_stats | Distribución de los motivos de no conversión: conteo, participación, ingreso perdido y variación contra el período anterior del mismo tamaño. | Sí |
search_non_conversion_transcriptions | Las atenciones detrás de las no conversiones, con el relato del propio vendedor sobre lo que pidió el cliente. | Sí |
Detalles por herramienta
get_flow_per_day
Parámetros extra: includeDetails (desglose por día) y flowPreference (individual o group, sobrescribe la preferencia guardada del usuario). Las tiendas sin flujo medido en el período se omiten.
conversion_rate_per_date
Parámetros extra: includeDetails y flowPreference. Las métricas por ítem (PA y precio promedio por pieza) solo tienen sentido en tiendas con integración de ventas por ERP.
metas_infos
Parámetros extra: includeDetails e includeSellers. Admite metas escalonadas. Devuelve una entrada por meta, no por tienda — una meta puede abarcar varias tiendas.
corridas_infos
Parámetros extra: category (store o seller), kpi (conversion, numberOfSales, revenue, averageTicket, pa) e includeRanking (clasificación actual).
get_noc_reason_classifications_available
Debe llamarse antes de noc_reasons_stats y search_non_conversion_transcriptions para descubrir los valores válidos de filtro.
noc_reasons_stats
Parámetros extra: includeSubclassifications, includeStoreBreakdown y sellerIds — omitir sellerIds significa sin desglose por vendedor; un array vacío desglosa por todos los vendedores.
search_non_conversion_transcriptions
Parámetros: mainClassifications (obligatorio, al menos una), subClassifications y sellerIds. Trae el relato del propio vendedor sobre lo que pidió el cliente — quiebre de stock, marcas, formas de pago, objeción de precio.
Límite de resultados
El resultado está limitado a 100 atenciones en total, por lo que los filtros deben ser estrechos.
Glosario
| Término | Significado |
|---|---|
| Atenciones (atendimentos) | Interacciones registradas entre vendedor y cliente en la tienda. |
| AlterVez | Producto de AlterVision que habilita el registro de atenciones, motivos de no conversión y carreras. |
| Carreras (corridas) | Competencias entre tiendas o entre vendedores de una misma tienda, disputadas sobre un KPI. |
| Metas | Objetivos definidos en el panel para facturación, flujo, conversión y PA. Pueden ser escalonadas y abarcar varias tiendas. |
| No conversión | Atención que no resultó en venta, clasificada por motivo. |
| PA | Piezas por atención — cantidad promedio de ítems por venta. |
Privacidad y seguridad
- Solo lectura. Las nueve herramientas únicamente consultan datos. Ninguna escribe, modifica ni elimina información en PainelAlter.
- Mismo alcance del panel. El asistente ve exactamente las tiendas que ya ves en PainelAlter — ni más, ni menos. Los cambios en tu acceso al panel se reflejan en el conector.
- Tu propia autenticación. El inicio de sesión ocurre en la pantalla de PainelAlter (
https://painelalter.com/mcp/authorize); tus credenciales no se informan al asistente. - Revocación. Para retirar el acceso, desconecta el conector en la configuración de tu asistente. En Claude: Configuración → Conectores.
TODO
Enlazar la política de privacidad de AlterVision — no hay ninguna URL registrada en este repositorio.
Soporte
Dudas, problemas o sugerencias sobre el conector: contáctanos por correo electrónico a suporte@altervision.com.br.