您授权的是能力,而不是新的工作区角色。
OAuth 让 Claude、Codex 或 ChatGPT 以已登录的 HumanDesign.ai 用户身份操作。它不会创建访问权限、更改会员资格,也不会让 Agent 拥有某个工作区。
选择工作区意味着什么
由于付费账户可能同时拥有个人库和一个或多个团队或企业工作区,同意授权页面会询问“Claude 应在哪个工作区工作?”。此选择设定数据边界,并非额外的会员权限。每次调用仍会检查用户的会员资格、角色、能力授权、所有权和产品权限。在 Builder 授权适用的边界内,符合条件的项目即可使用 Builder;项目无需单独授予 OAuth 权限。
Free 和 Individual 账户: 不会显示工作区选择器。连接仅限个人账户边界和用户自己的主图;Individual 还包括账户用量。查看他人图表和更广泛的平台工具需要 Personal 或 Pro。
为使授权含义清晰,Personal 和 Pro 会显示一个合并的 图表和库 权限,而非相互重叠的“您的图表”和“库”复选框。在 Personal 边界内,该权限涵盖主图和允许访问的库;在选定工作区内,则仅限该工作区允许访问的图表和组合图表。
身份作用域和能力授权
OAuth 协议仅请求身份和会话作用域,例如 email, profile和 offline_access。登录后,HumanDesign.ai 会根据所选账户边界、会员资格、角色、所有权和权限派发以下内部能力授权。这些是执行控制标签,并非客户端可额外请求以绕过会员资格的 OAuth 作用域。
| 能力授权 | 允许操作 |
|---|---|
charts:read | 读取已授权的图表记录 |
charts:generate | 在预览和确认后创建已连接用户的主图 |
library:read | 搜索并检索允许访问的库项目 |
library:organize | 管理文件夹和项目位置 |
reports:read | 读取模板、报告和生成状态 |
builder:read | 读取有权限的 Builder 项目和运行 |
builder:write | 在允许的情况下取消正在运行的 Builder 任务 |
account:usage | 读取余额、配额和汇总用量 |
Agent 中显示的内容
tools/list 会根据已验证用户当前的能力授权、会员资格、工作区角色、所有权和权限进行过滤。升级、降级、角色变更和撤销授权会在重新连接或刷新令牌后生效。操作状态和取消操作也会重新检查最初授权该操作的能力,因此移除权限后,旧任务仍无法通过操作工具访问。
确认和外部影响
当工具提供预览或确认时,确认信息会绑定操作者、边界、操作、参数、目标、最高收费和有效期。任何一项发生变化都会使其失效。创建主图需要一单位预览和确认;删除库文件夹也需要确认。只有在当前状态允许取消时,才会直接取消操作或 Builder 运行。本版本暂不提供风险较高的发布和交付操作。
撤销访问权限
在客户端连接器设置中断开 HumanDesign.ai,或清除 MCP 身份验证。撤销会终止委托连接,但不会删除 HumanDesign.ai 数据或更改会员资格。