/cc-inspector:auth — 로그인 상태 점검기

한마디로#

실행 중인 앱이 "지금 로그인이 제대로 되어 있는지, 출입증(토큰)이 살아 있는지"를 실시간으로 들여다보는 점검 도구입니다. 건물 출입 게이트에서 방문증이 유효한지, 언제 만료되는지 확인해 주는 안내 데스크라고 보면 됩니다.

• 로그인이 안 되거나 자꾸 풀릴 때
• "401 권한 없음" 같은 인증 오류가 날 때
• 토큰(출입증)이 만료됐는지, 사용자 권한이 충분한지 확인하고 싶을 때

주로 개발자나 AI 에이전트가 앱 동작 중에 인증 관련 문제를 진단할 때 사용합니다.

무엇을 해주나요#

실행 중인 앱에 직접 물어봐서 두 가지 정보를 알려 줍니다.

• 인증 상태(auth_get_status) — 로그인 여부, 로그인 방식, 그리고 access/refresh 토큰이 살아 있는지·언제 만료되는지
• 사용자 정보(auth_get_user) — 현재 로그인한 사용자의 ID, 이메일, 이름, 권한(roles)

어떻게 쓰나요#

/inspector/auth status
/inspector/auth user
/inspector/auth token

• status — 지금 로그인되어 있는지 전체 인증 상태를 확인합니다.
• user — 현재 로그인한 사용자가 누구인지(권한 포함) 확인합니다.
• token — 출입증(토큰)이 언제 만료되는지 등 토큰 상태를 자세히 확인합니다.

문제 유형별로 정해진 순서대로 원인을 좁혀 갑니다.

• 로그인이 안 될 때 — 인증 상태를 확인하고, 토큰 상태를 본 뒤, 로그인 흐름을 점검합니다.
• 401 권한 오류 — 토큰이 만료됐는지, refresh 토큰은 살아 있는지 보고, 토큰 갱신 로직을 점검합니다.
• 권한 부족 오류 — 사용자의 권한(roles)을 확인해 필요한 권한과 비교하고, 권한 체크 로직을 점검합니다.
• 자동 로그아웃 — 토큰 만료 시점과 세션 타임아웃 설정을 확인하고, 토큰 갱신 타이밍을 점검합니다.

{
  "isAuthenticated": true,
  "authMethod": "email",
  "tokenStatus": {
    "accessToken": {
      "exists": true,
      "expiresAt": "2024-01-01T12:00:00Z",
      "isExpired": false,
      "expiresIn": "45 minutes"
    },
    "refreshToken": {
      "exists": true,
      "expiresAt": "2024-01-08T10:00:00Z",
      "isExpired": false
    }
  }
}

{
  "user": {
    "id": 123,
    "email": "user@example.com",
    "name": "Hong Gildong",
    "roles": ["user", "premium"],
    "createdAt": "2023-06-15T10:00:00Z"
  }
}

1. auth_get_status -> Check authentication status
2. Verify tokenStatus
3. Review login flow

1. auth_get_status -> Check token expiration
2. Check refreshToken status
3. Review token renewal logic

1. auth_get_user -> Check user roles
2. Compare with required permissions
3. Review permission check logic

1. auth_get_status -> Check token expiration time
2. Check session timeout settings
3. Review token renewal timing

/inspector/auth status

/inspector/auth user

/inspector/auth token