Halo MCP 使用指南：让 AI 直接管理你的博客

AI 创作声明：本文由人工智能（AI）创作并整理，仅用于功能测试与使用参考。实际操作前，请结合你的 Halo 版本、插件配置和权限策略进行核对。

Halo MCP 是连接 AI 助手与 Halo 内容管理系统的一座桥梁。配置完成后，用户可以通过自然语言让 AI 查询文章、创建草稿、发布内容、管理分类与标签，甚至处理评论、附件、独立页面和主题设置，从而减少在控制台中重复点击和填写表单的工作。

一、什么是 MCP

MCP（Model Context Protocol，模型上下文协议）是一种让大语言模型以标准方式访问外部工具和数据的协议。对于 Halo 而言，MCP 服务会把常见的站点管理能力封装成工具，例如：

• 查询、创建、更新和发布文章；

• 管理独立页面、分类与标签；

• 上传、读取和删除附件；

• 审核评论及回复；

• 查询并修改主题配置；

• 管理特定插件提供的功能。

AI 不再只是输出一段可复制的文字，而是能够在获得授权后直接完成操作。

二、使用前的准备

1. 准备可用的 Halo 站点

确保 Halo 站点运行正常，并且你拥有足够的管理权限。不同 MCP 服务端或插件对 Halo 版本可能有不同要求，部署前应先阅读对应项目的说明。

2. 配置 MCP 服务

在支持 MCP 的客户端中添加 Halo MCP 服务，并按要求填写站点地址、访问密钥或其他认证信息。配置参数应以你正在使用的服务端文档为准。

建议遵循以下安全原则：

• 仅授予完成任务所需的最小权限；

• 不要在聊天内容、截图或公开仓库中暴露访问密钥；

• 优先通过 HTTPS 连接站点；

• 定期轮换密钥，并及时撤销不再使用的凭据；

• 正式站点执行批量修改前，先备份数据。

3. 检查工具连接

连接成功后，可以先执行只读操作进行验证，例如：

• “列出最近 10 篇文章”；

• “查询名称为‘测试’的分类和标签”；

• “列出附件库中的前 20 个文件”；

• “查看当前主题有哪些设置分组”。

如果 AI 能返回站点中的真实数据，通常说明连接和基础权限已经生效。

三、常见使用场景

场景一：创建并发布文章

你可以直接描述文章主题、结构和发布要求：

写一篇关于 Halo 备份策略的文章，使用 Markdown，分类和标签都设为“测试”，从附件库选择一张图片作为封面，先保存为草稿。

AI 通常会依次完成：

1. 查询分类与标签，获得对应资源名称；

2. 查询附件库并选择图片；

3. 生成标题、正文、摘要和别名；

4. 创建文章；

5. 根据要求保存草稿或直接发布。

如果文章已经存在，还可以让 AI 读取原文后定向修改，例如：“保留文章结构，只重写第三节，并更新摘要。”

场景二：管理分类和标签

自然语言指令可以减少手动维护成本，例如：

• “创建一个名为‘技术笔记’的分类”；

• “为最近发布的三篇 Docker 文章添加‘容器’标签”；

• “列出所有没有文章的标签”。

需要注意的是，Halo 内部通常使用资源名称标识分类和标签，而不是只依赖显示名称。AI 应先查询并确认目标资源，避免把同名项目混淆。

场景三：管理评论

在具备相应工具和权限时，可以让 AI：

• 查询待审核评论；

• 按关键词筛选评论；

• 批准正常评论；

• 删除垃圾评论或回复。

删除属于不可逆或高风险操作。更稳妥的做法是要求 AI 先列出目标和原因，待人工确认后再执行。

场景四：处理附件

Halo MCP 可以帮助查询附件、上传本地内容，或将指定网络图片转存至附件库。典型指令包括：

• “从附件库选择一张横向图片作为文章封面”；

• “把这个图片 URL 转存到 Halo 附件库”；

• “列出体积最大的 20 个附件”。

使用第三方图片时，应确认授权范围、署名要求和可商用条件，不能因为工具能够下载就忽略版权。

场景五：调整主题设置

部分 Halo MCP 实现支持读取和修改当前主题的设置。推荐流程是：

1. 列出当前主题的设置分组；

2. 读取目标分组的字段结构和现有值；

3. 只修改明确指定的字段；

4. 保存后检查前台效果。

主题字段由主题作者定义，不同主题之间不能照搬配置。修改前还应记录旧值，以便出现问题时回退。

四、怎样写出更可靠的指令

一条清晰的指令最好包含以下信息：

• 任务对象：文章、页面、附件、评论还是主题；

• 操作类型：查询、创建、更新、发布或删除；

• 内容要求：主题、篇幅、格式、语气和必要声明；

• 元数据：分类、标签、摘要、封面和可见性；

• 发布状态：草稿、立即发布或定时发布；

• 确认规则：哪些步骤可以直接执行，哪些必须先询问。

例如：

创建一篇 1500 字左右的 Markdown 教程，标题围绕 Halo MCP 入门，分类和标签都使用“测试”，从附件库选择图片作为封面，正文开头注明由 AI 创作；创建后直接公开发布，并返回执行结果。

这类指令目标明确，AI 更容易一次完成。

五、推荐的安全工作流

即使 MCP 能自动执行操作，也不建议对所有任务都采用“无需确认、直接执行”的方式。可以按风险分级：

• 低风险：查询文章、查看附件、读取主题配置，可直接执行；

• 中风险：创建草稿、更新摘要、添加标签，可执行后汇报；

• 高风险：公开发布、批量更新、修改主题、删除内容，应先预览或确认；

• 关键操作：永久删除、批量清理、恢复默认模板，应保留人工确认步骤。

此外，重要操作完成后应再次查询目标资源，核对标题、状态、分类、标签、封面与正文是否符合要求，不要仅以工具返回“成功”作为唯一判断依据。

六、常见问题排查

找不到分类或标签

先列出全部项目并检查显示名称、内部名称和别名。若目标不存在，再根据权限决定是否创建，避免生成重复项目。

创建成功但没有发布

检查创建参数中的发布状态，或调用发布工具将当前文章版本发布。若设置了未来时间，还要确认是否变成了定时发布。

封面无法显示

确认附件是图片类型，并优先使用 Halo 返回的永久访问地址。相对路径能否正常显示，还取决于站点域名、反向代理和主题处理方式。

更新后前台内容没有变化

Halo 可能区分编辑中的 HEAD 内容和已发布的 RELEASE 内容。更新后如果没有重新发布，前台可能仍展示旧版本；同时也可以检查页面缓存和 CDN 缓存。

操作被拒绝

通常与访问凭据、资源权限、服务端策略或参数格式有关。先尝试只读请求，再逐步检查密钥有效性、权限范围和 MCP 服务日志。

七、总结

Halo MCP 把内容管理能力转化为可由 AI 调用的标准工具，让“写文章—选封面—设置分类标签—发布”这一整套流程能够通过自然语言完成。它尤其适合内容草稿生成、批量信息整理、日常站点巡检和重复性后台操作。

自动化越强，权限和审核越重要。实际使用时应坚持最小权限、敏感操作确认、重要数据备份和执行结果复核，才能在提升效率的同时保护站点安全。

本文由 AI 创作并发布，用于 Halo MCP 功能测试。