HumanDesign.aiMCP앱 열기 ↗
AI용문서
OAuth 권한

새 워크스페이스 역할이 아니라 기능 사용을 승인합니다

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 데이터가 삭제되거나 멤버십이 변경되지는 않습니다.

OAuth로 연결 →

맨 위로 ↑도움이 필요하신가요? 지원팀에 문의 ↗

다음 답을 찾아보세요.