HumanDesign.aiPersonal앱 열기 ↗
나 자신을 위한 기능도움말 센터

HumanDesign.ai MCP 연결

API2026년 8월 28일 업데이트2분 읽기

시작하기 전에

HumanDesign.ai MCP는 호환되는 AI 클라이언트에 구조화된 Human Design 도구를 제공합니다. 이 가이드에서는 API 키를 사용하는 계산 및 참조 카탈로그를 다룹니다. 클라이언트가 HumanDesign.ai OAuth 연결을 지원하고 저장된 플랫폼 데이터와 같은 계정 연결 기능이 필요한 경우 로그인할 때 OAuth를 선택하세요.

표준 MCP 엔드포인트는 다음과 같습니다. https://mcp.humandesign.ai/. MCP 요청에는 다음을 사용하세요. POST / / GET / 은 연결 테스트가 아니며 다음을 반환합니다. 405 Method Not Allowed. POST /mcp 는 호환성 별칭입니다.

API 키를 안전하게 추가하세요

다음 요청 헤더 중 하나를 사용하세요. API 키를 URL에 넣거나 저장소에 커밋하거나 채팅에 붙여넣지 마세요.

Authorization: Bearer YOUR_HDAI_API_KEY

또는:

X-Api-Key: YOUR_HDAI_API_KEY

연결하고 도구 검색하기

  1. 다음으로 MCP 클라이언트를 설정하세요. https://mcp.humandesign.ai/.
  2. 전송 initialize 프로토콜 버전과 함께 2025-11-25.
  3. 전송 notifications/initialized.
  4. 를 호출한 뒤 키로 반환된 도구만 사용하세요. tools/list 를 호출하고 키로 반환된 도구만 사용하세요.
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

다음과 같은 검색 요청은 initialize, ping 및 tools/list 계산 할당량을 사용하지 않습니다. 성공한 tools/call 호출은 공유 API 단위 1개를 사용합니다. 검증 실패와 사용할 수 없는 도구에는 요금이 부과되지 않습니다.

도구 호출하기

에서 반환된 도구 이름과 입력 스키마를 사용하세요. 예를 들어 핵심 차트 요청은 다음과 같은 형식입니다. tools/list. 핵심 차트 요청은 다음과 같은 형식입니다.

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

결과 읽기

호출이 성공하면 읽기 쉬운 요약, JSON 텍스트 블록 및 다음 항목이 반환됩니다. structuredContent구조화된 응답은 버전이 지정된 봉투 형식을 사용하며 다음을 포함합니다. version, tool, data, meta, 선택적으로 error 필드도 포함될 수 있습니다.

현재 계산 및 참조 카탈로그에서는 도구만 제공합니다. MCP 프롬프트, MCP 리소스, 보고서 생성 도구, 서버 세션 또는 차트 이미지 블록은 제공되지 않습니다.

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

다음 답을 찾아보세요.