HumanDesign.aiPersonal打开应用 ↗
为你自己打造帮助中心

连接 HumanDesign.ai MCP

API2026 年 8 月 28 日更新阅读约需 2 分钟

开始之前

HumanDesign.ai MCP 为兼容的 AI 客户端提供结构化 Human Design 工具。本指南介绍使用 API 密钥的计算和参考目录。如果你的客户端支持 HumanDesign.ai OAuth 连接,并且你需要访问已保存的平台数据等账户连接功能,请使用该登录流程。OAuth 权限和可用性会在登录过程中选择。

规范的 MCP 端点是 https://mcp.humandesign.ai/。MCP 请求请使用 POST / 。 GET / 不是连接测试,返回 405 Method Not Allowed. POST /mcp 是兼容别名。

安全添加 API 密钥

使用下列其中一个请求标头。不要将 API 密钥放入 URL、提交到代码库或粘贴到聊天中。

Authorization: Bearer YOUR_HDAI_API_KEY

或者:

X-Api-Key: YOUR_HDAI_API_KEY

连接并发现工具

  1. 使用以下信息配置 MCP 客户端: https://mcp.humandesign.ai/.
  2. 发送 initialize ,并使用协议版本 2025-11-25.
  3. 发送 notifications/initialized.
  4. 调用 tools/list ,并且仅使用为你的密钥返回的工具。
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

例如 initialize, ping和 tools/list 之类的工具发现调用不会消耗计算配额。成功的 tools/call 会消耗一个共享 API 单位;验证失败和不可用工具不会消耗配额。

调用工具

使用以下操作返回的工具名称和输入架构: tools/list。例如,核心图表请求格式如下:

{
  "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"
    }
  }
}

读取结果

成功调用会返回简短易读的摘要、一个 JSON 文本块以及 structuredContent。结构化响应使用带版本的封装,其中包含 version, tool, data, meta,以及可选的 error 字段。

当前计算/参考目录只提供工具。请勿期待该目录提供 MCP 提示、MCP 资源、报告生成工具、服务器会话或图表图像块。

返回顶部 ↑需要帮助?联系支持团队 ↗

找到你的下一个答案。