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

适用版本：会员插件 1.3.3 · 核对日期：2026-10-10

用途

让支持 MCP 的客户端通过站点统一服务管理会员，建立只读或按需写入的访问密钥。

前置条件

会员插件启用且产品授权有效；安装并启用 Halo MCP Server 1.x。会员插件可选依赖范围为 >= 1.0.0 且 < 2.0.0。

操作入口

控制台 → 工具 → MCP 服务。协议入口和访问密钥由 Halo MCP Server 提供。

操作步骤

1. 在工具目录找到来源为 PluginMember 的工具。
2. 创建访问密钥，只勾选实际需要的工具；只查资料时使用查询工具集合。
3. 复制 MCP 服务页面生成的客户端配置，按客户端要求配置站点 /mcp 及认证。
4. 执行 tools/list，以返回名称与 Schema 为准确认工具可见。
5. 先调用读取工具验证连接，再用独立测试业务验证所授权的写入。
6. 保存后续写入请求 ID、记录 ID 和结果，按MCP 工具指南核对。

预期结果与核对

客户端发现并调用已被密钥授权的会员工具，插件继续执行自身产品授权检查。

限制与注意事项

密钥代表站点管理工具授权，不代表某个普通会员登录身份。新增工具不会自动加入已有密钥。插件统一交易的服务令牌与 MCP 访问密钥用途不同，不能相互替代。会员工具不提供用户密码、支付配置或任意角色管理。

常见问题

• 连接成功但没有会员工具？ 查会员/MCP 插件启用、版本、密钥白名单和产品授权。
• 只读密钥不能调整积分？ 调整是独立写入工具，需明确授权。
• 配置使用 bearer_token_env_var？ 填客户端环境变量名称，并在对应环境设置密钥；不能将密钥本身误当作环境变量名。