시작하기
로그인과 인증
원격 MCP 와 CLI 는 웹과 같은 계정·같은 로그인을 씁니다.
비밀번호는 브라우저에만 입력하고, 에이전트나 터미널에는 승인으로 받은 접근 권한만 남습니다.
원격 MCP 로그인
설치 없이 연결하는 원격 MCP(https://aimzlabs.com/mcp)는 표준 OAuth 로 로그인합니다.
- AI 서비스에 주소를 등록하고 연결(Authenticate)을 누르면 브라우저에 에임즈 연결 화면이 열립니다.
- 에임즈에 로그인돼 있지 않으면 화면의 링크로 aimzlabs.com 에 평소처럼 로그인한 뒤, 연결 화면을 새로고침합니다.
- 연결할 서비스와 계정을 확인하고 연결 허용을 누릅니다. 크레딧 자동 사용은 따로 체크하는 선택 동의입니다.
- AI 서비스는 비밀번호가 아니라 이 연결에 묶인 접근 권한만 받습니다.
연결은 각 서비스에서 끊거나 에임즈 연결 관리에서 철회할 수 있습니다.
로그인이 풀리면 AI 서비스의 MCP 설정에서 다시 연결합니다.
CLI 브라우저 로그인 (선택)
내 PC 에 CLI 를 설치해 쓰는 경우에만 필요합니다.
aimz loginaimz가 이 PC 에서만 접속되는 임시 주소(http://127.0.0.1:<임의 포트>/callback)를 열고 브라우저로 로그인 창을 엽니다.- aimzlabs.com 에서 로그인하면 2분 동안만 쓸 수 있는 일회용 코드가 그 임시 주소로 전달됩니다.
aimz가 코드와 자기만 아는 검증값을 서버에 보내 로그인 세션을 받습니다. 코드는 한 번 쓰면 사라집니다.
코드가 유출되더라도, 로그인을 시작한 그 터미널의 검증값이 없으면 세션을 받을 수 없습니다(PKCE). 데스크톱 앱 로그인과 같은 방식입니다.
aimz login 을 실행한 게 아니라면 승인하지 마세요. CLI 에 로그인하면 그 터미널과 연결된 AI 에이전트가 이 계정으로 생성하고 크레딧을 쓸 수 있습니다.브라우저가 없는 곳 (SSH·서버)
aimz login --no-browser출력된 주소를 아무 기기(휴대폰 포함)의 브라우저에서 열어 로그인하면, 화면에 코드가 나타납니다. 코드를 복사해 터미널에 붙여 넣으세요. 코드는 2분 동안, 로그인을 시작한 그 터미널에서만 쓸 수 있습니다.
토큰 저장 위치
| 환경 | 저장 위치 |
|---|---|
| Windows | Windows 자격 증명 관리자 (서비스 이름 aimz-labs-cli) |
| macOS | 키체인 (서비스 이름 aimz-labs-cli) |
| Linux 데스크톱 | Secret Service (GNOME Keyring 등) |
| 그 밖(헤드리스 서버 등) | ~/.aimz/credentials.json — 본인만 읽을 수 있게 저장 |
토큰은 명령줄 인수·환경 변수·로그에 남기지 않습니다. 설정 폴더 위치는 환경 변수 AIMZ_HOME 으로 바꿀 수 있습니다.
세션 유지와 만료
- 세션은 웹과 같이 30일이며, 쓰는 동안 자동으로 연장됩니다.
- 비밀번호를 바꾸거나 계정이 비활성화되면 이 CLI 를 포함한 모든 기기에서 즉시 로그아웃됩니다.
- 세션이 끝나면 명령이 종료 코드
4와 함께 “로그인 필요”를 알립니다.aimz login을 다시 실행하세요.
로그아웃
aimz logout이 PC 에 저장된 토큰과 크레딧 사용 동의 기록을 지웁니다.
aimz logout 은 이 PC 의 사본만 지웁니다.서버 주소
기본은 https://aimzlabs.com 입니다. 다른 서버를 쓰려면 --server 또는 환경 변수 AIMZ_SERVER 로 지정합니다. 로그인할 때 --server 를 주면 그 주소가 기본값으로 기억됩니다.
aimz login --server https://aimzlabs.com$env:AIMZ_SERVER = "http://127.0.0.1:8000"; aimz whoami # 내 PC 의 개발 서버http 주소 제한
암호화되지 않은 http:// 는 내 PC 주소(127.0.0.1·localhost)만 허용합니다. 세션 토큰이 네트워크에 평문으로 흐르지 않게 하기 위해서입니다.
에이전트와 로그인
원격 MCP 는 위의 연결 승인으로 동작합니다.
내 PC 의 MCP 서버(aimz mcp)는 사용자가 터미널에서 해 둔 로그인을 그대로 씁니다. 에이전트는 비밀번호를 보거나 입력하지 않습니다. 로그인이 없으면 에이전트가 “터미널에서 aimz login 을 실행해 달라”고 안내합니다. 다른 터미널에서 로그인·로그아웃하면 MCP 서버를 다시 켜지 않아도 바로 반영됩니다.