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

Kết nối tác nhân của bạn trong bốn bước.

Với Claude, ChatGPT hoặc Codex, OAuth là phương thức kết nối được khuyến nghị vì có thể cung cấp an toàn các công cụ HumanDesign.ai mà người dùng đã đăng nhập được phép sử dụng.

1. Thêm endpoint lưu trữ

Endpoint

https://mcp.humandesign.ai/

Chọn Remote HTTP hoặc Streamable HTTP. Không thêm /mcp lần nữa: endpoint chuẩn là thư mục gốc của tên miền.

2. Xác thực

Dùng thao tác Authenticate hoặc Connect của MCP trong ứng dụng khách và hoàn tất đăng nhập HumanDesign.ai qua trình duyệt. Người dùng Claude Code có thể chạy claude mcp login human-design-ai; người dùng Codex có thể chạy codex mcp login human_design_ai.

Nếu chỉ cần sáu công cụ tính toán/tham chiếu, bạn vẫn có thể dùng khóa API qua phương thức xác thực Bearer hoặc X-Api-Key xác thực.

3. Khám phá công cụ

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

Khám phá miễn phí. Khả năng hiển thị công cụ OAuth dựa trên quyền tính năng do máy chủ xác định, gói Free/Individual/Personal/Pro, vai trò không gian làm việc, quyền sở hữu và quyền sử dụng sản phẩm của người dùng. Khả năng hiển thị bằng khóa API dựa trên gói API Free/Creator/Startup/Business riêng.

4. Bắt đầu với biểu đồ chính của bạn

Yêu cầu tác nhân gọi chart_get_primary. Nếu chưa có biểu đồ chính, thành viên Free, Individual, Personal và Pro có thể dùng chart_generate: trước tiên xem lại thông tin sinh đã chuẩn hóa và bản xem trước tiêu thụ một đơn vị, sau đó xác nhận thực thi. Biểu đồ đã lưu được truy xuất dựa trên quyền sở hữu tài khoản, không phải bằng cách tìm tên như “Kyle” hay “Biểu đồ của tôi”. Cần Personal hoặc Pro để đọc biểu đồ được cấp quyền của người khác.

Kết nối, initialize, ping, tools/list, đọc thư viện, kiểm tra trạng thái và hiển thị biểu đồ hiện có không tiêu thụ tín dụng. Tạo biểu đồ chính mới tiêu thụ chính xác một đơn vị tính toán; việc hiển thị biểu đồ không tính thêm phí.

Cách bảo đảm độ tin cậy khi tính toán

Tác nhân không tự tính biểu đồ. HumanDesign.ai xác thực ngày, địa điểm, múi giờ IANA và bối cảnh giờ mùa hè trước khi tiêu thụ hạn mức, sau đó trả về kết quả có phiên bản từ dịch vụ tính toán. Địa điểm mơ hồ và dữ liệu không hợp lệ sẽ trả về lỗi rõ ràng mà không tiêu thụ đơn vị nào. Nếu không biết giờ sinh, dịch vụ ghi nhận đã dùng 12 giờ trưa theo giờ địa phương và cảnh báo rằng các chi tiết biểu đồ phụ thuộc thời gian có thể khác.

Thử lại phép tính an toàn

Các công cụ MCP có tính phí generate_chart, generate_composite_chart, và get_transits cần có idempotencyKey. Dùng lại cùng khóa với các đối số đã chuẩn hóa giống hệt cho một lần thử lại dự kiến; dùng khóa mới cho yêu cầu mới. Yêu cầu thử lại khớp không tiêu thụ thêm hạn mức và có thể tính lại kết quả một cách xác định; đây không phải phát lại nguyên byte của phản hồi đã lưu. Lệnh gọi MCP về quá cảnh cần ngày cụ thể để yêu cầu thử lại luôn tham chiếu cùng một thời điểm. Ứng dụng khách REST trực tiếp và Agent HTTP có thể gửi Idempotency-Key trên các thao tác không truyền luồng có giới hạn được hỗ trợ; khóa này vẫn là tùy chọn trong giai đoạn chuyển đổi tương thích, vì vậy các lệnh gọi không có khóa không thể loại bỏ yêu cầu thử lại ở tầng truyền tải. Batch và SSE từ chối khóa thử lại do người gọi cung cấp và không thuộc hợp đồng chống trùng lặp thử lại này.

Kiểm thử giao thức thô

Nhà phát triển dùng khóa API có thể khởi tạo và gọi trực tiếp một công cụ tính toán:

Khởi tạo

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "my-agent",
      "version": "1.0.0"
    }
  }
}

Lệnh gọi tính toán

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "generate_chart",
    "arguments": {
      "birthDateTime": "1990-05-15T14:30:00",
      "timezone": "America/New_York",
      "detailLevel": "core",
      "idempotencyKey": "chart-1990-05-15-v1"
    }
  }
}

Chọn ứng dụng khách

Claude · Codex · Cursor · VS Code · Tải plugin

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.