API와 AI 어시스턴트

REST API로 직접 작성한 코드에서, 또는 MCP를 통해 Claude, ChatGPT, Cursor에서 지표를 읽으세요.

AI 어시스턴트(MCP)

RevGlance는 MCP 서버를 운영하므로 AI 어시스턴트가 Ask와 같은 검증과 리포트로 지표를 읽을 수 있습니다. 어시스턴트는 RevGlance의 모델을 호출하지 않으며 질문도 사용하지 않습니다.

설정 › AI 어시스턴트에 서버 주소와 클라이언트별 설정 단계가 나와 있습니다. 요약하면 다음과 같습니다.

해당 페이지에 있는 /mcp로 끝나는 주소로 RevGlance를 사용자 지정 커넥터로 추가합니다.
어시스턴트가 요청하면 RevGlance에 로그인합니다. 동의 화면에 읽을 수 있는 것과 읽을 수 없는 것이 표시됩니다.
마음껏 질문하세요. 각 쿼리는 계산 보기 링크가 있는 답변으로 보관됩니다.

Claude Code의 경우:

bash

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

그런 다음 Claude Code에서 /mcp를 실행해 로그인합니다.

어시스턴트는 네 가지 읽기 전용 도구를 사용할 수 있습니다.

list-businesses: 읽을 수 있는 비즈니스 목록과 각 비즈니스의 통화, 사용자의 역할, 소스별 마지막 동기화 시각을 보여 줍니다.
describe-data: 한 비즈니스에 대해 물어볼 수 있는 것: 모든 지표의 의미와 단위, 데이터가 있는 월, 쿼리를 필터링하거나 나눌 수 있는 플랜, 주기, 국가, 소스, 속성을 보여 줍니다.
query-metrics: 하나 이상의 지표를 월 범위로 조회하며, 지표 페이지처럼 필터링하고 나눌 수 있습니다. RevGlance는 모든 이름을 확인하고, 무엇을 바꿨는지 알려 주고, 같은 리포트로 집계하며, 각 답변을 계산 보기 링크와 함께 보관합니다.
explain-figure: 숫자 하나 뒤의 계산: 공식을 풀어 보여 주고, 그 숫자를 이루는 가장 큰 행들을 보여 줍니다. 개인정보 보호 모드에서는 고객이 짧은 라벨로 표시됩니다.

설정 › AI 어시스턴트에는 누가 어떤 클라이언트를 연결했고 각각 무엇을 물었는지도 나와 있으며, 연결을 끊어 토큰을 취소할 수 있습니다. 데모와 종료된 체험판은 연결할 수 없습니다.

REST API

/api/v1에 있는 읽기 전용 REST API이며, 유료 플랜에서 사용할 수 있습니다.

설정 › API 키에서 키를 만듭니다. 키는 한 번만 표시됩니다.
키를 bearer 토큰으로 보냅니다: Authorization: Bearer <key>.

bash

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

API는 비즈니스, 지표 카탈로그, 지표 페이지와 같은 필터와 분할을 지원하는 지표(각 숫자에 계산 보기 링크 포함), 왜 바뀌었나요? 설명, 그리고 커서 페이징을 지원하는 고객과 결제를 다룹니다. 개인정보 보호 모드는 화면과 똑같이 적용됩니다. 각 키는 분당 120건의 요청을 보낼 수 있고, 모든 요청은 키 페이지에 기록되며, 키는 1년 후 만료됩니다. API 키는 MCP에서는 절대 사용할 수 없습니다.

모든 엔드포인트와 필드를 담은 전체 레퍼런스는 REST API 레퍼런스에 있습니다.