AI 代理 (MCP)

适用于 AI 代理的 page-builder-sandwich

您的 WordPress 网站即其自身的 MCP 服务器。AI 助手会以应用密码以 WordPress 用户的身份登录,并能够执行该用户在 page-builder-sandwich 中所被允许的操作——仅此而已。

96 个操作:46 个免费,50 个属于 Pro。

开发者参考:每个操作、其 REST 路由及参数

分三步完成设置

  1. 检查开关

    您需要 WordPress 6.9 或更高版本以及 page-builder-sandwich 6.23.0 或更高版本。在插件的设置中,“允许 AI 代理 (MCP)”处于开启状态,除非您将其关闭。

  2. 创建应用密码

    在 WordPress 中,打开“用户”,然后选择“个人资料”,并添加一个以您的 AI 应用命名的应用程序密码。将其复制:WordPress 只会显示一次。

  3. 将站点添加到您的 AI 应用中

    使用您的 WordPress 用户名、应用程序密码和您网站的连接地址:

    https://example.com/wp-json/pbs/v1/mcp

热门 AI 应用程序的配置

下方每个应用程序都通过官方的 WordPress 代理 @automattic/mcp-wordpress-remote 与您的网站进行通信。请将地址、用户名和密码替换为您自己的。

Claude Desktop

