一、操作场景
在凭据管理页面创建完成的凭据,可以在模型配置与创建 MCP 页面直接选择,无需再重复手动填写密钥。当需要更换密钥或回收访问权限时,管理员在凭据管理中一处修改即可同步生效至所有关联对象。
二、注意事项
·本模块仅管理企业内统一托管的模型与 MCP 调用凭据,不支持管理用户端 Agent 自带的 API Key(用户端 Agent 的 Key 由各 Agent 自行配置)。
·一个模型或 MCP 在同一时刻仅能绑定一个凭据,一个凭据可同时关联多个模型或 MCP。
·凭据删除后无法恢复,不提供回收站或历史快照功能。
三、前提条件
·已使用管理员账号登录 ClawPro 管控端。
·若需创建凭据,请提前确认目标服务所属协议及对应的密钥格式。
四、创建凭据
1. 登录 ClawPro 管控端,在左侧导航栏选择安全审计 > 凭据管理,进入凭据管理页面后,
页面展示凭据列表,包含凭据名称、关联 MCP、关联模型信息。你可使用顶部搜索框按凭据名称或 ID 检索。如下:
2. 单击页面右上角的创建凭据,打开创建凭据弹窗。如下:
填写以下参数:
·凭据名称:凭据在列表中的显示名称。
·凭据信息:根据凭据注入位置不同,你可按需选择 Header 或 Query 。
| 添加密钥类型 | 协议 | Header Key | 密钥值格式 | 示例 |
| 添加为 Header 参数 | OpenAI 协议 | authorization | Bearer + 空格 + API Key,注意增加 Bearer 前缀。最长256个字符。 | Bearer sk-xxxxxx |
| 添加为 Query 参数 | Anthropic 协议 | x-api-key | 直接填写 API Key,最长256个字符。 | sk-xxxxxx |
3. 填写完成后单击创建,保存凭据。
注意:说明:
注意:填写错误将导致模型或 MCP 无法正常调用,请严格按照规范填写,例如 OpenAI 协议的模型密钥值必须带 Bearer 前缀。
五、关联模型或 MCP
1. 在目标凭据所在行单击更多,选择关联模型或关联 MCP。如下:
2. 在弹窗中搜索并勾选目标,单击确认关联,页面提示已关联的模型或 MCP 数量。
注意:说明:
六、配置 MCP 凭据托管
ClawPro 支持为远程 MCP 服务开启凭据托管,管理员可根据实际需要选择以下配置方式:
·填写真实凭据:可选择已有凭据或手动填写
·保留占位符:管理员不填写真实凭据,由用户端在添加 MCP 时根据填写参数提示自行填写。
开启凭据托管后,用户端的查看源码入口不可用。
有关 MCP 服务的创建及凭据托管的具体配置步骤,请参见 配置企业技能与工具。
七、管理已有凭据
企业管理员可在凭据管理页面,对已创建的凭据进行以下操作:
·编辑凭据:在目标凭据所在行单击编辑,修改凭据名称或密钥信息后单击保存。若凭据已关联模型或 MCP,修改密钥可能影响关联服务的后续调用,请确保新密钥有效。
·启用或停用凭据:在启用状态列切换开关。已关联模型或 MCP 的凭据不支持停用。
·删除凭据:仅支持删除未关联任何模型或 MCP 的凭据,且删除后不可恢复