profound-logoProfound CMS
⌘K
Admin
Theme
DocsTutorialBlogPhilosophy
DocsTutorialBlogPhilosophy

Hybrid

Collection of Pages with ComponentsTypes of ComponentsSetup server sent events (SSE) content refetchInstall Profound CMS as a proxyCEL Scripting in Template BuilderProject ScaffoldingMedia Library

Headless

Quick startJSON 与 Claude 代码组件 Zod 拉取

REST API

REST API 概览get连接网站 APIgetGET /routesgetGET /routegetGET /blocksget获取带有 CEL 缓存的区块getGET /blocks/generatedgetGET /componentsgetGET /components/{name}getGET /dataset/{schema_name}get获取内容变更 SSEpatchPATCH /dataset/{schema_name}postPOST /translationpatchPATCH /translationsgetGET /usagepostPOST /csvpatch修补 CSV
All Systems Operational
Powered Byprofound-logo
Theme

JSON 与 Claude 代码

使用 Claude Code 和 JSON 构建器创建架构

首先连接到我们的 MCP 服务器

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

然后你就可以开始使用工具和组件来批量创建文档/区块/组件,并快速发布网站。

以下是手动流程

启动 Zod JSON 架构编辑器。

  • 前往 CMS 管理面板
  • 点击 + Create schema(创建架构)
  • 输入该架构经过验证的合适 JSON 描述
  • 应用更改

若需后续修改,需要删除该架构并重新添加。


为 JSON 工作流提示 Claude

如果我们使用 Claude Code 来进行 TailwindCSS/CSS/React 的视觉更改,那么我们也可以让它通过 MCP 服务器或提供需要粘贴到代码编辑器中的 JSON,以正确更新 JSON。

只需向 Claude 请求你想为之创建架构的组件所需的 JSON,无论是混合型还是纯无头 CMS。


示例

我们正在添加一个新的 MCP 服务器功能,为了展示它,我们将添加一个新的 hero 区块。

我们先修改注册表以使用一个新 Block

const registry = {
  "navbar": NavbarBlock,
  ...
  // 新增的区块
  "McpFeatureBlock": McpFeatureDisplayBlock,
  ...
  "footer": FooterBlock,
};

让 Claude 实现该区块的 React/CSS,并提供架构定义所需的 JSON,应该如下所示。

"McpFeatureBlock": {
  "label": "MCP 服务器",
  "title": "让 AI 智能体直接操作你的 CMS",
  "description": "Profound CMS 搭载原生 MCP 服务器。连接 Claude、Cursor 或任何兼容 MCP 的智能体,让它读取页面、更新区块并发布内容——无需自定义胶水代码。",
  "features": ["McpFeatureItem"],
  "cta_label": "阅读 MCP 文档",
  "cta_href": "/docs/mcp"
}

将其粘贴到架构构建器中的 JSON 编辑器里。它应如下所示。

提示: 更喜欢 Zod 吗?将编辑器从顶部的 JSON 切换到 Zod,并改为粘贴 Zod 架构——构建器会推导出相同的字段。如果你在应用的其他地方已经使用 Zod 建模数据,这样非常方便。

之后,创建使用架构 mcp_feature_block 的区块,并在页面的模板构建器中引用该区块。


总结

这是一个自定义的 Claude + Profound CMS 工作流。

Continue Reading
Previous‹Quick startNext组件 Zod 拉取›