// claude_desktop_config.json
{
  "mcpServers": {
    "page-builder-sandwich": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/pbs/v1/mcp",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

Claude Code

claude mcp add page-builder-sandwich \
  -e WP_API_URL=https://example.com/wp-json/pbs/v1/mcp \
  -e WP_API_USERNAME=your-username \
  -e WP_API_PASSWORD=your-application-password \
  -- npx -y @automattic/mcp-wordpress-remote@latest

光标和 VS Code

// .cursor/mcp.json · .vscode/mcp.json
{
  "mcpServers": {
    "page-builder-sandwich": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/pbs/v1/mcp",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

ChatGPT 和其他应用

任何支持通过标准输入和输出连接 MCP 服务器的应用程序都可以使用相同的命令和设置。仅连接到远程 HTTP servers 的应用程序可以使用相同的用户名和应用密码直接访问连接地址。

AI 智能体可以做什么

插件自身界面能做到的所有事情。标记为 Pro 的操作需要 page-builder-sandwich Pro 许可证。

操作其功能版本
启用已上传的字体 (Pro)使上传的自定义字体(媒体库中的字体文件,通过 ID 识别)在字体选择器中可用。专业版
自托管字体下载 Google 字体系列(family、weights、italic)并通过本网站提供服务。免费版
添加页面分区向页面添加现成区块:在页面开头、结尾,或在指定位置的区块之后。免费版
应用品牌工具包 (Pro)将已保存的品牌套件的颜色和字体应用于网站设计。专业版
导入网站工具包导入网站套件的页面(全部或指定的页面),可选择是否将其发布、设置为主页并添加到菜单中。再次导入会更新相同的页面。免费版
应用查找替换 (Pro)应用已预览的作业。每个更改过的文章都会为 pbs/undo-replace 保留一个备份。专业版
构建多个页面单次调用最多创建 50 个页面,每个页面可由节和/或区块内容组成。每个页面均会单独检查和创建;返回结果将列出成功创建的每个页面及被拒绝的每个页面及其原因。专业版
连接 Adobe Fonts (Pro)通过套件 ID 连接 Adobe Fonts (Typekit) Web 项目,以便其字体显示在字体选择器中。专业版
联系客服将此站点连接到 Zinn Digital® 支持(姓名、电子邮件、同意)。免费版
转换一个旧版页面将一个 5.x 页面转换为区块(已先备份)。免费版
创建全局类 (Pro)创建可重用的全局样式类:标签、别名及其样式。专业版
创建页面从各个区块(请参阅 pbs/list-sections)和/c 或块内容创建一个页面。新页面默认是草稿状态,除非指定了其他状态。免费版
创建一个团队(代理机构)创建一个带有邀请码的其他站点可以加入的团队库 (name)。专业版
禁用已上传的字体 (Pro)从字体选择器中移除自定义字体(按 slug)。专业版
删除全局类 (Pro)删除全局类。使用该类的元素将保留其内容但失去其样式。专业版
删除已上传的图标移除已上传的图标;使用过该图标的区块将保留其自身的副本。免费版
删除云端库设计 (Pro)从云端库中删除一个设计。专业版
将页面移至回收站将页面移至回收站。它可以在“页面”的“回收站”中恢复,保留 30 天。免费版
删除资源库团队 (Agency)删除团队及其资料库中的所有设计。专业版
断开与支持的连接取消此网站与支持服务的连接。免费版
复制全局类 (Pro)复制一个新的 ID 下的全局类。专业版
复制页面将页面(其标题、内容和模板)复制到新草稿中。免费版
导出设计和设置将所选的模板和图案(ID)以及可选的设置作为一个包导出,以便用于另一个站点。免费版
使用人工智能撰写页面使用(提供的或由AI从区块库中选择的)区块构建页面,并让AI根据您的简报重写所有文本,同时保留设计。使用插件AI设置中配置的AI提供商。除非另有要求,否则该页面将保存为草稿。专业版
描述构建器块返回单个区块的设置(属性及其类型、选项和默认值)、支持的功能、可包含的区块以及区块标记中的现成示例。免费版
查看响应式断点返回响应式控件所使用的平板电脑和移动设备宽度(以及 Pro 版中的自定义断点)。免费版
阅读网站设计返回全站颜色和字体(标题和正文),这些颜色和字体可供所有区块使用,正如“网站设计”屏幕中所显示的那样。免费版
阅读设计系统 (Pro)返回 Pro 设计系统:全局类、变量、设计标记、深色模式、品牌工具包和自定义字体。专业版
读取网站诊断返回支持工单包含的诊断信息:版本、激活的插件、限制以及最近的错误。免费版
读取云端资料库账户 (Pro)返回云端资料库的存储使用量、套餐配额及团队基本信息。专业版
获取云端库设计 (Pro)返回一个已保存的设计,随时可插入此网站(其图片将导入媒体库中)。专业版
读取自有存储设置 (Pro)返回自带的 R2/S3 存储设置(绝不会返回密钥)。专业版
查看许可协议返回此网站的 Page Builder Sandwich 方案、许可证状态、续订日期以及方案包含的内容。免费版
读取维护模式 (Pro)返回维护 / 即将推出模式:模式、页面、重试时间以及哪些角色仍然可以访问该网站。专业版
阅读旧版迁移返回 5.x 内容转换的进度和报告。免费版
阅读简讯连接(专业版)指示是否已保存 Mailchimp 密钥(绝不会返回密钥本身)。专业版
读取页面返回页面的标题、状态、链接、区块内容以及构成该页面的各个分节(顶级区块)。免费版
预览查找和替换 (Pro)返回某个职位的匹配结果,按页显示,以便在申请前进行审核。专业版
读取评论来源 (专业版)返回“评论”区块显示的 Google 和 Trustpilot 来源。专业版
读取生成器权限 (Pro)返回哪些角色可以使用生成器、设计、代码和模板(客户模式)。专业版
读取插件设置返回前端类前缀、beta更新状态以及是否允许AI代理(MCP)。免费版
读取支持连接指示此网站是否已连接到 Zinn Digital® 支持,以及连接的身份。免费版
阅读白标 (代理商)返回白标设置:开启或关闭、显示的名称以及哪些用户仍能看到原始内容。专业版
导入设计和设置导入由 pbs/export-designs 创建的包(首先运行 dryRun 以查看将发生哪些更改;模式:skip 或 replace;媒体;设置)。免费版
邀请站点加入团队(代理商)创建一个一次性邀请码(角色:只读或读写;标签;有效天数)。该代码仅显示一次。专业版
加入团队 (Pro)使用邀请码加入团队共享库。专业版
退出团队 (Pro)退出本网站加入的团队共享库。专业版
列出构建器模块列出此网站可使用的所有 Page Builder Sandwich 区块(当 Pro 版激活时也包括 Pro 区块):名称、标题、类别和说明。使用 pbs/get-block 获取区块的设置,然后将区块放入页面内容中。免费版
表单列表列出使用表单块构建的表单以及可以嵌入的表单插件。免费版
列出网站套件列出此网站可导入的网站套件(针对特定业务类型的一组现成页面)。免费版
列出云端库设计 (Pro)列出保存到云端库的设计(类型:区块、页面或图案;团队:团队库)。专业版
列出自行托管的字体列出此网站自行托管的 Google 字体(下载一次、由本网站提供服务、无需向 Google 发送请求)。免费版
列出 Lottie 动画 (Pro)列出已上传的 Lottie 动画。专业版
列出页面列出您可以编辑的页面,按最新排序,并提供可选的搜索功能。免费版
列出查找和替换任务(专业版)列出全站查找替换任务及其状态。专业版
列出区块列出可添加到页面的现成区块(如首屏横幅、功能特点、常见问题解答、客户见证、行动号召等)。免费版
列出临时支持登录名列出授予我们团队的临时支持用户以及各自的过期时间。免费版
列出团队成员 (Pro)列出团队中的站点及其访问权限。专业版
列出库团队 (Pro)列出此网站所属或拥有的团队。专业版
列出可导出的内容列出可导出到另一个网站的模板、模式和设置。免费版
列出已上传的图标列出上传到图标库的 SVG 图标,按最新时间排序。免费版
移动分区将页面的一部分从一个位置移动到另一个位置(从 0 开始,与 pbs/get-page 列出的顺序相同)。免费版
提交支持工单使用此网站的诊断信息提交支持工单(主题、消息、类型、电子邮件);access_days 和 credentials 可选地授予我们团队临时访问权限。免费版
同意支持诊断记录管理员同意在提交支持工单时发送诊断信息。免费版
立即刷新评价 (Pro)立即获取最新的 Trustpilot 评论,而不必等待每日刷新。专业版
从页面中移除区块根据路径从页面中删除一个区块(整个部分,或部分内部的区块)。该页面的以前版本将保留在其修订版中。免费版
停止使用您自己的存储空间 (Pro)移除了自带存储设置;将重新使用套餐自带的存储空间。专业版
移除自托管字体删除自托管字体系列的文。免费版
移除团队成员(代理机构)从团队中移除网站。专业版
撤销临时技术支持登录权限立即移除临时支持用户 (ids)。免费版
保存设计至云端图库 (Pro)将区块标记(标题、类型、标记、样式、标签)保存到您的云端库或团队云端库中;图片也将一并打包。专业版
使用您自己的存储空间(Pro)保存自备存储:提供商(r2 或 s3)、存储桶、区域、端点、前缀、key_id、secret、已启用。专业版
更改维护模式 (Pro)开启或关闭维护模式 (503) 或即将推出模式 (mode),并可指定要显示的页面 (page_id)、重试时间 (retry_after) 以及可绕过此模式的角色。专业版
连接 Mailchimp (Pro)保存(若值为空,则移除)时事通讯区块所使用的 Mailchimp API 密钥。专业版
更改评价来源(高级版)设置“评论” (Reviews) 区块读取的 Google 地点和 Trustpilot 企业。专业版
更改生成器权限 (Pro)按角色设置构建器允许的操作(角色),例如仅内容客户端角色。专业版
更改白标(代理商)开启或关闭白标并设置客户看到的名称 (enabled, name, agency_users)。专业版
转换旧版内容开始(或重新开始)将每个 5.x 页面转换为块;每篇发布内容都会先进行备份。免费版
全站查找与替换 (Pro)启动块安全查找和替换(查找、替换、类型:文本、链接或颜色;match_case;类型)。在执行 pbs/apply-replace 之前不会有任何更改。专业版
开始免费 Pro 试用为此站点开始 14 天 Page Builder Sandwich Pro 试用(无需付款)。免费版
测试您自己的存储空间(专业版)写入、读取和删除您自有存储中的测试对象,并报告每个步骤。专业版
撤销一次转换从备份中还原一个已转换的页面。免费版
撤销旧版迁移将每个已转换的文章从其备份中恢复。免费版
撤销查找和替换 (Pro)恢复职位变动前发布的文章(编辑过的文章将保留其编辑内容)。专业版
更改一个区块的设置更改通过路径找到的页面内单个块的设置(属性);您发送的属性将与当前属性合并。适用于网站根据其设置呈现的块;对于 HTML 保存在页面中的块,请通过 pbs/update-page 发送新的标记。免费版
更改品牌套件 (Pro)保存品牌套件:名称、标志、颜色、标题和正文字体,以及人工智能写作使用的品牌基调。专业版
更改响应式断点更改平板电脑和手机的宽度(以像素为单位);使用 Pro 版可自定义额外的断点。免费版
更改全局类 (Pro)更改全局类的标签、别名或样式;所有使用该类的元素都会更新。专业版
更改深色模式 (Pro)设置暗黑模式(模式:off、auto 或 toggle)及其颜色。专业版
更改网站设计更改全站的颜色 (colors)、字体 (fonts, headingFont, bodyFont)。每个页面都会应用此更改;主题的 theme.json 会保持同步。免费版
更新页面更改页面的标题、状态或区块内容。您发送的内容将替换页面的现有内容。免费版
更改插件设置更改前端类前缀(1 到 8 个小写字母或数字,以字母开头)和/或开启或关闭 AI 代理(MCP)(`mcp: false` 会移除所有功能和 MCP 端点)。免费版
更改设计令牌 (Pro)更改间距、圆角和阴影比例(space、radius、shadow),或将其重置(reset)。专业版
修改 CSS 变量 (Pro)替换站点的设计变量(变量:名称和值的列表)。专业版
上传图标将 SVG 图标(名称、SVG 标记)添加到图标库;SVG 会先进行净化处理。免费版
上传 Lottie 动画 (Pro)验证 Lottie JSON 文档 (json, name) 并将其发布为 Lottie 块的静态文件。专业版

引导式工作流

服务器还提供开箱即用的工作流,您的AI应用将其列为提示词:

  • 创建着陆页 — 引导式工作流:智能代理挑选适合您业务的区块,将页面构建为草稿并撰写文案。

设计安全

每个操作都会检查与插件自身界面相同的 WordPress 权限,针对其所涉及的具体页面或文章。订阅者根本无法连接。

可以在“用户”下的“个人资料”中随时撤销应用密码,而无需更改您的常规密码。

关闭“允许 AI 智能体 (MCP)”后,操作和连接地址将从站点中消失。

代理更改的页面会保留其 WordPress 修订版本,因此任何更改都可以撤消。

使用 Zinn Digital® 托管?

如果 Zinn Digital® 托管该网站,我们自己的 MCP 服务器无需应用程序密码即可为您执行这些操作:将您的 AI 应用连接到 Zinn Digital® MCP 服务器,并使用 wordpress_abilities_list 和 wordpress_ability_run。

Zinn Digital® MCP 服务器