一次 MCP 连接,适用于四种智能体界面。
直接使用托管端点、下载 Claude Code 项目文件,或安装双格式插件包;该插件包专为 Claude Code 以及通用 ChatGPT/Codex 插件系统准备。
Claude Code:快速设置
CLAUDE.md 是指导文件,不是安装程序。 Claude Code 本身必须已登录,并且项目范围内的 .mcp.json 必须受到信任,MCP OAuth 才能启动。
- 打开项目目录并运行
claude. - 如果 Claude Code 提示你已退出登录,请运行
/login. - 出现提示时,批准该项目及其
.mcp.json。 - 运行
/mcp,选择human-design-ai,然后完成 HumanDesign.ai OAuth 授权。
或者,在 Claude Code 登录后添加用户范围连接:
claude mcp add --transport http --scope user human-design-ai https://mcp.humandesign.ai/
claude mcp login human-design-ai如需共享项目,请将以下内容保存为 .mcp.json 并放在项目根目录。
.mcp.json
{
"mcpServers": {
"human-design-ai": {
"type": "http",
"url": "https://mcp.humandesign.ai/"
}
}
}Claude.ai 和 Claude Desktop
- 打开 自定义 → 连接器.
- 选择 添加自定义连接器.
- 使用
https://mcp.humandesign.ai/作为远程 MCP URL。 - 选择 连接 ,然后完成 HumanDesign.ai OAuth 授权。
- 在对话中,从连接器菜单启用 HumanDesign.ai。
Team 和 Enterprise 所有者需要先在组织设置中添加连接器;之后每位成员再连接自己的 HumanDesign.ai 账户。
Codex
~/.codex/config.toml
[mcp_servers.human_design_ai]
url = "https://mcp.humandesign.ai/"
auth = "oauth"
startup_timeout_sec = 30
tool_timeout_sec = 60进行身份验证
codex mcp login human_design_aiChatGPT
- 在以下位置启用开发者模式: 设置 → 安全和登录.
- 打开 插件,选择加号按钮,然后添加远程 MCP URL
https://mcp.humandesign.ai/. - 扫描并检查发现的工具,然后完成 OAuth 授权。
- 在新的 Work 对话中启用连接,并先测试有代表性的只读提示。
插件提供的功能
该软件包包含 Claude 和 OpenAI 插件清单、远程 MCP 定义、品牌素材,以及一项工作流技能。该技能会指导智能体使用个人图表和已保存的复合关系图表、渲染获授权的人类图图表、遵守 Free/Individual/Personal/Pro 权限边界,并安全处理确认、幂等性和机密信息。
复合关系图表
通过 OAuth,Personal 和 Pro 会员可以检索并渲染其获授权访问的已保存复合图表。根据两组出生信息创建新的复合图表需要使用独立的计算接口,因此需要受保护的 HumanDesign.ai API 密钥;验证通过后会消耗一个计算单位。实时服务器始终会执行所有权、同意、会员资格、凭证类型和配额规则。
为何要连接会员账户?
Free 为每位会员提供可靠的个人图表起点,而 Individual 在相同的个人图表范围内增加账户用量可见性。Personal 开放更广泛的获授权图表和已保存复合图表库、个人拥有的报告、专业人士、社区学习,以及与探索相似设计模式的人建立联系。Pro 则进一步扩展为专业工作区。仅当 HumanDesign.ai 已为你的账户启用 Builder 时,才会显示 Website Builder 工具,并且只有在 tools/list 宣传这些工具时才会显示。HumanDesign.ai 会员还可在 HumanDesign.ai 平台内获得更深入的体验,包括符合条件的行运功能;MCP 的 get_transits 计算工具则需要 Startup 或更高级别的 API 密钥。可下载的智能体指导文件本身保持中立:它会说明缺少的权限一次,并依据实时目录执行,不会在对话中反复插入升级促销。
安装插件不会绕过 HumanDesign.ai 授权。服务器只会返回已登录账户允许使用的工具。切勿将 OAuth 令牌或 API 密钥粘贴到提示中。