Caelo CMS

Name: Caelo CMS
Author: caelo-cms

本地服务

caelo-cms.com商业与营销2今天更新

代码仓库访问官网

关于 Caelo CMS

Caelo CMS 提供 MCP 服务，可通过其聊天 Agent 编辑 Caelo 网站，也可让外部 Agent 调用管理工具目录。请求会转发到站点 API，变更先进入草稿，须经人工批准后发布。

主要功能

01通过聊天向 Caelo Agent 请求编辑
02向外部 Agent 提供管理工具
03上传供 CMS 使用的图像
04导出安装专属 CLAUDE.md 和技能
05读取实时管理工具目录

适用场景

01请 Caelo Agent 修改网站内容
02让外部编码 Agent 操作管理工具
03将图像附加到聊天或用作媒体资源
04为 Claude Code 导出站点上下文

MCP 相关

MCP 服务根据令牌范围提供 `caelo_chat` 界面或管理工具目录。它通过 stdio 连接，并将调用转发为发往 Caelo 安装实例的 HTTPS 请求；编辑结果先成为草稿，发布前需要人工批准。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "caelo-cms-caelo": {
      "command": "npx",
      "args": [
        "-y",
        "@caelo-cms/mcp-server"
      ],
      "env": {
        "CAELO_ADMIN_URL": "<CAELO_ADMIN_URL>",
        "CAELO_MCP_TOKEN": "<CAELO_MCP_TOKEN>",
        "CAELO_IAP_SERVICE_ACCOUNT": "<CAELO_IAP_SERVICE_ACCOUNT>"
      }
    }
  }
}

启动命令npx -y @caelo-cms/mcp-server

需要配置的环境变量

CAELO_ADMIN_URLYour Caelo admin's https:// address, e.g. https://admin.example.com

CAELO_MCP_TOKEN密钥MCP token minted at /settings/mcp on your install

CAELO_IAP_SERVICE_ACCOUNTOnly for Google Cloud (IAP) installs; /settings/mcp shows the value

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@caelo-cms/mcp-server0.11.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

`@caelo-cms/mcp-server`

适用于 Caelo CMS 安装的 MCP 服务。根据令牌的范围选择两种接入方式：

caelo_chat（默认模式，范围为 chat）——与 Caelo 自有的 AI Agent 通信。你描述目标；Caelo 的 chat-runner 会完成工作。
Power-MCP（caelo-admin-mcp 二进制文件 / caelo-mcp-server admin，范围为 admin）——直接公开完整的 chat-runner 工具目录，由你的 Agent（Claude Code 等）驱动工具循环，Caelo 自身不会调用任何提供商。caelo-mcp-server export 还会根据安装实例的实时上下文生成 CLAUDE.md 和 .claude/skills/ 目录树。

