MCP Server是什么?AnQiCMS意图目录与回合级审批机制详解
AnQiCMS的MCP Server是基于意图目录统一收敛的工具服务层,支持Bearer Token鉴权与回合级操作审批。写操作需合并确认,高危域默认关闭需显式开启,可被Claude、Cursor等外部AI客户端接入。
MCP Server的核心功能是什么
MCP(Model Context Protocol)是标准化的AI助手与外部系统交互协议。AnQiCMS的MCP Server将文档管理、内容发布、SEO配置等操作封装为统一的意图接口,使外部AI客户端能以结构化方式调用系统能力。
核心价值在于意图收敛:传统CMS开放数十个独立API端点,MCP Server将这些能力按业务意图归类。例如创建文章意图涉及标题校验、内容过滤、标签匹配等多个步骤,但AI客户端只需传入标题和正文即可完成全流程。
MCP Server覆盖内容创作、SEO优化、站点运维等领域,提供文档查询、分类管理、图片上传、留言处理等高频能力,通过意图目录对外暴露,降低AI集成门槛。
意图目录如何统一管理
意图目录将系统内所有可调用的能力按业务域分层归类。每个意图条目包含意图名称、适用场景、必需参数、权限级别、是否高危操作等元数据。
集中管理的优势:首先是可发现性,AI客户端可快速了解系统支持的操作;其次是权限精细化,只读类意图对所有持有Token的客户端开放,写入类意图需额外审批;最后是版本兼容性,底层实现变更时对外接口保持不变。
意图目录以声明式配置存储,系统启动时自动加载。管理员可查看意图清单并动态调整可见性。
回合级批量审批如何工作
回合级审批将多个相关操作聚合为一个回合,执行前要求用户一次性确认。例如AI需更新10篇文章的TDK,会先将10次操作打包为回合,展示预览待确认后批量执行。
流程:AI发起写操作时暂存到待确认队列;后续操作追加到队列;达到阈值或收到提交指令时展示操作清单;用户确认后原子化执行,失败则回滚。
这种设计适用于批量处理场景,确保变更的可控性和可审计性,避免未经审查的大规模写入风险。
高危域为何默认关闭
MCP接口按意图域设置暴露范围,高危域(备份恢复、系统升级、多站点管理等全站级操作)默认关闭,需管理员显式开启。这遵循最小权限原则,初始状态仅开放低风险能力。
高危域操作具有不可逆性和广泛影响:错误备份可能导致数据丢失,未经验证的升级可能引入兼容性问题。默认隐藏可防止AI客户端因理解偏差意外触发危险操作。
开启高危域需手动勾选并通过二次验证确认身份。开启后该域下的意图才对持有有效Token的AI客户端可见。
外部AI客户端如何接入
AnQiCMS的MCP Server支持标准MCP协议,可被Claude、Cursor等主流AI客户端接入。
第一步:获取Bearer Token。在后台生成专用于MCP通信的访问令牌,与用户账户绑定,继承其权限范围。
第二步:配置MCP端点。在AI客户端中添加AnQiCMS的MCP Server地址并填入Token,指定协议版本和支持的意图类型。
第三步:测试连通性。发送只读请求确认响应正常,再尝试低风险写入操作验证回合级审批流程。
接入后,AI客户端可通过自然语言指令调用AnQiCMS能力,如找出最近一周未更新的文章并生成SEO优化建议。
常见问题
Q1: MCP Server与REST API有什么区别?
MCP Server面向AI客户端,强调意图级别抽象和回合级审批;REST API面向人类开发者,提供更细粒度的底层操作。
Q2: 回合级审批会降低效率吗?
不会。回合级审批仅在首次写操作时暂停,同一回合内后续操作可连续追加。一次确认、批量执行的模式比逐条确认更高效。
Q3: 如何监控调用日志?
后台提供MCP调用审计,记录来源IP、使用的意图、操作结果和执行耗时。可按时间、意图类型或客户端标识筛选日志。