HumanDesign.aiMCP앱 열기 ↗
AI용문서
설치 가능한 연동

하나의 MCP 연결, 네 가지 에이전트 환경

호스팅 엔드포인트를 바로 사용하거나 Claude Code 프로젝트 파일을 다운로드하거나 Claude Code와 범용 ChatGPT/Codex 플러그인 시스템용으로 준비된 두 가지 형식의 플러그인 패키지를 설치하세요.

Claude Code: 가장 빠른 설정 방법

CLAUDE.md는 안내 문서이며 설치 프로그램이 아닙니다. Claude Code에 로그인해야 하며, MCP OAuth를 시작하기 전에 프로젝트 범위의 다음 항목을 신뢰해야 합니다. .mcp.json MCP OAuth를 시작하기 전에 해당 항목을 신뢰해야 합니다.

  1. 프로젝트 디렉터리를 열고 다음을 실행하세요. claude.
  2. Claude Code에서 로그아웃되었다고 표시되면 다음을 실행하세요. /login.
  3. 메시지가 표시되면 프로젝트와 해당 항목을 승인하세요. .mcp.json 메시지가 표시되면 승인하세요.
  4. 다음을 실행하고 /mcp를 선택한 다음 human-design-aiHumanDesign.ai OAuth를 완료하세요.

또는 Claude Code에 로그인한 뒤 사용자 범위 연결을 추가하세요:

claude mcp add --transport http --scope user human-design-ai https://mcp.humandesign.ai/
claude mcp login human-design-ai

공유 프로젝트에서는 다음 내용을 .mcp.json 프로젝트 루트에 저장하세요.

.mcp.json

{
  "mcpServers": {
    "human-design-ai": {
      "type": "http",
      "url": "https://mcp.humandesign.ai/"
    }
  }
}

Claude.ai 및 Claude Desktop

  1. 열기 사용자 지정 → 커넥터.
  2. 선택 사용자 지정 커넥터 추가.
  3. 다음을 사용하세요. https://mcp.humandesign.ai/ 원격 MCP URL로 설정합니다.
  4. 선택 연결 를 선택하고 HumanDesign.ai OAuth를 완료하세요.
  5. 대화의 커넥터 메뉴에서 HumanDesign.ai를 활성화하세요.

Team 및 Enterprise 소유자는 먼저 조직 설정에서 커넥터를 추가해야 합니다. 그런 다음 각 구성원이 자신의 HumanDesign.ai 계정을 연결합니다.

Codex

~/.codex/config.toml

[mcp_servers.human_design_ai]
url = "https://mcp.humandesign.ai/"
auth = "oauth"
startup_timeout_sec = 30
tool_timeout_sec = 60

인증

codex mcp login human_design_ai

ChatGPT

  1. 다음에서 개발자 모드 활성화 설정 → 보안 및 로그인.
  2. 열기 플러그인를 선택하고 더하기 버튼을 눌러 원격 MCP URL을 추가하세요. https://mcp.humandesign.ai/.
  3. 발견된 도구를 검토하고 OAuth를 완료하세요.
  4. 새 Work 대화에서 연결을 활성화한 뒤 대표적인 읽기 전용 프롬프트부터 테스트하세요.

플러그인에 포함된 내용

패키지에는 Claude 및 OpenAI 플러그인 매니페스트, 원격 MCP 정의, 브랜드 에셋 및 워크플로 스킬이 포함됩니다. 이 스킬은 에이전트가 개별 차트와 저장된 합성 관계 차트를 사용하고, 승인된 바디그래프를 렌더링하고, Free/Individual/Personal/Pro 경계를 준수하고, 확인 절차와 멱등성, 비밀 정보를 안전하게 처리하도록 안내합니다.

합성 관계 차트

OAuth를 사용하면 Personal 및 Pro 회원은 접근이 승인된 저장 합성 차트를 가져와 렌더링할 수 있습니다. 두 사람의 출생 정보로 새 합성 차트를 만들려면 별도의 계산 인터페이스를 사용해야 하므로 보호된 HumanDesign.ai API 키가 필요합니다. 검증 후 계산 단위 1개가 사용됩니다. 실시간 서버는 소유권, 동의, 멤버십, 자격 증명 유형 및 할당량 규칙을 항상 적용합니다.

멤버십을 연결해야 하는 이유

Free는 모든 회원에게 신뢰할 수 있는 본인 차트의 시작점을 제공하고, Individual은 동일한 본인 차트 범위에서 계정 사용량 확인을 추가합니다. Personal은 승인된 차트와 저장된 합성 차트 라이브러리, 소유한 보고서, 전문가, 커뮤니티 학습 및 비슷한 디자인 패턴을 탐구하는 사람들과의 연결을 제공합니다. Pro는 여기에 전문 워크스페이스를 더합니다. 웹사이트 빌더 도구는 HumanDesign.ai가 계정에 빌더를 활성화하고 다음 항목에 표시한 경우에만 사용할 수 있습니다. tools/list 해당 도구를 광고합니다. HumanDesign.ai 멤버십은 이용 자격이 있는 트랜짓 기능을 비롯해 HumanDesign.ai 플랫폼 내에서 더 풍부한 경험도 제공합니다. MCP의 get_transits 계산 도구에는 별도로 Startup 이상 API 키가 필요합니다. 다운로드 가능한 에이전트 안내는 요금제에 중립적입니다. 이용 자격이 없는 이유를 한 번 설명하고 대화에 반복적인 업그레이드 홍보 문구를 넣지 않은 채 실시간 도구 목록을 따릅니다.

플러그인을 설치해도 HumanDesign.ai 인증을 우회할 수 없습니다. 서버는 로그인한 계정이 허용하는 도구만 반환합니다. 프롬프트에 OAuth 토큰이나 API 키를 붙여넣지 마세요.

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

다음 답을 찾아보세요.