권한·승인·한도
나두바이오에서 권한·승인·사용 한도 때문에 막혔을 때 사용한다.
스킬 버전: 1.0.0. 자료: skill://nadoobio-account-and-approval/SKILL.md.
고객 자료 조회 전에 get_connection_context로 연결 계정·조직·스코프를 확인한다. 공개 목록 조회는 인증 증거가 아니다. legacyUnscoped는 구형 역할 권한이며, 이 조회는 프로젝트 접근이나 실행을 승인하지 않는다. 웹 링크는 브라우저의 현재 계정으로 재인가한다. 다른 계정·조직이면 웹에서 전환하고 같은 주소를 다시 연다.
| 오류 | 뜻 | 사용자에게 |
|---|---|---|
authentication_required | 유효한 인증이 확인되지 않았다 | 나두바이오에서 API 키를 발급해 설정하도록 안내한다. |
scope_required (required) | 키에 그 작업 스코프가 없다 | 필요한 스코프(catalog:read, jobs:read, plans:write, jobs:submit, files:write)를 알린다. |
agent_execution_disabled | 이 서비스에서 AI 에이전트(API 키)의 계획 생성·제출이 꺼져 있다(플랫폼 관리자 설정). 키나 프로젝트 권한 문제가 아니다 | 같은 요청을 반복하지 않는다. 연구자가 화면에서 직접 계획을 만들거나, 플랫폼 관리자에게 "AI 에이전트 실행 허용"을 요청하도록 안내한다. 조회 도구는 계속 쓴다. |
not_found / plan_unavailable | 없거나 볼 권한이 없다 | 둘을 구분하지 않는 것이 정상이다. 식별자와 프로젝트를 확인하게 한다. 다른 식별자를 추측해 시도하지 않는다. |
plan_not_approved | 사람 승인이 없거나 만료됐다 | 승인 링크를 전달한다. 응답의 승인 정책을 확인한다. API 키 단건 계획의 승인 대기는 만료되지 않지만 승인 뒤15분 안에 명시적으로 제출해야 한다. 승인만으로 에이전트가 재개되거나 작업이 제출되지 않는다. |
| 실행 옵션에 원하는 도구가 없음 | 원인은 목록 부재만으로 알 수 없다 | reason·reasonText·workflowSupport와 supportDocPath의 문서를 확인하고, 지금 할 수 있는 입력 준비·검증으로 안내한다. |
runtime_consumer_unavailable | 플랫폼에 해당 실행기가 없다(fixableBy: platform) | 권한이나 키 문제가 아니라고 전하고, 입력 준비·검증을 다음 단계로 안내한다. |
release_unavailable | 이 조직에 게시 릴리스가 없다(fixableBy: organization-operator). 조직 단위라 같은 조직의 프로젝트는 모두 같다 | reasonText를 그대로 전하고, 다음 단계는 두 가지로 안내한다: 입력 준비·검증, 그리고 조직 운영 관리 권한자에게 릴리스 게시 요청. |
session_submission_required | 현재 웹 세션에서 작성한 계획만 제출 가능 | 이 사유가 실제 반환된 경우에만 웹의 새 계획 작성 경로를 안내한다. API 키 계획 승인·스코프 추가로 해결되지 않는다. |
monthly_limit_exceeded | 월 작업 건수 한도 소진 | used·limit·remaining과 응답의 recoveryBoundary.submissionDeadline(이 계획의 제출 기한)을 알리고 멈춘다. 금액 과금이 아니라 작업 건수 한도다. 한도 회복 시점은 확인되지 않는다. 기한이 지나면 이 계획은 제출할 수 없으므로 rerun_plan으로 새 계획과 새 승인이 필요하다. 이 계획은 제출 기한 안에 한도가 조정될 때만 제출할 수 있다고 안내하고, 남은 시간을 계산하지 말고 기한 시각을 그대로 전한다. |
context_changed | 선택한 조직이 바뀌었다 | 제품 화면에서 원래 조직으로 돌아오게 한다. |
지키는 것
- 승인·권한 제약은 받은 사유를 그대로 사용자에게 알리고, 같은 키·같은 프로젝트·사용자 본인의 계획으로 진행한다.
- API 키, 쿠키, 토큰을 대화나 파일에 적지 않는다.
- 제품 링크(
create_view_link)는 권한을 다시 확인한 뒤 만들어진다. 다운로드 자격 URL을 만들거나 요구하지 않는다.
후보 입력 링크와 현재 권한
list_candidate_inputs는 jobs:read로 본인 기록을 읽으며 준비·계획 저장 권한을 부여하지 않는다. 반환된 목록/개별 링크는 로그인 후 같은 주소로 돌아오고 브라우저의 현재 계정·조직·프로젝트 권한을 다시 검사한다. API 키 인증과 웹 로그인은 별개이며 키·쿠키를 URL에 넣지 않는다.
개별 링크의 snapshotId·payloadHash를 보존한다. 해시 충돌이나 권한 오류에서 해시를 지우거나 최신 입력 링크로 바꾸지 않는다. sourceStatus=unavailable은 해당 기록의 현재 출처를 사용할 수 없는 상태이므로 단순 재로그인으로 해결된다고 약속하지 않는다. 후보 입력의 web-session-required는 웹에서 준비 계획을 저장하라는 경계이며, 준비 계획의 제출 차단은 API 키 재발급이나 승인으로 해결되지 않는다.
유료 위임의 로그인과 키
위임 문서의 웹 링크는 브라우저 로그인으로 검토하며, MCP 제출은 문서에 지정된 API 키로 수행한다. 웹 로그인 성공이 API 키 설정이나 원 승인 세션 복구를 뜻하지 않는다. 다른 세션에서 이력을 볼 수 있어도 새 위임 동의·제출 요청 생성은 허용되지 않을 수 있다. 원 승인 세션의 만료·철회나 context 변경은 재로그인만으로 복구된다고 약속하지 않는다.
submit_delegated_plan의 접수 영수증을 받은 뒤 get_job이 scope_required를 반환하면 jobs:read 부족과 접수 실패를 구분한다. 원 접수·요청 키를 보존하고 반환된 작업 링크로 안내한다. 키를 교체해 위임을 재사용하지 않는다. agent_delegation_runtime_not_connected는 해당 모델의 위임 실행 연결이 없다는 뜻이며 스코프 추가·재로그인으로 해결되지 않는다.