MCP 协议接入指南：让 Claude、Cursor 直接操作你的 CMS

MCP（Model Context Protocol）是一种允许大语言模型与外部系统交互的开放协议。通过 AnQiCMS 内置的 MCP Server，你可以将内容管理能力暴露给 Claude、Cursor 等外部 AI 客户端，让它们直接执行查询、创建或更新操作，而无需人工在后台界面中逐点点击。这套机制的核心在于意图目录的统一收敛、Bearer Token 鉴权以及回合级的写操作审批流程。

MCP 协议解决了什么问题？

传统的内容管理系统需要用户登录后台，通过图形界面完成各类操作。当涉及批量处理或复杂工作流时，这种手动方式效率较低。MCP 协议的出现让 AI 助手能够理解用户的自然语言指令，并将其转化为对 CMS 的具体调用。例如，你可以告诉 Cursor「把上周发布的三篇文章标记为草稿」，AI 会通过 MCP 接口自动完成这一系列操作，无需你逐个进入编辑页面。

AnQiCMS 的 MCP Server 基于意图目录重建工具面，将分散的功能按业务域归类，使得 AI 客户端能够准确识别每个工具的用途和参数要求。这种结构化暴露方式降低了 AI 误调用的风险，同时提升了自动化流程的可预测性。

意图目录如何组织 CMS 能力？

意图目录是 AnQiCMS MCP 实现的核心组件。它将系统内的数百个功能点按照业务意图进行分组，例如内容管理、SEO 配置、站点设置等域。每个域内的工具都有明确的输入输出定义，AI 客户端可以通过读取这些元数据来判断某个工具是否适合当前任务。

这种设计带来的好处是双重的。一方面，开发者不需要为每个新功能单独编写 AI 适配层，只需将其注册到对应的意图域即可；另一方面，AI 客户端能够获得统一的工具视图，避免因为接口命名不一致而产生混淆。对于 AnQiCMS 而言，这意味着从文档查询到批量导入的各类操作都能被外部 AI 以一致的方式调用。

Bearer Token 鉴权如何保障安全？

开放 CMS 能力给外部 AI 客户端必然涉及安全问题。AnQiCMS 的 MCP Server 采用 Bearer Token 机制进行身份验证，只有持有有效令牌的请求才能访问受保护的资源。这个令牌需要在服务器端生成并分发给授权的 AI 客户端，通常通过环境变量或配置文件传递，不会出现在代码仓库或日志中。

Bearer Token 的优势在于其简洁性和广泛支持。主流的 AI 客户端如 Claude 和 Cursor 都原生支持在 HTTP 请求头中携带此类令牌。当 MCP 请求到达 AnQiCMS 时，系统会先验证令牌的有效性，再决定是否执行后续操作。这种方式既避免了复杂的 OAuth 流程，又保证了接口不会被未授权方滥用。

回合级审批如何防止误操作？

写操作的风险远高于读操作，因此 AnQiCMS 引入了回合级审批机制。当 AI 客户端计划执行一系列修改（如批量更新文章状态、删除旧内容等）时，MCP Server 会将这些操作合并为一个批次，并在执行前向用户展示确认清单。用户可以选择批准整个批次，也可以拒绝其中特定的步骤。

这种设计平衡了自动化效率与人工监督的需求。对于只读查询，AI 可以直接返回结果；但对于可能影响线上数据的变更，系统始终保留最终的人工审批环节。回合级审批的实现依赖于 MCP 协议的会话状态管理，确保同一轮对话中的多个工具调用能够被正确归组和追溯。

如何在 Cursor 中接入 AnQiCMS 的 MCP？

以 Cursor 为例，接入 AnQiCMS 的 MCP Server 需要以下步骤。首先在 AnQiCMS 后台生成一个 Bearer Token，并将其保存到本地环境变量中。然后在 Cursor 的配置文件中添加 MCP 服务器的地址和认证信息，通常是一个 JSON 格式的端点描述。重启 Cursor 后，你可以在对话中直接提及 CMS 相关的操作，AI 会自动识别可用的 MCP 工具并发起调用。

需要注意的是，高危域的操作（如备份、升级、多站点管理等全站级操作）在 AnQiCMS 中默认处于关闭状态，需要在后台显式开启后才能通过 MCP 暴露。这一设计进一步降低了意外触发危险操作的可能性。

常见问题

问：MCP 协议与传统的 REST API 有什么区别？

答：REST API 侧重于资源层面的 CRUD 操作，需要调用方自行组装请求逻辑。MCP 则在语义层面暴露业务意图，AI 客户端可以理解「发布文章」「推送链接」这样的高层概念，而不必关心底层的 URL 结构和参数格式。

问：如果 AI 误解了我的指令怎么办？

答：回合级审批机制会在执行前展示操作清单，你可以在此阶段发现并纠正误解。此外，建议首次接入时先用只读操作测试 AI 的理解准确性，确认无误后再开放写权限。

问：AnQiCMS 的 MCP Server 支持哪些 AI 客户端？

答：目前已知兼容的客户端包括 Claude、Cursor 等主流产品。只要该客户端支持 Model Context Protocol 标准并能在 HTTP 请求中携带 Bearer Token，理论上都可以接入 AnQiCMS。