CLI 인증

토큰을 환경변수나 파일로 설정합니다.

토큰 발급

CLI는 개인 키(mzpt_로 시작)로 인증합니다. 캐릭터챗 저작은 팀 전용이라, 팀 구성원의 계정에서 캐릭터챗 저작 기능을 허용해 만든 키여야 합니다. 설정의 AI 도구 연결 화면(/settings/connections)에서 만들며, 키는 만든 직후 한 번만 보입니다. 자세한 내용은 로그인과 키를 보세요.

토큰 두는 법

방법은 둘 중 하나입니다. 환경변수가 있으면 환경변수를 먼저 씁니다.
export MELLOWZ_STUDIO_URL="<서버 주소>"
export MELLOWZ_STUDIO_TOKEN="<연결 화면에서 만든 키>"
토큰 파일은 소유자만 읽고 쓸 수 있어야 합니다. 그룹이나 다른 사용자가 읽을 수 있는 권한이면 CLI가 거부하고 chmod 600을 안내합니다. 서버 주소(MELLOWZ_STUDIO_URL)는 어느 방법에서든 환경변수로 줍니다.

확인

환경 점검 (네트워크 호출 없음) — bash
pnpm --filter @mellowz-studio/cli start -- doctor
주소와 토큰이 모두 있어야 통과합니다. 토큰은 mzpt_로 시작하는 개인 키여야 하고, 아니면 FAIL로 나옵니다. 빠진 것이 있으면 종료 코드 6으로 끝납니다.
주의
토큰을 명령 인자로 넘기지 마세요. --token 같은 옵션이나 mzpt_ 값이 인자에 있으면 셸 기록에 남기 때문에 CLI가 실행 자체를 거부합니다.
로그인 명령은 없습니다. 키 폐기는 연결 화면에서 합니다.

관련