身份验证
账户使用 OAuth。计算使用 API 密钥。
Human Design MCP 特意支持两种权限不同的凭据类型。访问私有 HumanDesign.ai 账户工具请选择 OAuth;访问原有计算/参考接口请选择 API 密钥。
HumanDesign.ai OAuth
- 添加
https://mcp.humandesign.ai/作为远程 Streamable HTTP MCP 服务器,且无需静态授权标头。 - 使用客户端的 Authenticate、Connect、
/mcp、或 MCP 登录操作。 - 在 HumanDesign.ai 品牌页面登录,并查看所选账户边界和可用能力。
- 会员资格、工作区角色、权限或授权发生变化后,请重新连接。
OAuth 访问权限始终受会员资格和所有权限制。Free 和 Individual 账户可创建、保存、查看并渲染自己的主图;Individual 还可查看账户用量。访问他人已授权的图表和更广泛的平台功能需要 Personal 或 Pro。
API 密钥计算访问
Bearer API 密钥和 X-Api-Key 仍可用于六项计算/参考工具。它们不会开放账户、库、报告或 Builder 数据。
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEY凭据安全
- OAuth 令牌由 MCP 客户端和授权服务处理;切勿将其粘贴到提示词或源文件中。
- 请将 API 密钥存储在环境变量或受保护的密钥库中。
- 切勿记录授权标头、刷新令牌、API 密钥、签名资产 URL 或结构化私有图表结果。
- 断开连接器或清除 MCP 身份验证即可撤销委托访问。
- 在以下位置管理 API 密钥和计算计划用量: my.humandesign.ai.
身份验证错误
| 代码 | 含义 | 处理方式 |
|---|---|---|
401 | 凭据缺失、格式错误、过期或已撤销 | 重新运行客户端 OAuth 登录,或恢复受保护的 API 密钥设置。 |
403 | 来源、能力授权、会员资格、角色、所有权或权限不允许访问 | 检查账户边界;获批更改访问权限后重新连接。 |
429 | 计算配额或安全速率限制已达到 | 查看用量;不要在短时间内快速重试。 |