WordPress MCP

WordPress + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 WordPress API MCP 服务。与 WordPress Foundation 无关联，也未获其认可或赞助。

_{▶ 观看 30 秒演示 - 演示数据为模拟数据；展示的每条命令都存在于实际 CLI 中。}

发布和管理 WordPress 页面、文章和媒体。可与您已有的 AI 工具配合使用 - ChatGPT（Plus/Pro+，暂停使用，直到此连接器重新发布；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot，以及通过远程方式使用 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在您的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

兼容您的 Agent

安全提示（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本会检查令牌，但 早于修复版，因此尚无请求大小和时间限制。MCP 工具也可能使用您的凭据进行更改。 请使用默认的 stdio 传输。如果您为远程 Agent 设置了隧道，请将其关闭。修复即将推出。

MSP 所有者实际使用的六种 Agent（可自行安装，目前可用）：

您的 AI Agent	如何安装 WordPress skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 wordpress-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	暂停使用，直到此连接器重新发布：ChatGPT 需要 HTTP 模式，而此版本的该模式会检查令牌，但尚无请求大小和时间限制。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 wordpress-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，因此需要使用此连接器的 HTTP 模式；在连接器重新发布前，该模式暂停使用：此版本的该模式会检查令牌，但尚无请求大小和时间限制。请参阅 mcp-install.md 中的安全提示。

Microsoft 和 Google 生态也适用

用户基数很大，但请注意：这是远程 / 企业方案，并非你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，直到重新发布此连接器：Copilot Studio 需要 HTTP 模式，而此版本的该模式虽然会检查令牌，但尚未设置请求大小或时间限制。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 在本地运行，与 Claude Code 一样。Gemini 应用在远程运行，需要使用与 ChatGPT 相同的暂停 HTTP 模式。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也已涵盖）： Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，也支持 MCP——请参阅下方的安装部分。也可通过 MCP 与 Cursor、Windsurf、Cline、Continue.dev 和 Zed 搭配使用。各工具的完整连接说明：docs/which-agent.md。

要在多个 Agent 中使用？ 只需一条命令，即可在所有 51 个以上受支持的 Agent 中安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后运行每个 Skill 的安装程序来安装 CLI / MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快捷的安装方式——一键安装 .mcpb

Claude Desktop 安装包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 wordpress-cli。从 2026-09-18 起发布的版本会在安装包内附带该 CLI；较早的安装包只包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 WORDPRESS_CLI_PATH 设置为现有二进制文件的路径）。详情： #331。

下载 WordPress MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。只需单击一次，无需 JSON，也无需使用 shell。（在发布页面查看所有 WordPress 版本。）

更喜欢使用 Claude Code 插件？添加一次市场，然后安装即可——立即生效，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install wordpress@msp-skills

路径 A——向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork 中：

在此 Agent 工作区中安装 Servosity/msp-skills 的 WordPress Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/wordpress/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/wordpress/install.ps1 | iex。然后按照 README 进行身份验证，并运行 wordpress-cli --help 了解其用法。

任何能够运行 shell 的 Agent 都可以使用同一条提示词。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/wordpress/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/wordpress/install.sh)

安装程序会将 wordpress-cli（CLI）和 wordpress-mcp（MCP 服务）都放入用户的 bin 路径。Claude Code、Codex 和 Cowork 会从此目录中的 SKILL.md 发现该 Skill。

验证：

wordpress-cli --version

升级到最新版本

安装程序始终会获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/wordpress/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/wordpress/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），并在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update wordpress@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各个 Agent 的接入方式——每个 Agent 都有一个专属章节，其中包括 GitHub Copilot 的 servers 键，以及远程 Microsoft 365 Copilot / Copilot Studio 的接入路径。Claude Desktop 的 Settings > Extensions 面板是最简单的方式；面向偏好编辑 JSON 的用户，mcp-install.md 中记录了 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/wordpress --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/wordpress --force

Hermes 原生支持 MCP，因此也可以直接使用 wordpress-mcp 服务——安装方式和环境变量都相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/wordpress 安装 wordpress 技能。该技能定义了如何通过 openclaw: frontmatter 块安装其所需的 CLI（wordpress-cli）。

OpenClaw 目前尚未普遍开放；frontmatter 接入配置已预先提供，OpenClaw 一经发布便会启用。

进行身份验证

设置 CLI 所需的凭据（从你的 WordPress 门户获取）：

WORDPRESS_BASIC_AUTH=<value> wordpress-cli doctor

运行任何会触及数据的操作前，doctor 会确认凭据是否有效。即使凭据被拒绝，它也会以状态码 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 经常提出的问题	命令
不打开 wp-admin，直接从 HTML 发布着陆页？	wordpress-cli pages create --title "Spring Promo" --content "<h1>Spring Promo</h1>" --status publish
哪些页面仍处于草稿状态？	wordpress-cli pages list --status draft
原位更新已上线页面的内容？	wordpress-cli pages update 42 --content "<h1>Updated copy</h1>"
上传主视觉图片并获取其媒体 ID？	wordpress-cli media upload ./hero.png --alt-text "Spring promo hero"
在本地镜像整个网站，以便离线搜索和备份？	wordpress-cli workflow archive
查找所有提及旧短语的页面或文章（在运行 workflow archive 后）？	wordpress-cli search "summer sale"
发布带有分类和标签的博客文章？	wordpress-cli posts create --title "Patch Tuesday recap" --content "<p>This month...</p>" --status publish
可以将内容分配给哪些作者？	wordpress-cli users list

