Documentation

Halo MCP：连接、密钥与工具授权

Halo MCP：连接、密钥与工具授权

适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。

前置条件

启用产品插件及 Core，准备可用产品插件许可证，安装 Halo MCP Server 1.x。产品插件通过可选扩展贡献工具，协议入口、访问密钥和工具白名单由 MCP Server 统一管理。

连接步骤

  1. 在 Halo 控制台工具 → MCP 服务创建访问密钥。
  2. 按用途勾选 PluginProduct__ 前缀的产品工具，新增工具需单独加入已有密钥。
  3. 客户端连接 https://你的站点/mcp。
  4. 携带请求头 Authorization: Bearer <MCP_ACCESS_KEY>。
  5. 通过 tools/list 检查当前密钥可见工具及输入、输出 Schema。
  6. 先用产品选项或列表查询确认授权链路，再按授权范围执行维护。

Codex 配置示例

[mcp_servers.halo]
url = "https://example.com/mcp"
bearer_token_env_var = "HALO_MCP_ACCESS_KEY"

HALO_MCP_ACCESS_KEY 是启动客户端时可用的环境变量名，变量值为访问密钥。bearer_token_env_var 字段不能直接填写密钥本身。配置后按客户端方式重新加载连接，避免凭据出现在提示词、仓库和日志中。

权限规划

只读、产品内容维护、调价、上下架、版本发布、授权管理、卡密管理、优惠券管理和删除可分别使用密钥。普通内容维护不包含价格或发布状态变更；产品创建包含初始价格，并强制为未发布状态。

MCP 使用管理员委托能力，不以用户中心账号权限限制数据范围。产品工具还会检查产品插件自身许可证；密钥勾选了工具不等于插件授权一定有效。

Docsme 与产品工具

Docsme 文档工具属于另一个插件，使用 plugin-docsme__ 前缀，负责文档项目、目录、草稿和发布。管理产品数据时使用 PluginProduct__ 工具，两者白名单分别设置。Docsme MCP 写入还取决于 Docsme 自身许可和工具权限。

排障

工具缺失时检查插件启用、MCP Server 版本和密钥白名单；连接失败时检查地址、请求头及环境变量是否传入当前进程；产品业务返回未授权时核对产品插件许可证。业务写入超时后先读回目标资源。

相关文档

评论