RevGlanceDocumentation

API et assistants IA

Lisez vos métriques depuis votre propre code avec l’API REST, ou depuis Claude, ChatGPT et Cursor via MCP.

Assistants IA (MCP)

RevGlance exécute un serveur MCP : les assistants IA peuvent ainsi lire vos métriques avec les mêmes vérifications et les mêmes rapports qu’Ask. Ils n’appellent jamais le modèle de RevGlance et ne consomment jamais de questions.

Paramètres › Assistants IA affiche l’adresse du serveur et les étapes pour chaque client. En bref :

  1. Ajoutez RevGlance comme connecteur personnalisé avec l’adresse indiquée sur cette page, qui se termine par /mcp.
  2. Connectez-vous à RevGlance quand l’assistant vous le demande. L’écran de consentement indique ce qu’il peut lire et ce qu’il ne peut pas lire.
  3. Posez vos questions. Chaque requête est conservée comme réponse, avec son lien Voir le calcul.

Pour Claude Code :

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

Lancez ensuite /mcp dans Claude Code pour vous connecter.

L’assistant dispose de quatre outils en lecture seule :

  • list-businesses : les entreprises que vous pouvez lire, avec leur devise, votre rôle et chaque source avec sa dernière synchronisation.
  • describe-data : ce qu’on peut demander sur une entreprise : chaque métrique avec sa signification et son unité, les mois disposant de données, et les plans, intervalles, pays, sources et attributs qui peuvent filtrer ou ventiler une requête.
  • query-metrics : une ou plusieurs métriques sur une plage de mois, filtrées et ventilées comme sur les pages de métrique. RevGlance vérifie chaque nom, indique ce qu’il a modifié, calcule avec les mêmes rapports et conserve chaque réponse avec un lien Voir le calcul.
  • explain-figure : le calcul derrière un chiffre : sa formule développée et les lignes les plus importantes qui le composent. En mode privé, les clients apparaissent sous forme de libellés courts.

Paramètres › Assistants IA liste aussi qui a connecté quel client et ce que chacun a demandé, et permet d’en déconnecter un, ce qui révoque ses jetons. La démo et les essais terminés ne peuvent pas se connecter.

API REST

Une API REST en lecture seule sur /api/v1, avec les offres payantes.

  1. Créez une clé dans Paramètres › Clés API. Elle n’est affichée qu’une fois.
  2. Envoyez-la comme bearer token : Authorization: Bearer <key>.
bash
curl https://your-revglance-address/api/v1/businesses \
  -H "Authorization: Bearer $REVGLANCE_KEY" \
  -H "Accept: application/json"

Elle couvre les entreprises, le catalogue des métriques, les métriques avec les mêmes filtres et ventilations que les pages de métrique (chaque chiffre avec un lien Voir le calcul), l’explication Pourquoi, ainsi que les clients et les paiements avec une pagination par curseur. Le mode privé s’applique comme à l’écran. Chaque clé peut effectuer 120 requêtes par minute, chaque requête est journalisée sur la page des clés, et les clés expirent au bout d’un an. Les clés API ne fonctionnent jamais pour MCP.

La référence complète, avec chaque endpoint et chaque champ, se trouve dans la référence de l’API REST.