zblogMcp功能说明

面向Z-BlogPHP的AI内容管理与MCP接入插件

本文说明 zblogMcp的用途、后台功能、权限模型、MCP工具和接入方式，帮助站长完成插件配置并安全地将博客能力接入AI 客户端。

1.一 插件简介

zblogMcp是一个用于连接 Z-BlogPHP与 AI 客户端的MCP 服务插件。插件启用后，支持MCP 协议的客户端可以在ApiKey授权范围内访问和管理博客文章、分类、标签、媒体及评论。

2.二 主要功能

1 ApiKey 管理

新增、编辑、删除ApiKey，并支持启用和禁用。

为 ApiKey添加备注，区分不同 AI客户端或使用场景。

在后台显示或隐藏完整ApiKey，并一键复制。

一键生成包含 MCP地址和 Bearer Token的客户端配置。

2 权限控制

每个 ApiKey都可以单独配置权限。建议按客户端用途创建ApiKey，并只开启必要的权限。

3 MCP 服务接口

服务端点：

/zb_users/plugin/zblogMcp/mcp.php

插件通过标准 MCP协议提供以下工具：

4 MCP 请求日志

记录请求方法、接口、状态码、响应时间、ApiKey、IP和创建时间。

支持查看日志详情，删除单条日志或清空日志。

支持按配置自动清理超过指定天数的旧日志。

可以关闭日志记录，或单独控制是否记录请求体和响应体。

日志中的 ApiKey等敏感字段会进行脱敏处理。

5 文章扩展字段

插件配置支持填写文章 Meta字段说明。配置字段名称、类型和用途后，AI客户端可以根据说明读取或写入主题及其他插件使用的自定义数据。

3.三 后台菜单

ApiKey管理：查看和管理所有 ApiKey。

新增 ApiKey：创建ApiKey 并设置权限。

MCP日志：查看和维护接口调用日志。

插件配置：配置日志开关、日志保留天数和默认文章状态。

接入配置：查看 MCP地址和客户端接入信息。

关于：查看开发者信息、快速开始说明和赞助开发者链接。

4.四 接入方式

在支持远程 MCP服务的 AI 客户端中添加以下配置，并将YOUR_API_KEY 替换为后台创建的ApiKey：

{
"mcpServers": {
   "zblog": {
    "url": "http://your-domain/zb_users/plugin/zblogMcp/mcp.php",
   "headers": {
       "Authorization": "Bearer YOUR_API_KEY"
     }
   }
 }
}

在 Z-BlogPHP后台启用 zblogMcp 插件。

进入“新增 ApiKey”，填写名称并设置权限。

确认 ApiKey处于启用状态。

将 MCP地址和 Bearer Token 配置到AI 客户端。

让 AI客户端刷新 MCP工具列表并开始调用。

5.五 配置说明

6.六 安全建议

不要把 ApiKey提交到公开代码仓库、文章或截图中。

生产环境建议使用 HTTPS，避免Bearer Token 明文传输。

为只读客户端关闭文章写入、分类、标签、媒体和评论权限。

定期禁用或删除不再使用的ApiKey。

根据实际需要设置日志内容记录，避免保存过多业务数据。