完整命令参考：guide.md。有关 AI Agent 操作约定（--agent、--dry-run，以及何时在执行变更前确认），请参阅 AGENTS.md。

与众不同之处

大多数 WordPress 集成和 MCP 服务都会将每个问题转发为实时 API 调用。编辑一条记录时，这样做没问题。但当你询问“查找整个网站中所有仍提及去年定价或失效促销链接的页面和文章”时，这种方式就会变得缓慢且产生大量冗余信息。

此技能会将 WordPress 同步到带有全文搜索功能的本地 SQLite 镜像中。这个跨内容查询可以变成一次即时的离线查询，AI 看到的是匹配的行，而不是所有页面 HTML 的转储。workflow archive 和 workflow status 等复合命令会一次性镜像并盘点所有页面、文章、媒体项目、分类、标签和用户——这是无状态 API 封装无法做到的。

它解决的痛点

日常的网站编辑——替换促销横幅、修正电话号码、发布新的落地页——都意味着要登录 wp-admin，然后逐屏点击区块编辑器。Classic Editor 插件在 WordPress.org 插件目录中仍有超过 1,000 万个活跃安装：这无疑表明，人们不愿用那个编辑器处理日常内容工作。对于一组客户网站来说，在浏览器里逐个点击是无法收费的杂活；而官方的 WP-CLI——可脚本化的替代方案——需要通过 SSH 访问服务器的 shell，许多托管网站并不提供这种访问权限。

这项技能通过网站已有的 REST API，让你从终端或 AI Agent 填补这一空缺：

• 远程发布和更新内容 - wordpress-cli pages create / wordpress-cli pages update / wordpress-cli posts create，无需 wp-admin，也无需 SSH。
• 梳理未完成的工作 - wordpress-cli pages list --status draft 会列出所有仍待发布的页面。
• 一次搜索整个网站 - wordpress-cli workflow archive 会镜像网站，然后 wordpress-cli search "old pricing" 会找出所有仍提及该内容的页面或文章。
• 按 ID 管理媒体 - wordpress-cli media upload ./hero.png --alt-text "Spring promo hero" 会返回媒体 ID，你可以将它用于特色图片。

更多背景请参阅 pain-point.md。

常见问题

这能用于 ChatGPT 吗？

当前版本不行。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 套餐；Free 套餐尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着需要以 HTTP 模式运行 WordPress MCP 服务。在当前版本中，HTTP 模式会检查令牌，但尚未设置请求大小或时间限制，因此在连接器重新发布之前，请勿运行该模式，也不要将其置于隧道之后；mcp-install.md 中的安全说明解释了原因。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这能用于 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 吗？

可以——它们都支持 MCP。跨工具安装命令见上方的矩阵，详细说明见 docs/which-agent.md。

我需要懂编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是每种操作系统对应的一行安装命令（bash 或 PowerShell）。这两种方式都不需要编写代码。你只需输入一次 WordPress 凭据。

我的 WordPress 数据安全吗？

你的数据会留在你的设备上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在用户帐户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。凭据从环境变量或 Agent 的配置中读取；MSP Skills 绝不会将凭据打包进此仓库或传输到任何地方。

需要在 WordPress 网站上安装插件吗？

不需要。本工具使用 WordPress 内置的 REST API（/wp-json/wp/v2 路由），该 API 随 WordPress 4.7 及更高版本提供。你只需要为具有相应角色的用户创建一个 Application Password——在 wp-admin 中前往 Users > Profile > Application Passwords 创建——并将其设置为 WORDPRESS_BASIC_AUTH。

它能管理多个网站吗？

可以。设置相应网站的 WORDPRESS_BASE_URL 和 Application Password，即可连接任意网站。命名配置和按站点划分的本地镜像会分别保存每个网站的状态，因此一台工作站就能管理一组客户网站。请将每个网站的 Application Password 视为仅限该站点使用的凭据。

它会取代 wp-admin 或 WP-CLI 吗？

不会——它们可以互为补充。wp-admin 仍用于主题工作和插件配置；有 SSH 访问权限时，WP-CLI 仍是服务器端的强大工具。这项技能通过同一个 REST API，增加了远程、可脚本化、由 AI 驱动的内容管理能力，并提供本地镜像以便即时跨站搜索。

费用是多少？

免费。采用 Apache-2.0 许可。你只需为使用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由你的 AI 提供商收取，而不是我们。

安全模型

层级	示例	建议的 Agent 策略
读取	pages list、posts list、media list、search、users list、workflow status	允许
写入（常规）	pages create、pages update、posts create、posts update、media upload、media update、categories create、tags create	使用 --dry-run 预览，然后执行经过审核的写入操作
破坏性操作 / 配置	pages delete、posts delete、media delete、settings update	仅限人工参与

最有力的控制措施是授予 WordPress 凭据的权限范围——CLI 只能执行凭据获准执行的操作。完整详情（包括如何限制权限）请见 governance.md。

状态

已在线验证。维护者 Servosity 已在其生产租户上确认。更多 MSP 正在我们的每周 Build Sessions 中实际运行此工具。请在 compoundingteams.com/build-sessions 回复确认出席。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多种 Agent）。兼容 MCP，可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。最后更新：2026-06-30。