RevGlanceDocumentação

API e assistentes de IA

Leia suas métricas no seu próprio código com a API REST, ou no Claude, ChatGPT e Cursor via MCP.

Assistentes de IA (MCP)

O RevGlance roda um servidor MCP, para que assistentes de IA possam ler suas métricas com as mesmas verificações e relatórios do Ask. Eles nunca chamam o modelo do RevGlance e nunca gastam perguntas.

Configurações › Assistentes de IA mostra o endereço do servidor com os passos para cada cliente. Em resumo:

  1. Adicione o RevGlance como conector personalizado com o endereço daquela página, que termina em /mcp.
  2. Entre no RevGlance quando o assistente pedir. A tela de consentimento diz o que ele pode e não pode ler.
  3. Pergunte à vontade. Cada consulta é guardada como uma resposta com seu link para Ver o cálculo.

Para o Claude Code:

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

Depois, rode /mcp no Claude Code para entrar.

O assistente recebe quatro ferramentas somente leitura:

  • list-businesses: os negócios que você pode ler, com a moeda, a sua função e cada fonte com a data da última sincronização.
  • describe-data: o que se pode perguntar sobre um negócio: cada métrica com seu significado e unidade, os meses com dados e os planos, intervalos, países, fontes e atributos que podem filtrar ou dividir uma consulta.
  • query-metrics: uma ou mais métricas em um intervalo de meses, filtradas e divididas como nas páginas de métricas. O RevGlance verifica cada nome, diz o que mudou, calcula com os mesmos relatórios e guarda cada resposta com um link para Ver o cálculo.
  • explain-figure: o cálculo por trás de um número: a fórmula resolvida e as maiores linhas que o compõem. No modo privado, os clientes aparecem como rótulos curtos.

Configurações › Assistentes de IA também lista quem conectou qual cliente e o que cada um perguntou, e desconecta um deles, revogando seus tokens. A demonstração e testes encerrados não podem se conectar.

API REST

Uma API REST somente leitura em /api/v1, nos planos pagos.

  1. Crie uma chave em Configurações › Chaves de API. Ela é mostrada uma única vez.
  2. Envie-a como bearer token: Authorization: Bearer <key>.
bash
curl https://your-revglance-address/api/v1/businesses \
  -H "Authorization: Bearer $REVGLANCE_KEY" \
  -H "Accept: application/json"

Ela cobre negócios, o catálogo de métricas, métricas com os mesmos filtros e divisões das páginas de métricas (cada número com um link para Ver o cálculo), a explicação de Por que isso mudou?, e clientes e cobranças com paginação por cursor. O modo privado se aplica como na tela. Cada chave pode fazer 120 solicitações por minuto, toda solicitação fica registrada na página de chaves e as chaves expiram depois de um ano. Chaves de API nunca funcionam para MCP.

A referência completa, com cada endpoint e campo, está na referência da API REST.