HumanDesign.aiMCP앱 열기 ↗
AI용문서
인증

계정에는 OAuth, 계산에는 API 키 사용

Human Design MCP는 권한 범위가 서로 다른 두 가지 자격 증명 유형을 지원합니다. 비공개 HumanDesign.ai 계정 도구에는 OAuth를, 기존 계산 및 참조 기능에는 API 키를 선택하세요.

HumanDesign.ai OAuth

  1. 추가 https://mcp.humandesign.ai/ 정적 인증 헤더 없이 원격 Streamable HTTP MCP 서버로 설정하세요.
  2. 클라이언트의 인증, 연결, /mcp또는 MCP 로그인 작업을 사용하세요.
  3. 브랜드가 표시된 HumanDesign.ai 페이지에 로그인한 다음 선택한 계정 경계와 사용 가능한 기능을 검토하세요.
  4. 멤버십, 워크스페이스 역할, 이용 자격 또는 인증 정보가 변경된 후 다시 연결하세요.

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계산 할당량 또는 안전 속도 제한에 도달함사용량을 확인하고 빠르게 반복해서 재시도하지 마세요.
맨 위로 ↑도움이 필요하신가요? 지원팀에 문의 ↗

다음 답을 찾아보세요.