인증
계정에는 OAuth, 계산에는 API 키 사용
Human Design MCP는 권한 범위가 서로 다른 두 가지 자격 증명 유형을 지원합니다. 비공개 HumanDesign.ai 계정 도구에는 OAuth를, 기존 계산 및 참조 기능에는 API 키를 선택하세요.
HumanDesign.ai OAuth
- 추가
https://mcp.humandesign.ai/정적 인증 헤더 없이 원격 Streamable HTTP MCP 서버로 설정하세요. - 클라이언트의 인증, 연결,
/mcp또는 MCP 로그인 작업을 사용하세요. - 브랜드가 표시된 HumanDesign.ai 페이지에 로그인한 다음 선택한 계정 경계와 사용 가능한 기능을 검토하세요.
- 멤버십, 워크스페이스 역할, 이용 자격 또는 인증 정보가 변경된 후 다시 연결하세요.
OAuth 접근 권한은 항상 멤버십과 소유권에 따라 제한됩니다. Free 및 Individual 계정은 자체 기본 차트를 만들고, 저장하고, 조회하고 렌더링할 수 있습니다. Individual에는 계정 사용량 확인도 포함됩니다. 다른 사람의 승인된 차트와 더 폭넓은 플랫폼 기능을 사용하려면 Personal 또는 Pro가 필요합니다.
API 키 계산 접근
Bearer API 키와 X-Api-Key 는 여섯 가지 계산 및 참조 도구에서 계속 지원됩니다. 계정, 라이브러리, 보고서 또는 빌더 데이터에는 접근할 수 없습니다.
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEY자격 증명 보안
- OAuth 토큰은 MCP 클라이언트와 인증 서비스에서 처리합니다. 프롬프트나 소스 파일에 붙여넣지 마세요.
- API 키는 환경 변수 또는 보호된 비밀 저장소에 보관하세요.
- 인증 헤더, 새로 고침 토큰, API 키, 서명된 에셋 URL 또는 구조화된 비공개 차트 결과를 로그에 기록하지 마세요.
- 위임된 접근 권한을 철회하려면 커넥터 연결을 끊거나 MCP 인증 정보를 삭제하세요.
- API 키와 계산 요금제 사용량은 다음에서 관리하세요. my.humandesign.ai.
인증 오류
| 코드 | 의미 | 조치 |
|---|---|---|
401 | 자격 증명이 없거나 형식이 잘못되었거나 만료 또는 철회됨 | 클라이언트의 OAuth 로그인을 다시 진행하거나 보호된 API 키 설정을 복구하세요. |
403 | 출처, 기능 권한, 멤버십, 역할, 소유권 또는 이용 자격이 거부됨 | 계정 경계를 확인하세요. 승인된 접근 변경 후 다시 연결하세요. |
429 | 계산 할당량 또는 안전 속도 제한에 도달함 | 사용량을 확인하고 빠르게 반복해서 재시도하지 마세요. |