每种模式都是一个轻量封装：调用会通过 HTTPS POST 请求发送到管理端安装实例的 /api/mcp/* 端点，这些端点会分发到与实时编辑覆盖层相同的 chat-runner 机制中。有关 Power-MCP 的完整工作模型（工作会话、共享草稿、审批关卡），请参阅文档中的 MCP 页面。

安装

在你的 Caelo 安装实例中：

以 Owner 身份访问 /settings/mcp。
点击 New token，为令牌命名（claude-code、laptop、ci 等），可选设置 AI 支出上限（微美分），然后复制仅显示一次的 bearer。
页面会显示可直接复制的 Claude Code、Claude Desktop、Codex CLI、Cursor、VS Code 和 Gemini CLI 配置——终端命令或 JSON 配置项，以及客户端如何读取配置。

桌面应用（Claude Desktop、Cursor、VS Code）不会继承终端的 PATH：请在其配置中填入 bunx 的完整路径（which bunx），而不是仅填写名称。

浏览器中的 ChatGPT 和 claude.ai 无法使用此服务：它们只连接托管在互联网中的 MCP 服务（Streamable HTTP + OAuth），而此服务通过 stdio 在你的计算机上运行。相关问题已记录在 #806。

其他支持 MCP 的客户端可手动配置：

# stdio server invoked by your MCP-aware client
bunx @caelo-cms/mcp-server@latest

启动时，它会切换到你的安装实例所运行的确切版本（请参阅文档中的 MCP 页面），因此命令无需指定版本；@latest 可避免 bunx 重用较旧的缓存安装。

请设置以下环境变量：

变量	必需	说明
`CAELO_ADMIN_URL`	是	`https://admin.example.com`——指向你的安装实例。必须使用 `https://`（仅 localhost 可以使用普通的 `http://`）。
`CAELO_MCP_TOKEN`	是	在 `/settings/mcp` 创建的 Bearer 令牌。
`CAELO_IAP_SERVICE_ACCOUNT`	GCP 安装时需要	管理端的 MCP 服务账号。如果管理端位于 Google IAP 后方，`/settings/mcp` 会在每个客户端配置片段中包含此项。

如果未设置 CAELO_ADMIN_URL 或 CAELO_MCP_TOKEN，服务仍会启动并列出其工具（MCP 目录会以这种方式检查服务），但每次工具调用都会失败，并指出需要设置的变量。此时，Power-MCP 会列出此版本附带的工具目录（power-catalogue.json）；配置完成后，它始终会列出管理端的实时目录，包括插件工具。export 则会直接退出。

位于 Google IAP 后方的安装实例（GCP）

在 gcp 和 gcp-firebase 安装中，管理端位于 Identity-Aware Proxy 后方。除非请求携带 Google 凭据，否则 IAP 会在 Caelo 收到请求前拒绝所有请求。设置 CAELO_IAP_SERVICE_ACCOUNT 后，服务会以该服务账号的身份签署一个短期 JWT（使用 Application Default Credentials 调用 IAM Credentials signJwt），并将其与 x-caelo-mcp-token 一同放入 Authorization 中：IAP 检查前者，Caelo 检查后者。

在你的计算机上进行一次性设置：

gcloud auth application-default login

配置程序会创建服务账号（caelo-mcp@<project>），将其加入 IAP 允许名单，并允许 IAP 允许名单中的所有人以该账号身份进行签名——新安装实例通过 Pulumi 完成，现有安装实例则在 cms-provision upgrade 期间完成。此过程不涉及服务账号密钥。

`caelo_chat` 工具

字段	类型	说明
`message`	string，必填	你想对 Caelo Agent 说的话。
`chatSessionId`	uuid，可选	继续现有聊天会话。
`attachments`	array，可选	最多四个由 `caelo_upload_images` 返回的图像引用。
`pageId`	uuid，可选	将新聊天绑定到一个页面，以填充 Agent 的页面上下文区块。

输出：助手的回复文本 + 一个 JSON 区块，其中包含 chatSessionId（用于下次调用）、requestId（点击进入 /settings/audit/<requestId> 查看完整审计记录）、Agent 调用的结构化工具摘要、每轮费用（以微美分计），以及 pendingProposals 计数，以便 Agent 显示“有 N 项内容正在等待 Owner 审批”。

为什么通过聊天来编辑？

浏览／发布／提议操作都通过聊天进行——“有哪些页面？”→ Caelo Agent 在内部调用 pages.list → 以文本作答。使用相同的身份验证接口、相同的 RLS 范围限制、相同的审计记录，以及与浏览器相同的提议后执行 Owner 审批门禁。远程 Agent 与一个等同于人类的 Agent 交互，而不是调用程序化 API。

许可证

MPL-2.0。

图像上传

两种模式都提供 caelo_upload_images。例如，使用以下内容调用它：

{"images":[{"filePath":"/home/me/Pictures/character.png","alt":"Main character reference"}]}

路径相对于 MCP 进程。也可以使用 base64 和可选的 filename；必须且只能提供 filePath 和 base64 中的一项。上传支持 PNG/JPEG/WebP/GIF，每张图片最大 5 MiB，每次调用最多四个文件。结果包含每个文件的成功／错误信息，以及一个 attachments 数组。将该数组与 message 一起传给 caelo_chat，即可向 Caelo 的 AI 发送实际图像内容。在管理模式下，返回的资源 ID 可用于常规媒体／页面工具。

无论使用哪种范围，都需要令牌所有者当前拥有 content.write 权限。图像存储在共享 CMS 媒体库中；管理预览需要身份验证。仅上传不会发布页面。部分批次会保留已成功上传的内容——只需重试失败的条目。有关 HTTP 示例和服务器限制，请参阅文档中的 MCP 页面。

支持 Markdown

登录后评论