HumanDesign.aiPersonalMở ứng dụng ↗
DÀNH CHO BẢN THÂN BẠNTrung tâm trợ giúp

Kết nối với HumanDesign.ai MCP

APICập nhật ngày 28 tháng 8 năm 2026Đọc trong 2 phút

Trước khi bắt đầu

HumanDesign.ai MCP cung cấp cho các ứng dụng khách AI tương thích bộ công cụ Human Design có cấu trúc. Hướng dẫn này nói về danh mục tính toán và tham chiếu sử dụng khóa API. Nếu ứng dụng khách hỗ trợ kết nối OAuth HumanDesign.ai, hãy dùng luồng đó khi cần quyền truy cập kết nối với tài khoản, chẳng hạn dữ liệu nền tảng đã lưu; quyền OAuth và phạm vi khả dụng được chọn khi đăng nhập.

Endpoint MCP chuẩn là https://mcp.humandesign.ai/. Dùng POST / cho các yêu cầu MCP. GET / không phải phép thử kết nối và trả về 405 Method Not Allowed. POST /mcp là bí danh tương thích.

Thêm khóa API an toàn

Dùng một trong các header yêu cầu sau. Không đặt khóa API trong URL, commit vào kho mã hoặc dán vào cuộc trò chuyện.

Authorization: Bearer YOUR_HDAI_API_KEY

hoặc:

X-Api-Key: YOUR_HDAI_API_KEY

Kết nối và khám phá công cụ

  1. Cấu hình ứng dụng khách MCP với https://mcp.humandesign.ai/.
  2. Gửi initialize với phiên bản giao thức 2025-11-25.
  3. Gửi notifications/initialized.
  4. Gọi tools/list và chỉ dùng các công cụ được trả về cho khóa của bạn.
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

Các lệnh gọi khám phá như initialize, ping, và tools/list không tiêu thụ hạn mức tính toán. Một lệnh gọi tools/call thành công tiêu thụ một đơn vị API dùng chung; lỗi xác thực đầu vào và công cụ không khả dụng không tiêu thụ đơn vị nào.

Gọi công cụ

Dùng tên công cụ và lược đồ đầu vào được trả về từ tools/list. Ví dụ, yêu cầu biểu đồ mức core có cấu trúc như sau:

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

Đọc kết quả

Lệnh gọi thành công trả về bản tóm tắt dễ đọc, khối văn bản JSON và structuredContent. Phản hồi có cấu trúc sử dụng phong bì có phiên bản với version, tool, data, meta, cùng trường error không bắt buộc.

Danh mục tính toán/tham chiếu hiện tại chỉ cung cấp công cụ. Không có lời nhắc MCP, tài nguyên MCP, công cụ tạo báo cáo, phiên máy chủ hoặc khối hình ảnh biểu đồ trong danh mục nà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.