하나의 MCP 연결, 네 가지 에이전트 환경
호스팅 엔드포인트를 바로 사용하거나 Claude Code 프로젝트 파일을 다운로드하거나 Claude Code와 범용 ChatGPT/Codex 플러그인 시스템용으로 준비된 두 가지 형식의 플러그인 패키지를 설치하세요.
Claude Code: 가장 빠른 설정 방법
CLAUDE.md는 안내 문서이며 설치 프로그램이 아닙니다. Claude Code에 로그인해야 하며, MCP OAuth를 시작하기 전에 프로젝트 범위의 다음 항목을 신뢰해야 합니다. .mcp.json MCP OAuth를 시작하기 전에 해당 항목을 신뢰해야 합니다.
- 프로젝트 디렉터리를 열고 다음을 실행하세요.
claude. - Claude Code에서 로그아웃되었다고 표시되면 다음을 실행하세요.
/login. - 메시지가 표시되면 프로젝트와 해당 항목을 승인하세요.
.mcp.json메시지가 표시되면 승인하세요. - 다음을 실행하고
/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
- 열기 사용자 지정 → 커넥터.
- 선택 사용자 지정 커넥터 추가.
- 다음을 사용하세요.
https://mcp.humandesign.ai/원격 MCP URL로 설정합니다. - 선택 연결 를 선택하고 HumanDesign.ai OAuth를 완료하세요.
- 대화의 커넥터 메뉴에서 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_aiChatGPT
- 다음에서 개발자 모드 활성화 설정 → 보안 및 로그인.
- 열기 플러그인를 선택하고 더하기 버튼을 눌러 원격 MCP URL을 추가하세요.
https://mcp.humandesign.ai/. - 발견된 도구를 검토하고 OAuth를 완료하세요.
- 새 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 키를 붙여넣지 마세요.