본문으로 건너뛰기
LVIS AI

Getting Started

Marketplace 로그인 & 첫 화면

호스트 앱 자체는 로컬-퍼스트로 작동하지만, 플러그인 카탈로그 / 다운로드 / 서명 검증을 위해 Marketplace 계정 + Agent Hub 서버 인증이 필요합니다. 인증은 plugin 측 hostApi.openAuthWindow / hostApi.openAuthPartitionViewer 로 처리됩니다.

왜 로그인이 필요할까요?

  • Marketplace — 플러그인 catalog read + 패키지 다운로드 (deeplink lvis://install/<slug> 이 호스트로 routing).
  • Agent Hub — Work Board / Inbox 동기화 (HTTPBearer 토큰, agent-hub.lvisai.xyz).
  • ms-graph, lge-api — 각 플러그인 자체 OAuth (MSAL · EP SSO). 토큰은 plugin namespace 에 격리.

로그인 흐름

  1. 01

    메인 호스트 → Marketplace SSO

    웹 브라우저에서 Marketplace LoginPage 진입. Marketplace 서버 (marketplace.lvisai.xyz) 의 /api/v1/auth/* 가 응답.

  2. 02

    API key 발급

    1회

    로그인 성공 시 ApiKey (publisher/admin role) 가 발급되고, 클라이언트는 키의 sha256 hash 가 서버 DB 의 api_keys.key_hash 와 매칭되는지 검증.

  3. 03

    Agent Hub 토큰

    Work Board 사용을 위해 별도 Agent Hub /auth/exchange/issue + /auth/exchange/redeem 흐름 (lvis-agent-hub/src/.../api/auth_exchange.py). PKCE-like.

  4. 04

    Plugin OAuth — 필요 시

    ms-graph (MSAL) / lge-api (EP SSO) 는 plugin install 후 첫 사용 시 hostApi.openAuthWindow 로 별도 처리.

첫 화면 — 어떤 구성으로 보이나요?

채팅에서 호출 가능한 플러그인 패널 (skills, tools)
에이전트가 사용자에게 되묻는 인터랙티브 질문 카드
로그인 없이도 쓸 수 있는 범위
호스트 채팅과 로컬 plugin (예: Local Indexer 의 사전 인덱싱된 폴더) 은 로그인 없이 동작합니다. 다만 플러그인 신규 설치 · Marketplace 카탈로그 · Agent Hub 보드 sync 는 비활성화됩니다.