RevGlanceDocumentatie

API en AI-assistenten

Lees je metrieken vanuit je eigen code met de REST API, of vanuit Claude, ChatGPT en Cursor via MCP.

AI-assistenten (MCP)

RevGlance draait een MCP-server, zodat AI-assistenten je metrieken kunnen lezen met dezelfde controles en rapporten als Ask. Ze roepen nooit het model van RevGlance aan en verbruiken nooit vragen.

Instellingen › AI-assistenten toont het serveradres met de stappen voor elke client. In het kort:

  1. Voeg RevGlance toe als aangepaste connector met het adres van die pagina, dat eindigt op /mcp.
  2. Log in bij RevGlance als de assistent erom vraagt. Het toestemmingsscherm zegt wat hij wel en niet kan lezen.
  3. Vraag maar raak. Elke query wordt bewaard als antwoord met een link naar Bekijk de berekening.

Voor Claude Code:

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

Voer daarna /mcp uit in Claude Code om in te loggen.

De assistent krijgt vier tools die alleen lezen:

  • list-businesses: de bedrijven die je kunt lezen, met hun valuta, je rol en elke bron met het moment van de laatste synchronisatie.
  • describe-data: wat je over één bedrijf kunt vragen: elke metriek met zijn betekenis en eenheid, de maanden met gegevens, en de abonnementen, intervallen, landen, bronnen en kenmerken waarmee een query gefilterd of opgesplitst kan worden.
  • query-metrics: een of meer metrieken over een reeks maanden, gefilterd en opgesplitst zoals op de metriekpagina's. RevGlance controleert elke naam, zegt wat het veranderde en telt met dezelfde rapporten, en bewaart elk antwoord met een link naar Bekijk de berekening.
  • explain-figure: de berekening achter één cijfer: de uitgewerkte formule en de grootste rijen die samen dat cijfer vormen. In privémodus verschijnen klanten als korte labels.

Instellingen › AI-assistenten toont ook wie welke client heeft gekoppeld en wat elk vroeg, en ontkoppelt een client door zijn tokens in te trekken. De demo en afgelopen proefperiodes kunnen niet koppelen.

REST API

Een REST API die alleen leest, op /api/v1, bij betaalde abonnementen.

  1. Maak een sleutel aan in Instellingen › API-sleutels. Die wordt één keer getoond.
  2. Stuur hem mee als bearer-token: Authorization: Bearer <key>.
bash
curl https://your-revglance-address/api/v1/businesses \
  -H "Authorization: Bearer $REVGLANCE_KEY" \
  -H "Accept: application/json"

De API omvat bedrijven, de metriekcatalogus, metrieken met dezelfde filters en opsplitsingen als de metriekpagina's (elk cijfer met een link naar Bekijk de berekening), de uitleg van Waarom, en klanten en betalingen met cursorpaginering. Privémodus geldt net als op het scherm. Elke sleutel kan 120 verzoeken per minuut doen, elk verzoek wordt gelogd op de sleutelpagina, en sleutels verlopen na een jaar. API-sleutels werken nooit voor MCP.

De volledige referentie, met elk endpoint en veld, staat in de REST API-referentie.