HumanDesign.aiMCP앱 열기 ↗
AI용문서
빠른 시작

에이전트를 4단계로 연결하세요

Claude, ChatGPT 또는 Codex에서는 OAuth 연결을 권장합니다. 로그인한 사용자가 허용한 HumanDesign.ai 도구를 안전하게 사용할 수 있기 때문입니다.

1. 호스팅 엔드포인트 추가

엔드포인트

https://mcp.humandesign.ai/

원격 HTTP 또는 Streamable HTTP를 선택하세요. 다음을 다시 추가하지 마세요. /mcp 표준 엔드포인트는 도메인 루트입니다.

2. 인증

클라이언트의 MCP 인증 또는 연결 작업을 사용하고 HumanDesign.ai 브라우저 로그인을 완료하세요. Claude Code 사용자는 다음을 실행할 수 있습니다. claude mcp login human-design-ai; Codex 사용자는 다음을 실행할 수 있습니다. codex mcp login human_design_ai.

여섯 가지 계산 및 참조 도구만 필요하다면 Bearer 또는 X-Api-Key 인증을 통해 API 키를 계속 사용할 수 있습니다.

3. 사용 가능한 도구 확인

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

도구 검색은 무료입니다. OAuth에서 표시되는 도구는 서버에서 산출한 사용자 기능 권한, Free/Individual/Personal/Pro 멤버십, 워크스페이스 역할, 소유권 및 제품 이용 자격에 따라 결정됩니다. API 키에서 표시되는 도구는 별도의 Free/Creator/Startup/Business API 요금제에 따라 결정됩니다.

4. 기본 차트로 시작

에이전트에게 다음 호출을 요청하세요. chart_get_primary. 기본 차트가 없으면 Free, Individual, Personal 및 Pro 회원은 다음을 사용할 수 있습니다. chart_generate: 먼저 정규화된 출생 정보와 1단위 미리 보기를 확인한 다음 실행을 확정하세요. 저장된 차트는 계정 소유권으로 확인하며, “Kyle”이나 “My Chart” 같은 이름으로 검색하지 않습니다. 다른 사람의 승인된 차트를 읽으려면 Personal 또는 Pro가 필요합니다.

연결, initialize, ping, tools/list, 라이브러리 조회, 상태 확인 및 기존 차트 렌더링에는 크레딧이 들지 않습니다. 새 기본 차트 계산에는 정확히 1 계산 단위가 사용되며 렌더링에 추가 비용은 없습니다.

계산 결과 신뢰성

에이전트가 직접 차트를 계산하지 않습니다. HumanDesign.ai는 할당량을 사용하기 전에 날짜, 위치, IANA 시간대 및 일광 절약 시간 맥락을 검증한 다음 자체 계산 서비스에서 버전이 지정된 결과를 반환합니다. 위치가 모호하거나 입력이 잘못된 경우 단위를 사용하지 않고 명확한 오류를 반환합니다. 출생 시각을 모르면 서비스는 현지 정오를 사용했음을 기록하고 시각에 따라 달라지는 차트 정보가 다를 수 있다고 안내합니다.

안전한 계산 재시도

할당량을 사용하는 MCP 도구에는 generate_chart, generate_composite_chart 및 get_transits 가 필요합니다. 한 번의 의도된 재시도에는 정규화된 인수가 동일한 경우 같은 키를 사용하고, 새 작업에는 새 키를 사용하세요. 일치하는 재시도는 추가 할당량을 사용하지 않으며 결과를 결정적으로 다시 계산할 수 있습니다. 저장된 응답을 바이트 단위로 그대로 재생하는 방식은 아닙니다. MCP 트랜짓 호출에는 재시도가 항상 동일한 순간을 가리키도록 명시적 날짜가 필요합니다. 직접 REST 및 Agent HTTP 클라이언트는 지원되는 제한된 비스트리밍 작업에 다음을 보낼 수 있습니다. idempotencyKeyidempotencyKey Idempotency-Key idempotencyKey

원시 프로토콜 테스트

API 키를 사용하는 개발자는 다음과 같이 직접 초기화하고 계산 도구를 호출할 수 있습니다.

초기화

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "my-agent",
      "version": "1.0.0"
    }
  }
}

계산 호출

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "generate_chart",
    "arguments": {
      "birthDateTime": "1990-05-15T14:30:00",
      "timezone": "America/New_York",
      "detailLevel": "core",
      "idempotencyKey": "chart-1990-05-15-v1"
    }
  }
}

클라이언트 선택

Claude · Codex · Cursor · VS Code · 플러그인 다운로드

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

다음 답을 찾아보세요.