자주 묻는 질문

CLI 설치 주소가 바뀌었나요?

네. 현재 공개 설치 스크립트 기준 도메인은 https://cli.axhub.ai예요.

curl -fsSL https://cli.axhub.ai/install.sh | bash

설치 뒤 전역 옵션 · 출력 형식은 CLI 레퍼런스에서 확인할 수 있어요.

MCP 툴은 어디 있나요?

AxHub MCP 서버(https://mcp.axhub.ai/mcp)에 있어요. Claude Code 같은 MCP 클라이언트를 연결하면 앱 · 배포 조회, 앱 DB · 커넥터 읽기, SDK 지식 검색 같은 읽기 중심 기본 툴 20개를 쓸 수 있고, 서버의 deploy-write 게이트가 켜져 있으면 앱 생성 · 배포 트리거 같은 운영 변경 툴 21개가 추가돼 총 41개가 돼요. 연결 절차는 AI 도구 연결하기를 보세요.

배포 방식은 무엇을 지원하나요?

배포 방법은 axhub.yaml(manifest) → Dockerfile → Compose 파일 → Railpack 자동 감지 순서로 정해져요. 앱의 deploy_method는 docker | compose | static 세 가지이고 앱 생성 후에는 바꿀 수 없어요 — manifest의 값이 앱에 기록된 값과 다르면 배포가 실패해요. 전체 스키마는 axhub.yaml 레퍼런스에 있어요.

내 앱에서 로그인한 사용자는 어떻게 읽나요?

앱 앞의 게이트가 전달하는 X-AxHub-* 헤더를 서버에서 읽으면 돼요. email/name은 base64로 인코딩돼 있어요. 언어별 예제는 SSO 사용자 정보 읽기에 있어요.

PAT와 OAuth는 어떻게 나뉘나요?

PAT(AXHUB_API_KEY)는 SDK 호출 · CI처럼 허용된 표면에서 사용해요. 앱 생성, 배포, GitHub 연결, 테넌트 · 멤버 · 관리자 작업은 OAuth 기기 로그인(device flow)을 사용하세요. 로그인 명령은 CLI — 인증에 있어요.