Kết nối tác nhân với HumanDesign.ai.
Endpoint Streamable HTTP từ xa chuẩn là https://mcp.humandesign.ai/. OAuth kết nối các công cụ tài khoản riêng tư; khóa API giữ nguyên bề mặt API tính toán/tham chiếu.
Quy tắc gói thành viên: Người dùng HumanDesign.ai gói Free và Individual có thể tạo, lưu, xem và hiển thị biểu đồ chính của chính họ; Individual cũng xem được mức sử dụng tài khoản. Cần gói Personal hoặc Pro để đọc biểu đồ của người khác khi được cấp quyền hoặc dùng các tính năng tài khoản rộng hơn. 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ụ đó.
Chọn bề mặt truy cập
Công cụ nền tảng OAuth →
Hiện có 19 công cụ được cung cấp cho tài khoản, hiển thị biểu đồ, thư viện, thao tác, trạng thái báo cáo và Builder.
Công cụ tính toán bằng khóa API →
6 công cụ tính toán/tham chiếu chịu sự điều chỉnh của gói API và hạn mức tính toán riêng.
Bề mặt giao thức
Máy chủ chấp nhận JSON-RPC qua HTTP POST tại thư mục gốc của tên miền. GET và DELETE bị từ chối có chủ đích đối với phương thức truyền tải MCP; GET /health chỉ cung cấp siêu dữ liệu tình trạng dịch vụ an toàn.
Endpoint chuẩn
POST https://mcp.humandesign.ai/
Content-Type: application/json
Accept: application/json, text/event-streamCác phương thức được hỗ trợ
initializePhương thức kết nối hoặc khám phá; không tiêu thụ hạn mức hay tín dụng AI.
notifications/initializedPhương thức kết nối hoặc khám phá; không tiêu thụ hạn mức hay tín dụng AI.
pingPhương thức kết nối hoặc khám phá; không tiêu thụ hạn mức hay tín dụng AI.
tools/listPhương thức kết nối hoặc khám phá; không tiêu thụ hạn mức hay tín dụng AI.
tools/callThực thi một công cụ được cấp quyền theo chính sách thanh toán và xác nhận của công cụ đó.
Giờ sinh là giờ trên đồng hồ địa phương
Gửi ngày giờ sinh theo giờ hiển thị trên đồng hồ tại nơi người đó sinh ra, không có Z và không có độ lệch UTC, đồng thời cung cấp riêng múi giờ dưới dạng mã IANA.
"birthDateTime": "1990-05-15T14:30:00" with "timezone": "America/New_York" means half past two in the afternoon in New York.
Giá trị có Z hoặc độ lệch không tự xác định giờ trên đồng hồ địa phương. Cần có quy tắc để xác định múi giờ dùng để đọc giờ đó, và lựa chọn này làm thay đổi biểu đồ.
Z và độ lệch UTC đã lỗi thời. Các giá trị kết thúc bằng Z hoặc độ lệch số đã lỗi thời. Hiện MCP chuyển tiếp chúng và API vẫn chấp nhận tạm thời, đọc chúng như UTC và thông báo việc ngừng dùng trong phản hồi API. Chúng sẽ không còn được chấp nhận; ngày áp dụng sẽ được thông báo trước.
API từ chối giờ trên đồng hồ địa phương không xác định được một thời điểm duy nhất trước khi sử dụng bất kỳ đơn vị tính toán nào:
| Mã lỗi | Trường hợp trả về |
|---|---|
nonexistent_local_time | Việc chuyển đổi giờ mùa hè đã bỏ qua giờ đó, nên thời điểm ấy không tồn tại trong múi giờ này. |
ambiguous_local_time | Giờ địa phương nằm trong khoảng lặp lại khi chuyển đổi giờ mùa hè, nên xảy ra hai lần trong múi giờ này. |
future_birth_datetime | Giờ sinh nằm trong tương lai. |
invalid_birth_datetime_format | Giá trị không phải giờ trên đồng hồ địa phương. Sau ngày chuyển đổi, điều này cũng bao gồm Z và độ lệch số. |
Ngày quá cảnh sử dụng cùng định dạng giờ địa phương nhưng có thể nằm trong tương lai.
Bắt đầu tại đây
Bắt đầu →
Kết nối qua OAuth và gửi yêu cầu đầu tiên an toàn.
Gói thành viên và quyền →
Tìm hiểu về quyền tính năng, không gian làm việc, quyền sở hữu và xác nhận.
Claude, ChatGPT và Codex →
Tải tệp thiết lập và gói plugin hai định dạng.
Xác thực →
Chọn quyền truy cập OAuth hoặc chỉ dùng khóa API tính toán.