直接从 Claude 发布 — API 与 MCP

MiraiPage 无需打开浏览器即可操作。它提供了 REST API，并且 MCP 服务器已内置于主体中，因此你可以直接向 Claude Code 这样的 AI 代理说"帮我写篇文章并发布"。配置只需 3 分钟。

前提条件：Premium 计划

API 访问是 Premium 计划的专属功能，Free 和 Pro 计划无法使用。

步骤 1：生成 API Token

在设置页面的"API Token"栏中生成 Token。填写名称并创建后，仅在当时显示一次原始字符串。

该字符串之后不会再次显示。服务器端只保存哈希值，因此我们也无法为你恢复。请务必在当时复制并保存到密码管理器等工具中。

每个账户最多可持有 10 个 Token。建议按用途分别生成，不再需要时及时使其失效。也可以为 Token 设置有效期。

步骤 2：先验证连通性

curl https://www.miraipage.net/api/v1/me \
  -H "Authorization: Bearer 你的Token"

如果返回了你的用户名和计划信息，则说明成功。

步骤 3：尝试发布文章

curl -X POST https://www.miraipage.net/api/v1/posts \
  -H "Authorization: Bearer 你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "APIから投稿してみた",
    "content": "## 見出し\n\n本文です。",
    "status": "draft",
    "category": "development",
    "tags": ["API"]
  }'

将 status 设置为 draft 即可创建草稿，可以放心测试。正式发布时改为 published。

API 文档的认证栏。①为请求中需附带的 Header，②为所需计划。

重点：通过 MCP 连接 Claude

这才是重头戏。MiraiPage 内置了 HTTP 类型的 MCP 服务器，端点为 https://www.miraipage.net/api/mcp。

无需另行搭建服务器，也无需安装 npm 包。

在 Claude Code 中注册

claude mcp add -t http miraipage "https://www.miraipage.net/api/mcp" \
  -H "Authorization: Bearer 你的Token"

如果希望在所有项目中使用而非仅限当前项目，请添加 -s user。

claude mcp add -s user -t http miraipage "https://www.miraipage.net/api/mcp" \
  -H "Authorization: Bearer 你的Token"

也可以直接写入配置文件。

{
  "mcpServers": {
    "miraipage": {
      "url": "https://www.miraipage.net/api/mcp",
      "headers": {
        "Authorization": "Bearer 你的Token"
      }
    }
  }
}

注册后能做什么

注册后，你将可以使用 43 个工具，以下列举主要功能：

• 文章 — 列表、获取、创建、更新、删除
• 图片 — 上传并嵌入文章
• 幻灯片 — 获取、替换演示文稿，以及按节插入和删除
• 翻译 — 翻译文章 / 替换译文
• 系列 — 创建、更新、关联文章
• 社群 — 创建、更新话题，发布和获取消息
• 活动 — 列表、获取、预约
• 个人资料 — 修改自我介绍和链接集合
• Webhook — 注册、删除
• 互动 — 点赞、评论、关注

实际使用方式

注册后，直接用自然语言提出请求即可。

"把这份调查结果写成文章，先存成草稿。"

"把刚才那篇文章翻译成英文。"

"只替换幻灯片的第 3 张。"

代理会自动选择对应的工具并执行。由于可以将本地文件或终端输出直接转化为文章，工作记录直接变成文章这种用法变得切实可行。

安全使用须知

• Token 请按用途分开生成，一旦泄露可将影响范围降至最小
• 配置自动发布流程时，先以 status: "draft" 运行并人工确认结果，再切换为 published
• 不再需要的 Token 请在设置页面及时使其失效

与 Webhook 结合使用

MiraiPage 可在文章创建、更新、发布、取消发布、删除时触发 Webhook。

你可以接收 post.published 事件后自动推送到社交媒体，或通知企业内部聊天工具。用 MCP 写作，用 Webhook 分发——这样就能将发布前后的流程全部自动化。

下期将介绍社群聊天中内置的全部 AI 命令。