Một kết nối MCP, bốn giao diện tác nhân.
Sử dụng trực tiếp endpoint lưu trữ, tải xuống các tệp dự án Claude Code hoặc cài gói plugin hai định dạng được chuẩn bị cho Claude Code và hệ thống plugin phổ quát của ChatGPT/Codex.
Claude Code: thiết lập nhanh nhất
CLAUDE.md là tài liệu hướng dẫn, không phải trình cài đặt. Bản thân Claude Code phải được đăng nhập, và dự án trong phạm vi .mcp.json phải được tin cậy trước khi OAuth của MCP có thể bắt đầu.
- Mở thư mục dự án và chạy
claude. - Nếu Claude Code báo bạn đã đăng xuất, hãy chạy
/login. - Chấp thuận dự án và
.mcp.jsonkhi được nhắc. - Chạy
/mcp, chọnhuman-design-ai, rồi hoàn tất quy trình OAuth của HumanDesign.ai.
Ngoài ra, sau khi Claude Code đã đăng nhập, hãy thêm kết nối ở cấp người dùng:
claude mcp add --transport http --scope user human-design-ai https://mcp.humandesign.ai/
claude mcp login human-design-aiĐối với dự án dùng chung, lưu nội dung sau thành .mcp.json tại thư mục gốc của dự án.
.mcp.json
{
"mcpServers": {
"human-design-ai": {
"type": "http",
"url": "https://mcp.humandesign.ai/"
}
}
}Claude.ai và Claude Desktop
- Mở Tùy chỉnh → Trình kết nối.
- Chọn Thêm trình kết nối tùy chỉnh.
- Dùng
https://mcp.humandesign.ai/làm URL MCP từ xa. - Chọn Kết Nối và hoàn tất quy trình OAuth của HumanDesign.ai.
- Bật HumanDesign.ai từ menu trình kết nối trong một cuộc trò chuyện.
Chủ sở hữu gói Team và Enterprise thêm trình kết nối trước trong phần cài đặt tổ chức; sau đó, mỗi thành viên kết nối tài khoản HumanDesign.ai của riêng mình.
Codex
~/.codex/config.toml
[mcp_servers.human_design_ai]
url = "https://mcp.humandesign.ai/"
auth = "oauth"
startup_timeout_sec = 30
tool_timeout_sec = 60Xác thực
codex mcp login human_design_aiChatGPT
- Bật chế độ Nhà phát triển trong Cài đặt → Bảo mật và đăng nhập.
- Mở Plugin, chọn nút dấu cộng rồi thêm URL MCP từ xa
https://mcp.humandesign.ai/. - Quét và xem xét các công cụ được phát hiện, rồi hoàn tất OAuth.
- Bật kết nối trong cuộc trò chuyện Work mới và trước tiên thử một số yêu cầu chỉ đọc tiêu biểu.
Plugin bổ sung những gì
Gói này bao gồm các tệp kê khai plugin cho cả Claude và OpenAI, định nghĩa MCP từ xa, tài nguyên có thương hiệu và một kỹ năng quy trình hướng dẫn tác nhân sử dụng biểu đồ cá nhân và biểu đồ quan hệ tổng hợp đã lưu, tạo sơ đồ bodygraph được cấp quyền, tuân thủ giới hạn Free/Individual/Personal/Pro, đồng thời xử lý xác nhận, tính lũy đẳng và bí mật một cách an toàn.
Biểu đồ quan hệ tổng hợp
Với OAuth, thành viên Personal và Pro có thể truy xuất và hiển thị các biểu đồ tổng hợp đã lưu mà họ được phép truy cập. Tạo biểu đồ tổng hợp mới từ thông tin ngày sinh của hai người sử dụng bề mặt tính toán riêng, do đó cần khóa API HumanDesign.ai được bảo vệ; thao tác này tiêu thụ một đơn vị tính toán sau khi xác thực. Máy chủ trực tiếp luôn thực thi các quy tắc về quyền sở hữu, sự đồng ý, tư cách thành viên, loại thông tin xác thực và hạn mức.
Vì sao cần kết nối gói thành viên?
Free cung cấp cho mọi thành viên điểm bắt đầu đáng tin cậy với biểu đồ của chính họ, trong khi Individual bổ sung khả năng theo dõi mức sử dụng tài khoản trong cùng phạm vi biểu đồ cá nhân. Personal mở rộng quyền truy cập vào thư viện biểu đồ và biểu đồ tổng hợp đã lưu được cấp phép, báo cáo thuộc sở hữu của bạn, chuyên gia, hoạt động học tập cộng đồng và kết nối với những người đang khám phá các mẫu thiết kế tương tự. Pro mở rộng trải nghiệm này thành không gian làm việc chuyên nghiệp. Công cụ Website Builder chỉ xuất hiện khi HumanDesign.ai đã bật Builder cho tài khoản của bạn và chỉ khi tools/list quảng bá các công cụ đó. Gói thành viên HumanDesign.ai cũng cung cấp trải nghiệm chuyên sâu hơn trong nền tảng HumanDesign.ai, bao gồm các tính năng quá cảnh đủ điều kiện; công cụ get_transits tính toán MCP cần khóa API từ Startup trở lên. Bản thân tài liệu hướng dẫn tác nhân có thể tải xuống vẫn trung lập: tài liệu giải thích một lần khi thiếu quyền sử dụng và tuân theo danh mục trực tiếp, thay vì liên tục chèn lời quảng bá nâng cấp vào cuộc trò chuyện.
Cài plugin không bỏ qua bước cấp quyền của HumanDesign.ai. Máy chủ chỉ trả về các công cụ được tài khoản đã đăng nhập cho phép. Không bao giờ dán token OAuth hoặc khóa API vào lời nhắc.