HumanDesign.ai MCP 연결
시작하기 전에
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
연결하고 도구 검색하기
- 다음으로 MCP 클라이언트를 설정하세요.
https://mcp.humandesign.ai/. - 전송
initialize프로토콜 버전과 함께2025-11-25. - 전송
notifications/initialized. - 를 호출한 뒤 키로 반환된 도구만 사용하세요.
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 리소스, 보고서 생성 도구, 서버 세션 또는 차트 이미지 블록은 제공되지 않습니다.