AI连接器(MCP) {$tier_name} {eq name="mode" value="readonly"}🔒安全锁已开启· 站长手动锁定,AI 暂不能修改{/eq}

让 AI(WorkBuddy / Cursor / Claude 等)通过 MCP 协议安全管理本站。
概览 能力({$tool_count.total}) 审计日志 安全{gt name="alert_unread" value="0"}{$alert_unread}{/gt}

接入向导 3 步完成,让 AI 管理本站

1
生成 API Key
{eq name="key_tail" value=""}
AI 客户端凭这把 Key 访问本站,只显示一次,生成后立即复制保存。
{else/}
当前 Key:zanmcp_******{$key_tail} (生成于 {$key_created},仅存哈希,明文不可找回)
{/eq}
2
把配置粘到 AI 客户端
WorkBuddy / Cursor / Claude 等:复制下面配置到客户端的 mcpServers,把 <你的Key> 换成第 1 步的 Key。直连模式,无需安装 Node 或任何程序。
表单型客户端 / 接入参数详情 →
3
验证连接
对 AI 说 「hello_mcp」或暗号「{$wake_phrase}」,返回本站信息即连接成功;没反应就说「调用 MCP 工具 hello_mcp」。更多话术见「能力」页。
自定义暗号: {neq name="wake_custom" value=""}{/neq}
接多个站时给每站设不同暗号便于区分;修改后重启 AI 客户端生效。

运行状态

{$daily_used}
今天 AI 用了多少次
{eq name="tier_spec.daily_limit" value="0"}不限次数{else/}上限 {$tier_spec.daily_limit} 次/天{/eq}
{$stats.today}
今天改了网站几次
查看类操作不计入
{$stats.week}
近 7 天改了网站几次
详情见「审计日志」
{$stats.last_tool}
最近一次改动
{$stats.last_time}
{$tool_count.usable} / {$tool_count.total}
可用工具
详情见「能力」页

授权与安全锁

当前档位{$tier_name} 长期属性,由服务商开通。免费版仅查看类工具(100 次/天);询盘版与商城版解锁写操作,1000 次/天、审计保留 30 天、快照 10 份。如需更高档位请联系您的服务商。
可用工具{$tool_count.usable} / {$tool_count.total} 个(🔍 只读 {$tool_count.read} · ✏️ 写操作 {$tool_count.write},详见「能力」页)
每日调用上限{eq name="tier_spec.daily_limit" value="0"}不限量{else/}{$tier_spec.daily_limit} 次/天(今日已用 {$daily_used}){/eq}
审计日志保留{$tier_spec.log_days} 天
快照保留{eq name="tier_spec.snapshot_keep" value="0"}—(免费版不含快照){else/}{$tier_spec.snapshot_keep} 份{/eq}
安全锁 (临时开关)
这是您自己控制的开关,不是版本限制:开启不影响授权档位,可随时关闭;适合排查问题或网站交接期间,临时防止 AI 改动网站。

▼接入配置详情 直连地址 / 表单型客户端 / Codex(点击展开)

接入参数 任何支持 MCP 的客户端,传输选 Streamable HTTP,只填 URL + Key,零安装

MCP 直连地址{$mcp_url}复制
请求头X-Api-Key: <你的Key>(或 Authorization: Bearer <你的Key>,部分主机会丢弃 Authorization 头,推荐 X-Api-Key)
REST 接口地址{$api_base}复制

直连端点已内置在网站里,无需部署任何程序;虚拟主机同样可用。公网使用前建议:配置 HTTPS 证书,并到「安全」页签开启 HTTPS 强制、限流、失败锁定。

{notempty name="compat.degraded"}
版本兼容当前 CMS {$compat.cms_version},插件最低支持 {$compat.min_version};以下差异已自动适配,不影响使用:{volist name="compat.degraded" id="d"}
· {$d}{/volist}
{/notempty}

表单型客户端(如 Cherry Studio):新建 MCP 服务器,名称填 {$mcp_name},类型选 Streamable HTTP,把上表 URL 和请求头填入即可。

Codex CLI

复制到 ~/.codex/config.toml:


    

能力目录 共 {$tool_count.total} 个工具 · 当前 {$tier_name} 可用 {$tool_count.usable} 个 · 点击分组标题可折叠

{eq name="mode" value="readonly"}
🔒 安全锁已开启:{$tool_count.write} 个写操作工具被临时禁用(这是您手动开的开关,不是档位限制)。去关闭安全锁
{/eq}
不知道怎么用?直接把「你可以这样说」里的话术复制到 WorkBuddy / Cursor / Claude 对话框即可。

AI 今天干了什么 驾驶舱概览 · 只统计改动类操作

加载中…

审计时间线 AI 对网站做过的每一次修改都记录在这里(仅记录改动,查看类操作不记录)· 当前 {$tier_name} 可回溯 {$tier_spec.log_days} 天{eq name="tier_spec.snapshot_keep" value="0"} · 免费版不含快照,对比/回滚需询盘版起{/eq}

操作: 状态: 时间:至
IDAI 做了什么通过什么工具结果改动内容执行反馈来源 IP时间对比 / 回滚
加载中…

第 2 层安全设置 公网部署 / 开启 Streamable HTTP 前必做

HTTPS 强制
允许 URL 传 Key
默认只接受请求头 X-Api-Key / Authorization: Bearer。Key 放在 URL 里会被 Nginx / CDN 访问日志、浏览器历史和 Referer 记录,容易泄露;仅当你使用的 AI 客户端确实不支持自定义请求头时再开启
按 Key 限流(次/分) 超过后本分钟内拒绝请求;0 = 不限流
失败锁定 连续 次 Key 认证失败后,锁定该 IP 分钟 (防爆破;0 = 不锁定)
IP 白名单(可选)
设置后仅白名单 IP 可访问 MCP 接口;注意别把自己的出口 IP 挡在外面
可信代理 IP(可选)
MCP 默认以直连 IP 为来源,不读 X-Forwarded-For(防伪造)。站点前有 CDN / Nginx 反代 / 负载均衡时,直连 IP 是代理地址,会导致上方白名单失效、锁定与审计记的都是代理 IP;请在此填写代理的 IP / IP 段,填写后才会从它们转发的请求中读取真实客户端 IP。只能填你自己控制或信任的代理,切勿填 0.0.0.0/0
删除告警阈值(次/日) 单日删除操作达到阈值时产生告警;0 = 不告警
模板函数白名单追加(可选)
AI 通过 MCP 写模板时,只拦截本次新增或改动的可执行代码:新增的 {:函数()} 调用必须在白名单内,文件中原有写法不受影响。本站模板用到自己开发的函数、而 AI 写入时被提示“不在白名单”时,可在此追加。只追加你确认无副作用(不写文件/不写库/不执行命令/不发网络请求)的函数;命令执行、文件、网络、回调、反序列化、读配置、数据库等危险函数属于系统硬黑名单,在此填写也不会生效。保存后对之后的模板写入生效

审计告警 失败锁定 / 非白名单访问 / 频率超限 / 单日删除超阈值 / 每日限额(同类型每天最多记一条)

ID类型内容状态时间
加载中…