RevGlanceDocumentación

API y asistentes de IA

Lee tus métricas desde tu propio código con la API REST, o desde Claude, ChatGPT y Cursor a través de MCP.

Asistentes de IA (MCP)

RevGlance ejecuta un servidor MCP, así que los asistentes de IA pueden leer tus métricas con las mismas comprobaciones e informes que Ask. Nunca llaman al modelo de RevGlance ni gastan preguntas.

Configuración › Asistentes de IA muestra la dirección del servidor con los pasos para cada cliente. En resumen:

  1. Añade RevGlance como conector personalizado con la dirección de esa página, que termina en /mcp.
  2. Inicia sesión en RevGlance cuando el asistente te lo pida. La pantalla de consentimiento indica qué puede leer y qué no.
  3. Pregunta lo que quieras. Cada consulta se guarda como una respuesta con su enlace a Ver el cálculo.

Para Claude Code:

bash
claude mcp add --transport http revglance https://your-revglance-address/mcp

Después ejecuta /mcp en Claude Code para iniciar sesión.

El asistente recibe cuatro herramientas de solo lectura:

  • list-businesses: los negocios que puedes leer, con su moneda, tu rol y cada fuente con su última sincronización.
  • describe-data: qué se le puede preguntar a un negocio: cada métrica con su significado y unidad, los meses con datos, y los planes, intervalos, países, fuentes y atributos que pueden filtrar o desglosar una consulta.
  • query-metrics: una o más métricas en un rango de meses, filtradas y desglosadas como en las páginas de métricas. RevGlance comprueba cada nombre, indica qué cambió y calcula con los mismos informes, y guarda cada respuesta con un enlace a Ver el cálculo.
  • explain-figure: el cálculo detrás de una cifra: su fórmula desarrollada y las filas más grandes que la componen. En modo privado los clientes aparecen como etiquetas cortas.

Configuración › Asistentes de IA también muestra quién conectó qué cliente y qué preguntó cada uno, y permite desconectar uno, revocando sus tokens. La demo y las pruebas terminadas no pueden conectarse.

API REST

Una API REST de solo lectura en /api/v1, en los planes de pago.

  1. Crea una clave en Configuración › Claves de API. Se muestra una sola vez.
  2. Envíala como bearer token: Authorization: Bearer <key>.
bash
curl https://your-revglance-address/api/v1/businesses \
  -H "Authorization: Bearer $REVGLANCE_KEY" \
  -H "Accept: application/json"

Cubre los negocios, el catálogo de métricas, las métricas con los mismos filtros y desgloses que las páginas de métricas (cada cifra con un enlace a Ver el cálculo), la explicación de ¿Por qué cambió?, y los clientes y cobros con paginación por cursor. El modo privado se aplica igual que en pantalla. Cada clave puede hacer 120 peticiones por minuto, cada petición queda registrada en la página de claves y las claves caducan al cabo de un año. Las claves de API nunca sirven para MCP.

La referencia completa, con cada endpoint y campo, está en la referencia de la API REST.