HumanDesign.aiMCP打开应用 ↗
为您的 AI 打造产品与公司
常见问题

关于实时 MCP 服务器的直接解答。

规范 MCP 传输端点是根端点 https://mcp.humandesign.ai/。计算权威来源仍是 HumanDesign.ai API。

什么是 Human Design MCP?

这是 HumanDesign.ai 官方远程智能体接口。兼容的 AI 客户端可以通过 OAuth 使用按会员权限开放的账户工具,也可以通过 API 密钥使用六种计算和参考工具。

这是独立的人类图计算引擎吗?

不是。MCP、Agent HTTP、REST 和 HumanDesign.ai 都会将图表计算委托给同一个权威服务。OAuth 和 API 密钥开放不同功能,但计算版本和配额决定均由中心统一管理。

图表数据如何确保可靠?

服务会在计算前验证出生信息、地点、IANA 时区和夏令时背景,返回带版本号的结构化结果,并在收费前拒绝含糊或无效的输入。智能体会被要求不要近似计算图表数学结果。

智能体应如何填写出生日期和时间?

使用当地墙上时间:填写当事人出生地时钟所显示的准确时间,不带 Z 或 UTC 偏移,并在 timezone 中单独提供 IANA 时区标识符。例如,"birthDateTime": "1990-05-15T14:30:00" 和 "timezone": "America/New_York" 表示纽约当地下午两点半。带有 Z 或偏移量的值本身并未指明当地墙上时间,读取时所采用的时区会改变图表结果。发送前切勿将出生时间转换为 UTC。

客户端发送 Z 或 UTC 偏移量会有问题吗?

目前不会。MCP 会转发该值,API 仍会接受并将其读取为 UTC,同时在响应中标示弃用通知。此类值将来会停止接受,具体日期会提前公布。切换为不带偏移的当地墙上时间,并单独提供 IANA 时区是安全的改法;如果原值实际并非 UTC,此改动还能纠正图表。

有多少种计算工具?

六种:resolve_timezone、generate_chart、generate_composite_chart、get_reference_item、get_transits 和 search_celebrities。OAuth 还会依据会员资格、所有权、角色、由服务器判定的功能授权和权限,额外提供经过筛选的账户工具目录。

哪些客户端可以连接?

任何兼容 Streamable HTTP MCP 的客户端都可以连接。文档包含 Claude、ChatGPT、Codex、Cursor 和 VS Code 的指南。

哪些操作会消耗计算配额?

generate_chart、generate_composite_chart 和 get_transits 在经过验证的请求到达计算环节时各消耗一个单位。resolve_timezone、get_reference_item、search_celebrities、initialize、ping、tools/list、无效输入、被拒绝的访问、读取资料库、状态检查以及渲染现有图表均消耗零单位。

如何安全地重试计算?

三种会消耗配额的 MCP 工具都需要稳定的 idempotencyKey。仅在对同一组规范化参数进行同一意图的重试时复用该键。匹配的请求不会额外消耗配额,并可能确定性地重新计算;它并非逐字节重放已存储的响应。MCP 行运调用还必须提供明确日期。

HumanDesign.ai Free 会员可以创建图表吗?

可以。Free 会员通过 OAuth 可以预览、确认、创建、保存、查看和渲染自己的主要图表。新计算恰好使用一个单位,渲染不会额外收费。

可以生成复合图表吗?

API 密钥计算接口可以生成新的双人复合图表。符合条件的 OAuth 账户可以检索并渲染获授权访问的已保存复合图表。服务器始终会执行所有权和会员权限边界。

如果图片无法内嵌显示,会怎样?

服务器会在报告成功前验证 PNG 或 SVG,同时也会返回短时有效的安全下载链接作为备用方式。

在哪里管理访问权限和账单?

访问 HumanDesign.ai 可管理平台会员资格和账户访问权限;访问 my.humandesign.ai 可管理 API 密钥、API 方案用量和账单。

需要账户帮助?请访问 my.humandesign.ai.

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

找到你的下一个答案。