자주 묻는 질문
최신 CLI/backend/plugin 기준으로 정리한 AXHub FAQ
apphub.yaml을 계속 써도 되나요?
마이그레이션 기간에는 backend와 CLI가 legacy apphub.yaml을 읽을 수 있지만, canonical 파일명은 axhub.yaml이에요. 둘 다 있으면 axhub.yaml이 우선돼요. 새 문서와 새 프로젝트는 모두 axhub.yaml을 사용하세요.
CLI 설치 주소가 바뀌었나요?
네. 현재 공개 installer 기준 도메인은 https://cli.axhub.ai예요.
curl -fsSL https://cli.axhub.ai/install.sh | bashMCP tools는 어디 있나요?
AxHub MCP 서버(https://mcp.axhub.ai/mcp)에 있어요. Claude Code 같은 MCP 클라이언트를 연결하면 데이터 카탈로그를 둘러보고 읽기 전용 SQL로 조회하는 툴 5개를 쓸 수 있어요. 자세히는 AxHub MCP를 보세요.
배포 방식은 무엇을 지원하나요?
현재 resolver는 axhub.yaml, Dockerfile, Compose 파일, Railpack 자동 감지를 지원해요. 앱의 DB deploy_method는 docker | compose이고 생성 후 immutable이에요.
사용자 앱에서 로그인 사용자는 어떻게 읽나요?
ingress gate가 전달하는 X-AxHub-* 헤더를 읽어요. email/name은 base64 인코딩돼요. 예전 X-AppHub-* 헤더명은 최신 backend 기준이 아니에요.
PAT와 OAuth는 어떻게 나뉘나요?
PAT(AXHUB_API_KEY)는 /data/*, table DDL, PAT 관리처럼 허용된 surface에 사용해요. 앱 생성, 배포, GitHub 연결, tenant/member/admin 작업은 OAuth device flow를 사용하세요.