HumanDesign.aiMCPMở ứng dụng ↗
DÀNH CHO AI CỦA BẠNTài Liệu
Tài Liệu

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

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-stream

Các phương thức được hỗ trợ

initialize

Phươ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/initialized

Phươ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.

ping

Phươ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/list

Phươ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/call

Thự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ỗiTrường hợp trả về
nonexistent_local_timeViệ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_timeGiờ đị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_datetimeGiờ sinh nằm trong tương lai.
invalid_birth_datetime_formatGiá 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

Lên đầu trang ↑Cần trợ giúp? Liên hệ bộ phận hỗ trợ ↗

Tìm câu trả lời tiếp theo.