Connect Profound CMS to your AI client

Profound CMS 提供远程 MCP 服务器，使兼容的 AI 客户端能够发现、创建、更新、发布和管理 CMS 内容。

MCP 端点：

http://107.21.107.99:8081/mcp

在生产环境中，只要可用，请使用您配置的 MCP URL 的 HTTPS 版本。

身份验证

Profound CMS MCP 使用 WorkOS OAuth。

连接步骤：

1. 创建 Profound CMS 账户。
2. 确认您的账户属于正确的组织。
3. 将 MCP 服务器添加到您的 AI 客户端。
4. 按提示完成基于浏览器的登录。

您无需将 API 密钥复制到 AI 客户端中。登录后，客户端会接收一个短期访问令牌，并自动刷新该令牌。

您的 CMS 角色决定访问权限：

• 成员可以读取 CMS 内容。
• 编辑者和管理员可以创建、更新和发布内容。

Claude Code

运行：

claude mcp add --transport http Profound http://107.21.107.99:8081/mcp

然后启动 Claude Code，并完成浏览器身份验证流程。

验证连接：

claude mcp list

Codex CLI

运行：

codex mcp add Profound --url http://107.21.107.99:8081/mcp

Codex 会在首次使用服务器时请求身份验证。

您可以使用以下命令验证连接：

codex mcp list

OpenCode

将以下内容添加到：

~/.config/opencode/opencode.json

{
  "mcp": {
    "profound": {
      "type": "remote",
      "url": "http://107.21.107.99:8081/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

然后进行身份验证：

opencode mcp auth profound

验证连接：

opencode mcp list

服务器应显示为已通过 OAuth 连接。

Cursor、Windsurf 及其他 MCP 客户端

大多数兼容 MCP 的客户端都支持标准的远程 HTTP 配置：

{
  "mcpServers": {
    "profound": {
      "url": "http://107.21.107.99:8081/mcp"
    }
  }
}

在 Cursor、Windsurf、Claude Desktop 或其他 MCP 客户端中：

1. 打开 MCP 或集成设置。
2. 添加远程 HTTP MCP 服务器。
3. 使用 Profound MCP URL。
4. 如果客户端提供 OAuth 选项，请启用 OAuth 身份验证。
5. 在浏览器中完成 Profound CMS 登录。

客户端必须支持 Streamable HTTP MCP 和 OAuth。仅支持本地服务器或静态 API 密钥的客户端无法直接通过此服务器进行身份验证。

每次会话都从发现开始

连接后，请让您的 AI 客户端发现您可用的组织和网站：

仅使用 Profound MCP 服务器。

首先调用 list_my_organizations。
然后调用 list_organizations。
使用 list_organizations 返回的组织 ID 调用 list_websites。

以表格形式显示组织名称、网站名称和网站 ID。

所有 CMS 操作都需要 website_id。

可用工具

MCP 服务器目前提供 35 个 CMS 工具。

组织和网站

• list_my_organizations
• list_organizations
• list_websites

页面

• create_page
• update_page
• delete_page
• get_page
• list_pages

路由绑定

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

路由绑定将模板页面连接到特定内容或参数值。

组件

• create_component
• update_component
• delete_component
• list_components

组件定义可重复使用的内容类型及其字段。

区块

• create_block
• update_block
• delete_block
• get_block
• list_blocks
• publish_block

区块是放置在页面上的内容实例。

动态字段和 Template Builder 表达式

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

这些工具用于管理动态的 fx 表达式，该表达式会在渲染时计算字段值。

文档和变体

• create_document
• update_document
• delete_document
• get_document
• list_documents

文档是可重复使用的内容条目，也称为变体。list_documents 返回元数据；使用 get_document 获取完整内容。

翻译

• list_document_translations
• upsert_document_translation
• delete_document_translation

翻译应作为单个文档中的区域设置行进行存储，而不是为每种语言创建单独的文档。

典型 CMS 工作流

完整的内容工作流通常如下：

1. 发现组织和网站。
2. 检查现有的组件、页面、区块和文档。
3. 创建或更新所需内容。
4. 更新区块、组件或文档时使用 expected_version。
5. 发布区块或文档。
6. 将页面状态设置为 Live。
7. 验证已发布的内容。

只有当页面处于上线状态且其内容已发布时，页面才会公开可见。

示例提示词

创建页面：

使用 Profound CMS，为网站 <website_id> 创建一个位于 /pricing 的页面。
创建所需的区块，发布这些区块，并将页面设置为 Live。

更新现有内容：

查找网站 <website_id> 的首页。
读取其当前区块，更新主视觉标题，并发布更改。

创建本地化内容：

为文档 <document_id> 添加法语和德语翻译。
使用现有文档创建翻译行，而不是创建重复文档。

使用动态内容：

对于模板页面上的主视觉区块，使标题从路由绑定的文档中提取内容。
使用区块字段表达式，而不是将公式放入 draft_content 中。

端到端内容工作流

Profound CMS MCP 可以与其他 MCP 服务器结合使用，以支持完整的工作流：

例如：

Figma MCP + Profound CMS MCP

可以将设计发现、内容创建、CMS 编辑、本地化和发布连接成一个由 AI 辅助的统一工作流。