HumanDesign.aiMCP앱 열기 ↗
AI용문서
계정 연결 MCP

에이전트에서 HumanDesign.ai를 사용하세요

OAuth는 MCP를 사용자의 HumanDesign.ai 계정에 연결합니다. 서버는 상태를 저장하지 않으며 HumanDesign.ai가 계속해서 ID, 멤버십, 워크스페이스 역할, 소유권, 이용 자격, 사용량 및 확인 절차를 적용합니다.

두 가지 접근 방식: OAuth는 계정 연결 플랫폼 도구에 사용합니다. 기존 6가지 계산 및 참조 도구에는 API 키를 계속 사용할 수 있습니다. API 키로는 비공개 계정 데이터에 접근할 수 없습니다.

멤버십별 접근 범위

무료

본인의 기본 차트

  • 1단위 미리 보기 및 확인 후 기본 차트 생성 및 저장
  • 기본 차트를 PNG 또는 SVG로 조회하고 렌더링

포함되지 않는 항목: 다른 승인된 사용자와 관련된 합성 차트 작업, 다른 사람의 차트, 더 폭넓은 라이브러리 및 보고서.

Individual

본인의 기본 차트 및 계정 사용량

  • Free에서 제공되는 본인 차트 기능
  • 계정 사용량, 계산 할당량, AI 크레딧 잔액 및 예약 내역 확인

포함되지 않는 항목: 다른 승인된 사용자와 관련된 합성 차트 작업, 다른 사람의 차트, 더 폭넓은 라이브러리 및 보고서.

Personal

계정 및 허용된 라이브러리

  • 접근이 허용된 다른 저장 차트와 합성 차트 조회
  • 라이브러리 검색 및 정리
  • 보고서 템플릿 및 보고서 상태 조회
  • 계정 사용량 확인

포함되지 않는 항목: 자격이 있는 전문 워크스페이스, 계정·소유권·명시적 이용 자격 범위를 벗어나는 모든 항목.

Pro

계정, 라이브러리 및 이용 자격이 있는 워크스페이스

  • 개인 기능
  • 이용 자격이 있는 전문 워크스페이스
  • HumanDesign.ai가 계정에 빌더를 활성화하고 tools/list에 해당 도구가 표시된 경우에만 웹사이트 빌더 도구를 사용할 수 있습니다.

포함되지 않는 항목: 계정, 워크스페이스 역할, 소유권 또는 명시적 이용 자격 범위 밖의 모든 항목.

사용 가능한 계정 연결 도구

계정 정보 Free, Individual, Personal 또는 Pro

읽기 전용이며 무료입니다. 활성 계정 경계, 멤버십, 역할, 기본 차트 ID, 이용 자격 및 사용 가능한 기능을 반환합니다.

account_get_context

사용량 Individual, Personal 또는 Pro

읽기 전용이며 무료입니다. 결제 세부 정보는 노출하지 않고 안전한 할당량, 크레딧, 예약 및 최근 사용량 요약을 반환합니다.

account_get_usage

본인 차트 이미지 Free, Individual, Personal 또는 Pro

“내 차트”라고 하면 이름 검색 없이 계정의 기본 차트를 확인하는 chart_get_primary를 사용하세요. 기본 차트가 없으면 chart_generate가 미리 보기를 검증한 다음 확인 후 계산 단위 1개를 사용해 생성합니다. 기존의 승인된 차트 렌더링은 무료이며 인라인 PNG 또는 SVG와 짧은 만료 시간의 다운로드 링크를 반환합니다. Free 및 Individual 계정은 기본 차트로 제한됩니다.

chart_get_primary
chart_generate
chart_render

라이브러리 Personal 또는 Pro

조회와 AI를 사용하지 않는 정리 작업은 무료입니다. 폴더 삭제에는 미리 보기와 확인이 필요합니다.

library_search
library_get
library_organize

작업 현재 작업 생성 기능을 승인받은 계정

