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/mcp

En Claude

1. Abre Configuración → Conectores.
2. Elige agregar conector personalizado.
3. Pega la URL del servidor.
4. Claude abre la pantalla de consentimiento en https://painelalter.com/mcp/authorize. Ingresa con las credenciales de tu panel AlterVision.
5. Aprueba el acceso. El conector queda disponible en tus conversaciones.

Atajo

También puedes agregar el conector directo en Claude y saltar al paso 4.

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.

Atajo

Agrega el conector directo en ChatGPT.

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.

Soporte

Dudas, problemas o sugerencias sobre el conector: contáctanos por correo electrónico a suporte@altervision.com.br.