Halo MCP 连接、密钥与工具授权
适用版本：会员插件 1.3.3 · 核对日期：2026-10-10
用途
让支持 MCP 的客户端通过站点统一服务管理会员，建立只读或按需写入的访问密钥。
前置条件
会员插件启用且产品授权有效；安装并启用 Halo MCP Server 1.x。会员插件可选依赖范围为 >= 1.0.0 且 < 2.0.0。
操作入口
控制台 → 工具 → MCP 服务。协议入口和访问密钥由 Halo MCP Server 提供。
操作步骤
- 在工具目录找到来源为
PluginMember的工具。 - 创建访问密钥，只勾选实际需要的工具；只查资料时使用查询工具集合。
- 复制 MCP 服务页面生成的客户端配置，按客户端要求配置站点
/mcp及认证。 - 执行
tools/list，以返回名称与 Schema 为准确认工具可见。 - 先调用读取工具验证连接，再用独立测试业务验证所授权的写入。
- 保存后续写入请求 ID、记录 ID 和结果，按MCP 工具指南核对。
预期结果与核对
客户端发现并调用已被密钥授权的会员工具，插件继续执行自身产品授权检查。
限制与注意事项
密钥代表站点管理工具授权，不代表某个普通会员登录身份。新增工具不会自动加入已有密钥。插件统一交易的服务令牌与 MCP 访问密钥用途不同，不能相互替代。会员工具不提供用户密码、支付配置或任意角色管理。
常见问题
- 连接成功但没有会员工具？ 查会员/MCP 插件启用、版本、密钥白名单和产品授权。
- 只读密钥不能调整积分？ 调整是独立写入工具，需明确授权。
- 配置使用 bearer_token_env_var？ 填客户端环境变量名称，并在对应环境设置密钥；不能将密钥本身误当作环境变量名。