상태 확인은 무료입니다. 각 호출은 현재 권한을 기준으로 작업을 시작한 기능 권한이 유효한지 다시 확인합니다. 해당 권한이 유지되고 실제 작업을 취소할 수 있는 상태일 때만 취소할 수 있습니다.

operation_get
operation_cancel

보고서 Personal 또는 Pro

현재 릴리스에서는 무료 보고서 검색과 상태 조회를 제공합니다. 지갑 예약 및 확인 수락 테스트가 통과될 때까지 생성, 내보내기, 전달 및 재생성은 단계적으로 제공할 예정입니다.

report_list_templates
report_get

웹사이트 빌더 HumanDesign.ai에서 빌더를 활성화한 계정

현재 컨트롤은 안전한 조회, 미리 보기 가져오기, 취소 가능한 실행의 취소를 지원합니다. 생성, 요금제 변경, 빌드 승인, 복원, 게시 및 도메인 변경은 단계적으로 제공할 예정입니다.

builder_project_list
builder_project_get
builder_plan_get
builder_run_get
builder_run_cancel
builder_preview_get
builder_asset_list

“내 차트” 요청하기

에이전트는 다음을 호출해야 합니다. chart_get_primary 연결된 계정에 연결된 기본 차트를 사용하세요. 라이브러리에서 사용자 이름을 검색하거나 차트 이름이 “Kyle”, “My Chart” 또는 다른 이름일 것이라고 추측해서는 안 됩니다. 기본 차트가 없으면 chart_generate 출생 정보를 검증하고 생성 전에 1단위 미리 보기를 반환합니다. 차트 이미지를 만들려면 chart_render 를 사용해 기본 차트를 직접 지정하면 MCP 이미지와 짧은 만료 시간의 다운로드 링크를 모두 반환합니다.

HumanDesign.ai 멤버십으로 더 많은 기능 이용하기

Free는 본인 차트를 신뢰할 수 있는 환경에서 처음 경험하도록 설계되었습니다. Individual은 본인 차트 접근 범위를 유지하면서 계정 사용량 확인을 추가합니다. Personal은 승인된 다른 차트와 저장된 합성 차트 탐색, 더 폭넓은 라이브러리, 이미 소유한 보고서 및 HumanDesign.ai 커뮤니티 참여를 추가합니다. Pro는 전문 워크스페이스 경험을 제공합니다. 웹사이트 빌더 도구는 HumanDesign.ai가 계정에 빌더를 활성화하고 다음 항목에 표시한 경우에만 사용할 수 있습니다. tools/list 해당 도구를 광고합니다. 적격 트랜짓 기능은 HumanDesign.ai에서 이용할 수 있습니다. MCP의 별도 get_transits 계산 도구에는 Startup 이상 API 키가 필요합니다. 멤버십은 동의, 소유권 또는 워크스페이스 역할 확인을 우회하지 않습니다.

단계적으로 제공할 기능

크레딧 예약, 확인, 재시도 및 실제 클라이언트 수락 테스트가 완료될 때까지 보고서 생성·내보내기·전달과 빌더 생성·승인·게시를 의도적으로 실시간 기능으로 표시하지 않습니다. 위험도가 높은 게시, 도메인, 통신, 금융, 협업자 및 비밀 관리 작업은 앞으로도 안전한 HumanDesign.ai 인계 절차를 사용합니다.

결제 방식

  • 연결, 도구 검색, 라이브러리 조회, 상태 확인 및 기존 차트 렌더링은 무료입니다.
  • 새 차트 계산에는 기존 계산 할당량이 사용됩니다.
  • AI 보고서 및 빌더 작업은 해당 변경 기능이 활성화된 경우에만 기존 통합 AI 크레딧 지갑을 사용합니다.
  • MCP는 크레딧을 직접 차감하지 않습니다. Platform Action Gateway가 사용량을 검증, 예약, 정산, 해제 및 조정합니다.

OAuth 권한 검토 →

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

다음 답을 찾아보세요.