API i asystenci AI

Odczytuj swoje wskaźniki z własnego kodu przez REST API albo z Claude, ChatGPT i Cursor przez MCP.

Asystenci AI (MCP)

RevGlance uruchamia serwer MCP, więc asystenci AI mogą odczytywać twoje wskaźniki z tymi samymi kontrolami i raportami co Ask. Nigdy nie wywołują modelu RevGlance i nigdy nie zużywają pytań.

Ustawienia › Asystenci AI pokazuje adres serwera wraz z krokami dla każdego klienta. W skrócie:

Dodaj RevGlance jako niestandardowy konektor z adresem z tej strony, zakończonym na /mcp.
Zaloguj się do RevGlance, gdy asystent o to poprosi. Ekran zgody mówi, co może, a czego nie może odczytać.
Pytaj śmiało. Każde zapytanie jest zachowywane jako odpowiedź z linkiem do Pokaż obliczenia.

Dla Claude Code:

bash

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

Następnie uruchom /mcp w Claude Code, aby się zalogować.

Asystent dostaje cztery narzędzia tylko do odczytu:

list-businesses: firmy, które możesz odczytywać, z ich walutą, twoją rolą i każdym źródłem wraz z czasem ostatniej synchronizacji.
describe-data: o co można zapytać w jednej firmie: każdy wskaźnik z jego znaczeniem i jednostką, miesiące z danymi oraz plany, okresy rozliczeniowe, kraje, źródła i atrybuty, które mogą filtrować lub dzielić zapytanie.
query-metrics: jeden lub więcej wskaźników w zakresie miesięcy, filtrowanych i dzielonych jak na stronach wskaźników. RevGlance sprawdza każdą nazwę, mówi, co zmienił, liczy tymi samymi raportami i zachowuje każdą odpowiedź z linkiem do Pokaż obliczenia.
explain-figure: obliczenia stojące za jedną wartością: jej rozpisany wzór i największe wiersze, które się na nią składają. W trybie prywatnym klienci występują jako krótkie etykiety.

Ustawienia › Asystenci AI pokazuje też, kto połączył którego klienta i o co każdy pytał, oraz pozwala go odłączyć, unieważniając jego tokeny. Demo i zakończone okresy próbne nie mogą się połączyć.

REST API

REST API tylko do odczytu pod /api/v1, w płatnych planach.

Utwórz klucz w Ustawienia › Klucze API. Jest pokazywany tylko raz.
Wysyłaj go jako token bearer: Authorization: Bearer <key>.

bash

curl https://your-revglance-address/api/v1/businesses \
  -H "Authorization: Bearer $REVGLANCE_KEY" \
  -H "Accept: application/json"

Obejmuje firmy, katalog wskaźników, wskaźniki z tymi samymi filtrami i podziałami co strony wskaźników (każda wartość z linkiem do Pokaż obliczenia), wyjaśnienie Dlaczego oraz klientów i płatności ze stronicowaniem kursorem. Tryb prywatny działa tak samo jak na ekranie. Każdy klucz może wykonać 120 żądań na minutę, każde żądanie jest zapisywane na stronie kluczy, a klucze wygasają po roku. Klucze API nigdy nie działają dla MCP.

Pełna dokumentacja, z każdym punktem końcowym i polem, jest w dokumentacji REST API.