운영 중인 MCP 서버에 대한 명확한 답변
표준 MCP 전송 방식은 https://mcp.humandesign.ai/의 루트 엔드포인트를 사용합니다. 계산 권한은 계속 HumanDesign.ai API가 담당합니다.
Human Design MCP란 무엇인가요?
HumanDesign.ai의 공식 원격 에이전트 인터페이스입니다. 호환되는 AI 클라이언트는 OAuth를 통해 멤버십을 반영하는 계정 도구를 사용하거나 API 키를 통해 여섯 가지 계산 및 참조 도구를 사용할 수 있습니다.
별도의 Human Design 계산 엔진인가요?
아니요. MCP, Agent HTTP, REST 및 HumanDesign.ai는 차트 계산을 동일한 공식 서비스에 위임합니다. OAuth와 API 키는 서로 다른 기능을 제공하지만 계산 버전과 할당량 결정은 중앙에서 관리됩니다.
차트 데이터의 신뢰성은 어떻게 보장되나요?
서비스는 계산 전에 출생 정보, 위치, IANA 시간대 및 일광 절약 시간 맥락을 검증하고 버전이 지정된 구조화 결과를 반환합니다. 모호하거나 잘못된 입력은 요금이 부과되기 전에 거부됩니다. 에이전트에는 차트 계산을 근사값으로 추정하지 말도록 안내합니다.
에이전트는 출생 날짜와 시각을 어떤 형식으로 보내야 하나요?
현지 시계 시간으로 보내세요. 출생한 장소의 시계에 표시된 그대로 입력하고 Z나 UTC 오프셋은 붙이지 말고, timezone에 IANA 식별자로 시간대를 별도로 지정합니다. "birthDateTime": "1990-05-15T14:30:00"에 "timezone": "America/New_York"를 지정하면 뉴욕 현지 시각으로 오후 2시 30분이라는 뜻입니다. Z 또는 오프셋이 포함된 값만으로는 현지 시계 시간을 알 수 없으며, 이를 어떤 시간대로 해석하느냐에 따라 차트가 달라집니다. 출생 시각을 UTC로 변환한 뒤 보내지 마세요.
클라이언트가 Z 또는 UTC 오프셋을 보냅니다. 문제가 생기나요?
아직은 아닙니다. MCP는 해당 값을 전달하고 API는 이를 UTC로 해석해 당분간 계속 허용하며 응답에서 사용 중단 예정임을 알립니다. 해당 값은 추후 허용되지 않을 예정이며 적용일은 미리 공지됩니다. 오프셋 없는 현지 시계 시간과 IANA 시간대를 함께 보내는 것이 안전한 변경 방법입니다. 값이 실제로 UTC를 뜻하지 않았다면 이 변경으로 차트도 바로잡을 수 있습니다.
계산 도구는 몇 개인가요?
여섯 가지입니다: resolve_timezone, generate_chart, generate_composite_chart, get_reference_item, get_transits, search_celebrities. OAuth는 멤버십, 소유권, 역할, 서버에서 산출한 기능 권한 및 이용 자격에 따라 별도로 필터링되는 계정 도구 목록을 추가로 제공합니다.
어떤 클라이언트로 연결할 수 있나요?
Streamable HTTP MCP와 호환되는 클라이언트라면 무엇이든 연결할 수 있습니다. 문서에는 Claude, ChatGPT, Codex, Cursor 및 VS Code 설정 안내가 있습니다.
계산 할당량을 사용하는 것은 무엇인가요?
generate_chart, generate_composite_chart 및 get_transits는 검증된 요청이 계산 단계에 도달하면 각각 1단위를 사용합니다. resolve_timezone, get_reference_item, search_celebrities, initialize, ping, tools/list, 잘못된 입력, 거부된 접근, 라이브러리 조회, 상태 확인 및 기존 차트 렌더링은 할당량을 사용하지 않습니다.
안전한 계산 재시도는 어떻게 작동하나요?
할당량을 사용하는 세 가지 MCP 도구에는 안정적인 idempotencyKey가 필요합니다. 한 번의 의도된 재시도에서는 정규화된 인수가 동일할 때만 같은 키를 다시 사용하세요. 일치하면 할당량을 추가로 사용하지 않으며 결정적으로 다시 계산될 수 있습니다. 저장된 응답을 바이트 단위로 그대로 재생하는 방식은 아닙니다. MCP 트랜짓 호출에는 명시적인 날짜도 필요합니다.
HumanDesign.ai 무료 회원도 차트를 만들 수 있나요?
네. OAuth를 통해 무료 회원은 자신의 기본 차트를 미리 보고, 확인하고, 만들고, 저장하고, 조회하고 렌더링할 수 있습니다. 새 계산에는 정확히 1단위가 사용되며 렌더링에는 추가 요금이 없습니다.
합성 차트도 만들 수 있나요?
API 키 계산 인터페이스를 통해 두 사람의 새로운 합성 차트를 생성할 수 있습니다. 자격을 갖춘 OAuth 계정은 승인된 저장 합성 차트를 가져와 렌더링할 수 있습니다. 서버는 소유권과 멤버십 경계를 항상 적용합니다.
이미지를 인라인으로 표시할 수 없으면 어떻게 되나요?
서버는 성공을 알리기 전에 PNG 또는 SVG를 검증하며, 대체 수단으로 짧은 만료 시간의 보안 다운로드 링크도 반환합니다.
접근 권한과 결제는 어디에서 관리하나요?
플랫폼 멤버십과 계정 접근은 HumanDesign.ai에 로그인해 관리하세요. API 키, API 요금제 사용량 및 결제는 my.humandesign.ai에서 관리할 수 있습니다.
계정 관련 도움이 필요하신가요? 다음을 방문하세요. my.humandesign.ai.