Hub

앙스키 허브는 검증된 클라우드 에이전트, 지침형 스킬, 공식 MCP capability를 웹에서 탐색하고 모바일 앱에 등록하는 기능입니다.

사용자 흐름

1. 웹 /hub에서 항목을 검색하고 상세 권한과 포함 내용을 확인합니다.
2. 리옵트 계정으로 로그인한 뒤 등록 QR을 만듭니다.
3. 같은 계정으로 연결된 앙스키 모바일 앱에서 QR을 스캔합니다.
4. 앱에서 버전, 의존성, 권한을 검토하고 등록합니다.
5. 에이전트 번들은 새 Cloud 에이전트로 열리고, 개별 스킬과 MCP는 허브 보관함과 에이전트 편집 화면에서 사용할 수 있습니다.

QR claim은 5분 동안만 유효하며 발급한 웹 계정과 모바일 Bearer 계정이 같아야 합니다. QR에는 모바일 인증 토큰, 시스템 프롬프트 또는 MCP 인증 정보가 포함되지 않습니다.

v1 지원 범위

• 앙스키가 코드 리뷰로 관리하는 공식 무료 카탈로그
• 앙스키 클라우드 에이전트 번들
• 실행 코드가 아닌 검증된 지침 모듈 형태의 Cloud 스킬
• web, memory처럼 Cloud 런타임에 이미 구현된 공식 MCP capability
• 중복 스캔과 네트워크 재시도에 안전한 멱등 등록

임의 stdio 명령, 사용자 제공 MCP URL, 결제·정산과 daemon 설치는 아직 지원하지 않습니다. 외부 제작자 제출은 인증 사용자에게 열려 있습니다(/api/hub/publisher/submissions).

운영 설정

프로덕션은 HUB_CLAIM_SECRET에 32바이트 이상의 무작위 값을 설정하는 것을 권장합니다. 값이 없으면 ENCRYPTION_KEY를 사용합니다.

긴급 중단이 필요하면 ANGSKI_HUB_ENABLED=false로 웹 페이지와 등록 API를 함께 차단할 수 있습니다. 기본값은 활성화입니다.

카탈로그의 minAppVersion보다 오래된 모바일 앱은 상세 내용을 미리 볼 수 있지만 등록할 수 없습니다. 앱과 웹 배포 순서는 하위 호환되는 스키마 배포 → 웹 배포 → 모바일 배포 순서를 권장합니다.

서버 로그는 [hub] 접두어와 함께 claim_created, install_started, install_succeeded, install_failed 이벤트를 기록합니다. 사용자 ID는 해시된 참조로 기록하며 claim과 인증 토큰은 기록하지 않습니다.