连接 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
连接并发现工具
- 使用以下信息配置 MCP 客户端:
https://mcp.humandesign.ai/. - 发送
initialize,并使用协议版本2025-11-25. - 发送
notifications/initialized. - 调用
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 资源、报告生成工具、服务器会话或图表图像块。