内容管理系统要接 AI 客户端,先开哪层权限

内容管理系统要接 AI 客户端,先开哪层权限?按能力域开,不按页面开。第一层是给外部客户端的只读查询,比如文档列表、分类与标签;第二层是写入类操作,必须走逐回合确认;第三层是全站级动作,如备份、升级、多站点管理,默认保持关闭。AnQiCMS 内置 MCP Server,工具面基于意图目录统一收敛,支持鉴权与回合级操作审批,可以被 Claude、Cursor 这类外部 AI 客户端接入,这套顺序就是围绕这三项能力排的。

先明确一层概念:意图目录

意图目录的作用是把散落的接口按「要做的事」归组,每组有自己的暴露范围。接入时你不需要逐个工具去挑,而是按域决定开哪些能力。这样做的直接好处是权限边界可审计:一旦某个域出问题,关掉这一域就行,不必回滚整条接入。

对第一次接入的站点,建议只开文档与分类这一个读域。写域(发布、修改、删除)在只读跑通、确认调用方不会误伤内容之前不要动。

接入前要核对的三项配置

  • 鉴权方式:接入用的凭证要走服务端校验,且和后台管理员口令分开,AI 客户端被入侵时不会连带后台。
  • 审批粒度:写操作要合并到回合级确认,即一次对话回合内的多次改动集中给你审一次,而不是每步静默执行,也不是每步都弹窗打断。
  • 暴露范围:高危域默认关闭,需要显式开启。开启前想清楚这个域被误调用的后果能否承受。

分层顺序与对应动作

层级 典型能力 建议状态 开启前确认
只读查询 文档列表与详情、分类与标签、系统联系方式 先开 是否会返回未发布内容
内容写入 新建与修改文档、上传配图、留言与评论处理 审批后再开 每回合是否有合并确认
全站动作 备份与恢复、版本升级、多站点切换 默认关闭 误调用后果能否承受

这张表的读法很简单:越往下,单次误操作的爆炸半径越大。只读层出问题最多是看到了不该看的内容;写入层出问题会改动线上页面;全站层出问题影响的是整台站点。

接口调用侧要自查什么

开放接口能力时,把接口文档留在自己站点里比留一份口头说明更可靠。调用方最常见的三类问题:不知道某个字段能否为空、不知道未发布内容会不会被返回、不知道限流规则。这三项在接口文档里写清楚,能省掉大部分来回沟通。AnQiCMS 的高频调用能力集中在文档列表与详情、分类与标签、上传图片、留言与评论、友情链接、系统设置与联系方式,接入方按这份清单核对即可。

站内还有 AI Chat 与 AI 工具集,日常运维动作可以在系统内部完成,不必全部暴露给外部客户端。这也是分层的一个判断标准:能在内部闭环的操作,优先不开给外部。

上线一周后的复查

复查三件事:调用日志里有没有超出预期的写操作、有没有触及关闭的域被尝试调用、审批确认是否被无脑通过。第三项最容易被忽略,长期一键通过等于没有审批。建议把审批记录当审计线索保存,并在第一次批量任务前用小规模样本试跑。

常见问题

只开只读层有用吗? 有用,问答类场景大多只需要读取内容列表与详情,写入交给站内流程反而更稳。

回合级审批会不会拖慢批量操作? 一次回合内的多步改动合并成一次确认,批量导入这类任务仍然连贯,只是在你眼前过一遍。

高危域以后能不能再开? 可以,它是按域显式开启的开关,不是一次性决定。建议开之前先确认备份可用。

接第三方客户端要不要给它管理员权限? 不要,接入凭证与后台管理员身份分开,权限只覆盖这次合作真正需要的域。