最近折腾了个挺顺手的组合：Halo 官方出的 mcp-server 插件 + WorkBuddy，直接把博客接到 AI 工具上。之后让它发文章、改文章、看评论，都不用来回抓接口了。

这篇记录一下怎么配的，免得下次忘。

先装插件

Halo 后台 → 应用市场里搜 mcp-server，装上 v1.0.0-beta.1 这个版本，启用。

然后去插件设置里生成访问密钥——它给的是一个 hmcp_ 开头、老长的一串。密钥只在生成时显示一次，记得存好。

我一开始没找对路子，以为要在客户端这边跑个本地 npm 包去连 Halo 的 API，配到一半才反应过来：Halo 自己就能当 MCP 服务端，直接暴露 /mcp 端点，省事多了。

WorkBuddy 这边

WorkBuddy 的连接器管理页，右上角「自定义连接器」入口，加一个：

• 类型：HTTP（远程）
• 地址：https://你的域名/mcp
• 认证头：Authorization: Bearer hmcp_你的密钥

保存后点「信任」启用，完事。

它底层写进 ~/.workbuddy/mcp.json 的大概长这样，别的 MCP 客户端（Claude Desktop、Cursor 之类）也通用：

{
  "mcpServers": {
    "halo": {
      "type": "http",
      "url": "https://www.lqbby.com/mcp",
      "headers": {
        "Authorization": "Bearer hmcp_xxx"
      }
    }
  }
}

验证

配完让 AI 调一个 halo_list_posts，能列出文章就说明通了。我这边直接返回了 6 篇文章，每篇的 slug、封面、分类标签、发布时间一次全给，还挺全。

插件 1.0.0-beta.1 的能力清单：

• 文章：列表 / 详情 / 创建 / 更新 / 发布 / 回收
• 单页、分类、标签：都能管理
• 评论、回复、附件：也摸得到

踩过的两个小坑

1. 端点就是根路径 /mcp。别去猜 /apis/api.mcp.halo.run/... 这种路径，那些返回 401，纯绕路。
2. 必须 POST。拿 GET 探 /mcp 会得到 405，那是正常的——MCP 协议本身就是 POST + JSON-RPC，405 恰好说明端点存在，只是方法不对。

用起来什么感觉

目前最爽的是发文章流程：本地写好 Markdown → AI 直接创建成 Halo 草稿 → 我后台过一眼再发布。以前要么在后台手动粘贴再调格式，要么写脚本调 API，现在一句话的事。

对博客这个使用场景来说，够用且干净。期待插件后续加更多工具。