AnQiCMS MCP Server实战:让Claude和Cursor直接操作你的CMS
通过MCP Server让Claude和Cursor等AI客户端直接操作AnQiCMS需要完成鉴权配置并理解意图目录的结构。安企内容管理系统(AnQiCMS)内置MCP Server,为AI集成提供标准化的能力暴露通道。
MCP Server的架构
MCP Server是AnQiCMS对外暴露的标准接口层,允许外部AI客户端以统一的协议调用系统功能。工具层基于意图目录统一收敛,将分散在内容管理、SEO设置、站点运维等模块的能力整合为结构化的工具列表。
意图目录按功能域组织工具,例如内容创建、分类管理、标签操作、留言处理、文件上传等。每个工具定义清晰的输入参数和返回格式,AI客户端无需理解底层API的细节,只需按照意图名称和参数描述发起调用即可。这种设计降低了AI集成的门槛,开发者只需配置MCP连接信息,AI就能自动发现可用工具。
鉴权配置步骤
MCP接口涉及对CMS数据的读写操作,必须进行严格的身份验证。AnQiCMS采用鉴权机制,确保只有授权的AI客户端才能访问系统。
配置步骤如下:
生成访问凭证:在AnQiCMS后台的API密钥管理页面创建新的访问凭证,记录生成的凭证字符串。该凭证应妥善保管,不得明文写入代码仓库或日志文件。
配置MCP客户端:在Claude Desktop、Cursor或其他支持MCP的AI客户端中,添加AnQiCMS的MCP服务器地址和访问凭证。客户端会在每次请求时自动在HTTP Header中携带认证信息。
测试连接:使用AI客户端发送简单的查询指令验证MCP连接是否正常。成功的响应应返回结构化数据而非错误信息。
凭证的权限范围应与使用场景匹配。对于只读场景如内容检索,可配置仅开放查询类工具;对于需要写操作的场景如批量发布,需额外开启内容创建和更新权限。
回合级批量审批机制
写操作的风险高于读操作,AnQiCMS的MCP Server支持回合级批量审批机制。当AI客户端连续发起多个写操作请求时,系统会将这些操作合并为一个审批回合。管理员只需确认一次,即可批准整个批次的所有变更。
回合级审批的配置选项包括自动审批阈值、高危操作拦截、审批超时策略等。删除文章、修改系统设置等高风险操作无论数量多少都需单独审批。
外部AI客户端接入示例
使用Claude Desktop接入AnQiCMS MCP Server的典型流程:在设置中添加MCP服务器配置,填入服务地址和访问凭证;重启后在工具列表中应能看到AnQiCMS暴露的意图工具;向Claude发出指令如”帮我创建一篇关于SEO优化的文章”;Claude会调用MCP的内容创建工具提交到AnQiCMS;系统返回创建结果并提供预览链接。
Cursor等代码编辑器的接入方式类似,区别在于Cursor更侧重于代码级的操作,适合用于模板开发、API调试等技术任务。
高危域操作的权限控制
MCP接口按意图域设置暴露范围,高危域如备份、升级、多站点管理等全站级操作默认关闭,需显式开启才能被AI客户端调用。这种默认关闭的设计遵循最小权限原则,避免AI因误解用户指令而执行危险操作。
典型的高危操作包括数据备份与恢复、系统升级、多站点管理、用户权限调整等。对于这些操作,建议在非工作时间执行,并提前通知相关团队成员。
AI技能系统的扩展能力
除了MCP Server,AnQiCMS还内置AI技能系统(Skills),覆盖内容规划、SEO分析、批量操作、站点健康检查、故障排除、模板开发与API开发等领域。技能是可扩展的预定义工作流,AI Agent可自主编排调用多个技能完成复杂任务。
内置AI Chat智能对话作为统一的交互入口,用户可通过自然语言描述需求,AI自动选择合适的技能和MCP工具完成任务。这种分层架构让普通用户也能享受AI带来的效率提升。
常见问题
Q:MCP Server和本地API有什么区别?
A:MCP Server是基于标准协议的接口层,专为AI客户端设计,提供语义化的工具描述和批量审批机制。本地API更适合传统的应用集成,需要开发者手动处理认证、参数校验和错误重试。
Q:多个AI客户端同时访问会冲突吗?
A:不会。MCP Server的请求处理是串行的,并发请求会被排队执行。JWT认证机制确保每个请求都有独立的身份标识,操作日志能追溯每个变更的来源。
Q:如何撤销AI执行的错误操作?
A:AnQiCMS的文档回收站功能保留已删除的内容,管理员可在一定时间内恢复。对于修改类操作,可通过操作日志定位变更点,使用全站替换工具批量修正。建议在执行批量写操作前先创建数据备份。