RevGlanceDocumentazione

API e assistenti AI

Leggi le tue metriche dal tuo codice con la REST API, oppure da Claude, ChatGPT e Cursor tramite MCP.

Assistenti AI (MCP)

RevGlance offre un server MCP, così gli assistenti AI possono leggere le tue metriche con gli stessi controlli e report di Ask. Non chiamano mai il modello di RevGlance e non consumano mai domande.

Impostazioni › Assistenti AI mostra l'indirizzo del server con i passaggi per ogni client. In breve:

  1. Aggiungi RevGlance come connettore personalizzato con l'indirizzo di quella pagina, che termina con /mcp.
  2. Accedi a RevGlance quando l'assistente te lo chiede. La schermata di consenso indica cosa può e non può leggere.
  3. Chiedi pure. Ogni query viene conservata come risposta con il suo link a Mostra il calcolo.

Per Claude Code:

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

Poi esegui /mcp in Claude Code per accedere.

L'assistente riceve quattro strumenti in sola lettura:

  • list-businesses: le attività che puoi leggere, con la loro valuta, il tuo ruolo e ogni fonte con l'ora dell'ultima sincronizzazione.
  • describe-data: cosa si può chiedere su un'attività: ogni metrica con significato e unità, i mesi con dati, e i piani, gli intervalli, i paesi, le fonti e gli attributi che possono filtrare o suddividere una query.
  • query-metrics: una o più metriche su un intervallo di mesi, filtrate e suddivise come nelle pagine delle metriche. RevGlance controlla ogni nome, dice cosa ha cambiato e calcola con gli stessi report, e conserva ogni risposta con un link a Mostra il calcolo.
  • explain-figure: il calcolo dietro un valore: la formula sviluppata e le righe più grandi che lo compongono. In modalità privata i clienti compaiono come brevi etichette.

Impostazioni › Assistenti AI elenca anche chi ha collegato quale client e cosa ha chiesto ciascuno, e permette di scollegarne uno revocandone i token. La demo e le prove terminate non possono collegarsi.

REST API

Una REST API in sola lettura su /api/v1, sui piani a pagamento.

  1. Crea una chiave in Impostazioni › Chiavi API. Viene mostrata una sola volta.
  2. Inviala come bearer token: Authorization: Bearer <key>.
bash
curl https://your-revglance-address/api/v1/businesses \
  -H "Authorization: Bearer $REVGLANCE_KEY" \
  -H "Accept: application/json"

Copre le attività, il catalogo delle metriche, le metriche con gli stessi filtri e suddivisioni delle pagine delle metriche (ogni valore con un link a Mostra il calcolo), la spiegazione Perché, e clienti e addebiti con paginazione a cursore. La modalità privata si applica come sullo schermo. Ogni chiave può fare 120 richieste al minuto, ogni richiesta è registrata nella pagina delle chiavi e le chiavi scadono dopo un anno. Le chiavi API non funzionano mai per MCP.

Il riferimento completo, con ogni endpoint e campo, è nel riferimento della REST API.