새 워크스페이스 역할이 아니라 기능 사용을 승인합니다
OAuth를 사용하면 Claude, Codex 또는 ChatGPT가 로그인한 HumanDesign.ai 사용자로 작업할 수 있습니다. 새로운 접근 권한을 만들거나 멤버십을 변경하거나 에이전트에 워크스페이스 소유권을 부여하지 않습니다.
워크스페이스 선택의 의미
유료 계정에는 개인 라이브러리와 하나 이상의 팀 또는 비즈니스 워크스페이스가 있을 수 있으므로 동의 화면에서 “Claude가 어느 곳에서 작업할까요?”라고 묻습니다. 이 선택은 데이터 경계를 정하며 추가 멤버십 권한을 부여하지 않습니다. 모든 호출은 계속 사용자의 멤버십, 역할, 기능 권한, 소유권 및 제품 이용 자격을 확인합니다. 빌더 사용을 승인하면 해당 경계 내에서 자격이 있는 프로젝트에 적용되므로 프로젝트마다 별도의 OAuth 권한을 부여할 필요가 없습니다.
Free 및 Individual 계정: 워크스페이스 선택기가 표시되지 않습니다. 연결은 개인 계정 경계와 사용자의 기본 차트로 제한되며, Individual에는 계정 사용량도 포함됩니다. 다른 사람의 차트와 더 폭넓은 플랫폼 도구를 사용하려면 Personal 또는 Pro가 필요합니다.
동의 범위를 명확히 하기 위해 Personal 및 Pro에는 서로 겹치는 “내 차트”와 “라이브러리” 체크박스 대신 하나로 통합된 차트 및 라이브러리 권한이 표시됩니다. Personal 경계에서는 기본 차트와 허용된 라이브러리를 포함하고, 선택한 워크스페이스에서는 해당 워크스페이스에서 허용된 차트와 합성 차트로 범위가 제한됩니다.
ID 범위 및 기능 권한
OAuth 프로토콜은 다음과 같은 ID 및 세션 범위만 요청합니다. email, profile 및 offline_access. 로그인 후 HumanDesign.ai는 선택한 계정 경계, 멤버십, 역할, 소유권 및 이용 자격을 바탕으로 다음 내부 기능 권한을 산출합니다. 이 권한은 적용을 위한 레이블이며, 클라이언트가 멤버십을 우회하려고 요청할 수 있는 추가 OAuth 범위가 아닙니다.
| 기능 권한 | 허용되는 작업 |
|---|---|
charts:read | 승인된 차트 기록 조회 |
charts:generate | 미리 보기 및 확인 후 연결된 사용자의 기본 차트 생성 |
library:read | 허용된 라이브러리 항목 검색 및 조회 |
library:organize | 폴더 및 항목 배치 관리 |
reports:read | 템플릿, 보고서 및 생성 상태 조회 |
builder:read | 이용 자격이 있는 빌더 프로젝트 및 실행 내역 조회 |
builder:write | 권한이 있는 경우 진행 중인 빌더 실행 취소 |
account:usage | 잔액, 할당량 및 요약 사용량 조회 |
에이전트에 표시되는 항목
tools/list 은 인증된 사용자의 현재 기능 권한, 멤버십, 워크스페이스 역할, 소유권 및 이용 자격에 따라 필터링됩니다. 요금제 업그레이드 및 다운그레이드, 역할 변경 및 권한 철회는 다시 연결하거나 토큰을 새로 고친 뒤 적용됩니다. 작업 상태 조회와 취소 시에도 원래 작업을 승인한 권한을 다시 확인하므로, 권한을 제거하면 이전 작업 도구를 통해 기존 작업에 계속 접근할 수 없습니다.
확인 및 외부 영향
도구에 미리 보기 또는 확인 단계가 표시되면 확인은 실행자, 경계, 작업, 인수, 대상, 최대 요금 및 만료 시간에 연결됩니다. 이 중 어느 하나라도 바뀌면 확인은 무효가 됩니다. 기본 차트 생성에는 1단위 미리 보기와 확인이 필요하며 라이브러리 폴더 삭제도 확인을 거칩니다. 작업과 빌더 실행 취소는 현재 상태에서 취소할 수 있는 경우에만 바로 실행됩니다. 위험도가 더 높은 게시 및 전달 작업은 이번 릴리스에서 제공되지 않습니다.
접근 권한 철회
클라이언트의 커넥터 설정에서 HumanDesign.ai 연결을 끊거나 MCP 인증 정보를 삭제하세요. 권한을 철회하면 위임된 연결이 종료되지만 HumanDesign.ai 데이터가 삭제되거나 멤버십이 변경되지는 않습니다.