WordPress官方MCP Adapter插件上架:AI能调用哪些站点功能,由能力接口和用户权限说了算
本文目录
- WordPress为什么要一个“标准”的MCP插件
- 它是怎么工作的:能力接口加MCP
- 从GitHub到官方插件目录:版本和兼容性
- 谁需要装这个插件
- 装之前要守住的几道门
- 能力默认不公开
- 执行前按当前用户检查权限
- 两种连接方式
- 出问题去哪儿报
- 和其他接入方式的关系
- 常见问题解答
- WordPress MCP Adapter是什么?
- MCP Adapter什么时候上架官方插件目录的?
- MCP Adapter对WordPress版本有什么要求?
- 装了MCP Adapter,AI就能操作我的整个网站吗?
- AI客户端怎么连接到WordPress站点?
- MCP Adapter支持哪些MCP协议版本?
- 插件开发者应该怎么接入MCP Adapter?
- 给AI用的WordPress账户该给什么权限?
- 普通外贸站现在有必要装MCP Adapter吗?
- 官方MCP Adapter和第三方WordPress MCP服务器有什么区别?
- 能力接口和WordPress的REST接口有什么区别?
- 怎么查站上有哪些能力对MCP公开了?
- MCP Adapter收费吗?
- WordPress多站点网络能用MCP Adapter吗?
- 发现MCP Adapter的安全问题该怎么报告?
- 权威参考资料
摘要:WordPress官方的MCP Adapter插件上架了WordPress.org插件目录,Automattic的AI工程总监Jason Adams称它是WordPress“标准的MCP插件”,并在设计上兼容不同版本的MCP协议。插件本身不带任何AI功能,它做的事是把WordPress能力接口(Abilities API)里登记的能力,转换成AI客户端能调用的MCP工具、资源和提示。能力默认不公开,要逐个打开,执行前还会按当前用户检查权限。这个插件之前只能从GitHub下载,上架前已有4万多次安装,需要WordPress 6.9及以上。想让AI帮忙管站的人可以用它,但账户权限要先想清楚。
这两年接触过AI编程工具的人,对MCP这个词应该不陌生了。Claude、ChatGPT、Cursor都能通过MCP去调用外部的工具和数据。问题是,每家插件都想自己做一套MCP接口,WordPress站上装几个插件,可能就有几套互不相通的AI入口。
WordPress官方这次给出的答案是:别各做各的了,用同一个。Search Engine Journal报道,官方的MCP Adapter插件已经上架WordPress.org插件目录。这篇以这篇报道和插件的官方说明、更新日志为主体,讲清楚它是什么、怎么工作、谁该装,以及装了以后要守住哪几道门。
WordPress为什么要一个“标准”的MCP插件
先简单说一下MCP。它的全称是模型上下文协议,由Anthropic提出,是一个开放标准,让AI系统能安全地连接应用、数据、插件、工具和网站,既能读信息,也能执行动作。对WordPress来说,接上MCP,AI就能直接和站点、插件以及WordPress的各种功能打交道,比如发布文章。
插件目录里对MCP的解释很直白:以前每个AI客户端都要单独做一套集成,现在一个系统只要把自己能做的事以MCP工具、资源和提示的形式暴露出来,任何兼容MCP的客户端都能用。
Automattic负责AI的工程总监Jason Adams在X上宣布发布时这样说:
WordPress MCP Adapter现在发布了。这是WordPress标准的MCP插件,在架构上特意做了对不同MCP版本的向后兼容。如果你想在网站或插件里用MCP,我强烈建议用它。它借助能力接口来避免功能重复,同时处理授权。
有网友在下面评论:“向后兼容很重要,WordPress插件往往一用就是好几年。”Adams回复说:“同意。MCP协议本身的向后兼容我们控制不了,所以在我们自己的生态里做好这件事很重要。”
这段对话点出了这个插件存在的理由。MCP协议还很年轻,一年里出了好几个修订版。WordPress的插件生态讲究稳定,一个站的插件动辄用上三五年。中间需要有人专门负责“协议怎么变,WordPress这边都接得住”,官方选择自己来干这个活。
它是怎么工作的:能力接口加MCP
插件目录的常见问题里有一句话很关键:MCP Adapter是服务器和传输层,它本身不提供任何AI功能。
决定AI能干什么的,是WordPress的能力接口(Abilities API)。一项“能力”就是WordPress核心或某个插件登记的一件具体的事,比如读取文章、修改某项设置。MCP Adapter把站上登记的能力拿过来,提供给MCP客户端,同时负责协议协商、权限和错误处理。能力接口从WordPress 6.9开始进了核心,所以这个插件要求WordPress 6.9及以上。
按插件说明,它的功能有这几项:
| 功能 | 做什么 |
|---|---|
| 能力转MCP | 把WordPress能力自动转换成MCP的工具、资源和提示 |
| 多服务器管理 | 可以建多个MCP服务器,每个有自己的配置、能力和处理器 |
| 可扩展的传输层 | 内置HTTP和STDIO两种传输方式,也支持自定义 |
| 错误处理 | 默认写入WordPress兼容的错误日志,可以按服务器换成自己的处理器 |
| 可观测性 | 指标统计,可以接入自己的监控 |
| 权限控制 | 每个服务器有传输层认证,每项能力有单独的权限检查 |
一项能力登记时要交代清楚几件事,大致是这些:
| 要素 | 作用 | 对AI的意义 |
|---|---|---|
| 名称 | 带命名空间的唯一标识,比如“插件名/能力名” | AI用它点名调用 |
| 标签和描述 | 给人和模型看的说明 | 模型靠描述判断什么时候该用它 |
| 分类 | 能力所属的类别,0.6.0起文档明确为必填 | 方便按类发现 |
| 输入和输出结构 | 用JSON Schema描述参数和返回值 | 模型知道该传什么、会拿回什么 |
| 执行回调 | 真正干活的PHP函数 | AI调用后实际执行的代码 |
| 权限回调 | 判断当前用户能不能执行 | 决定AI能不能做成这件事 |
| meta元信息 | 包括是否公开、是否在MCP里公开等开关 | 决定MCP能不能看到它 |
这张表里最该让站长关心的是最后两行:一个管能不能执行,一个管能不能被看到,两道门是分开的。
默认服务器对外只提供三个“元工具”:发现能力、查看某项能力的说明、执行某项能力。AI客户端先问“你能做什么”,再问“这件事要什么参数”,最后才去执行。这种设计的好处是,站上能力再多,AI那边看到的入口也只有三个,不会一上来就塞给模型几百个工具。
Adams说的“借助能力接口避免功能重复”,指的也是这个:插件开发者只需要在能力接口里登记一次自己的功能,不用再专门写一套MCP接口,MCP Adapter会自动转换。站内之前写过从零写一个MCP服务器,对比一下就知道,WordPress这套做法省掉了大部分重复劳动。
从GitHub到官方插件目录:版本和兼容性
这个插件并不是新东西。SEJ的报道说,它之前只能从GitHub的发布页下载,即便这样也已经有超过4万次安装。这次是第一次上架WordPress.org官方插件目录,SEJ报道时的版本是0.7.0,站长可以在后台直接搜索安装。
0.7.0这一版在10月2日发布,改动不小,看更新日志能理解为什么官方要强调兼容性:
- 插件只按两个MCP协议修订版提供服务:2025-11-25和2026-07-28。客户端如果提出用更老的2025-06-18或2024-11-05版本,照样能连上,统一按2025-11-25版处理;
- 新增对2026-07-28版的支持,包括无会话的服务发现流程和新的HTTP请求头;
- 不再悄悄丢弃或修补无效的协议字段,任何受支持版本都表达不了的内容直接拒绝;
- JSON-RPC批量请求一律拒绝;
- 把MCP Adapter作为代码库打包进别的插件的做法被列为弃用,官方要求直接安装这个插件。
最后一条对普通站长影响最大。以前有些插件会把MCP Adapter的代码打包进自己的安装包,一个站上可能同时存在好几份不同版本,谁先加载谁生效。官方的思路是收拢成一份:插件开发者在自己插件的头部写上“Requires Plugins: mcp-adapter”,声明依赖这个插件,由站长统一安装和升级。
再往前看,8月的0.6.0版把最低要求提到了WordPress 6.9,单独安装的能力接口插件不再被支持;在多站点网络里,会话存储改成按子站分开。还停在6.8或更早版本的站,先升级WordPress本体。
谁需要装这个插件
说实话,大部分只想好好写内容、卖货的站,现在不装也没任何损失。这个插件解决的是“让AI通过标准方式操作WordPress”这件事,下面几类人更用得上:
| 人群 | 能用它做什么 | 建议 |
|---|---|---|
| 插件和主题开发者 | 在能力接口里登记功能,自动获得MCP支持 | 用依赖声明,别再自己打包一份 |
| 管理多个站的建站公司和代运营 | 用Claude、Cursor这类客户端批量查询或修改站点内容 | 先在测试站跑通,每个站单独的账户 |
| 有技术能力的站长 | 让AI帮忙批量检查文章、整理分类、修改设置 | 只公开需要的能力,用低权限账户 |
| 普通内容站和外贸站 | 暂时用处不大 | 等常用插件接入后再考虑 |
还要提醒一点:装了MCP Adapter,AI能干什么取决于站上有哪些能力。插件说明写得清楚,站上得有WordPress核心或者其他插件登记的能力,这个插件才有用。光装它一个,AI能做的事很有限。
对做SEO的人来说,值得关注的是长期方向。WordPress核心、主流SEO插件和电商插件陆续把功能登记成能力以后,用AI批量改标题和描述、检查内链、修结构化数据,就能通过一个统一入口完成,不用每个工具单独对接。站内之前整理过MCP接进SEO工作流一年的复盘,里面踩过的坑在WordPress这边同样存在:AI改得快,改错也快。
想把AI接进日常SEO流程,又暂时不想动WordPress后台的,也可以先用自动化工具串起来跑,比如站内写过的用n8n搭SEO智能工作流。等手上的流程跑顺了,再考虑把其中需要改站点内容的环节换成MCP直连。智能体做SEO活儿最容易出的问题是乱报和误改,SEO智能体的可交付架构那篇讲了怎么设检查点,接WordPress之前值得先读一遍。
装之前要守住的几道门
让AI能直接操作网站,安全是绕不开的话题。好在MCP Adapter的默认设计比较保守,几道门都在:
能力默认不公开
GitHub仓库的说明写明,WordPress的能力默认是私有的。要把一项能力暴露给MCP,得把它的meta.public(或者meta.mcp.public)设成true。插件目录也强调,暴露是主动选择的,并不是登记了就自动对外。
0.6.0起有一个变化要留意:设置了meta.public为true的能力,会默认通过MCP默认服务器暴露出去,除非meta.mcp.public明确设为false。这意味着,某个插件把一项能力标成公开,它在MCP里也就能被调到了。装新插件之后,可以用默认服务器的“发现能力”工具查一遍,看看对外到底开放了哪些。
插件开发者登记能力的代码大致长这样,挂在能力接口初始化的钩子上,具体参数以官方文档为准:
add_action( 'wp_abilities_api_init', function () {
wp_register_ability( 'my-shop/get-order-count', array(
'label' => '订单数量',
'description' => '返回最近30天的订单数量',
'category' => 'my-shop',
'output_schema' => array( 'type' => 'integer' ),
'execute_callback' => 'my_shop_count_recent_orders',
'permission_callback' => function () {
return current_user_can( 'manage_options' );
},
'meta' => array( 'mcp' => array( 'public' => true ) ),
) );
} );注意permission_callback那一段:哪怕这项能力在MCP里公开了,只有有管理权限的用户才能执行成功。站长看不懂代码也没关系,记住一条就行:装的插件登记了哪些公开能力、每项要求什么权限,是可以查出来的,不清楚就问插件作者。
执行前按当前用户检查权限
即便能力公开了,执行前仍然会按当前登录用户检查权限,能力自带的权限回调和WordPress的权限检查照常生效。AI客户端连接时要以某个WordPress用户的身份认证,所以AI能做什么,最终取决于这个用户能做什么。
由此引出最重要的一条建议:给AI单独建一个账户,角色给到够用为止。只需要读文章、查数据的,别给管理员;需要改内容的,编辑角色一般就够了。认证可以用WordPress自带的应用密码功能,单独生成、单独撤销,不用把主账户的密码交出去。
两种连接方式
插件支持两种连接:一种是在服务器上通过WP-CLI以STDIO方式运行,适合本机或者能登录服务器的开发者;另一种是让HTTP客户端访问站点的接口地址,默认服务器在/wp-json/mcp/mcp-adapter-default-server。通过HTTP对外开放时,要确认站点全程走HTTPS,必要时在防火墙或安全插件里限制访问来源。Claude Desktop这类桌面客户端两种方式都能用:直接走STDIO,或者通过代理走HTTP,仓库里的命令行使用指南给了两种配置示例。表格里提到的可观测性和错误处理接口主要是给开发者接监控用的,普通站长保持默认就行。
出问题去哪儿报
插件的问题和功能需求在GitHub仓库提交,安全问题要按仓库里的安全说明流程私下报告,别公开发帖。这是负责任披露的常规做法。
AI智能体在网站上的行为未必总在预期之内,站内网站要不要为AI智能体改造那篇讨论过怎么权衡。插件安全方面,破解插件的后门风险也是同一个道理:给出去的权限越大,出事时损失越大。
和其他接入方式的关系
有人会问,已经有不少第三方MCP服务器能连WordPress,还有必要用官方这个吗?
第三方方案通常直接调用WordPress的REST接口,或者自己写一套工具,功能和权限模型各家不一样。官方插件的区别在于它站在能力接口上:插件开发者登记的能力、写好的权限回调,MCP这边直接复用,不用重新定义一遍。长期看,主流插件接入能力接口以后,官方这条路会更省事,也更一致。
对已经在用Claude Code一类工具的人,配置方法和连其他MCP服务器差不多,可以参考Claude Code的MCP配置指南;MCP和Skills、Hooks这些扩展方式怎么选,可以看三种扩展机制的区别。如果你更关心的是AI怎么来“读”你的网站,而不是操作后台,那是另一类问题,Google在推的WebMCP等智能体协议更相关。
想先在不碰正式站的情况下试一下,WordPress自带的wp-env或者在线的WordPress Playground都可以起一个临时站,装上插件,登记一两个简单的能力,连上AI客户端走一遍,再决定要不要上正式站。
常见问题解答
WordPress MCP Adapter是什么?
它是WordPress官方的MCP插件,把WordPress能力接口里登记的能力转换成MCP工具、资源和提示,让兼容MCP的AI客户端能以统一的方式调用WordPress功能。它是服务器和传输层,本身不提供任何AI功能。
MCP Adapter什么时候上架官方插件目录的?
Search Engine Journal在10月7日报道了它上架WordPress.org插件目录的消息,当时的版本是0.7.0。这个插件之前只能从GitHub发布页下载,上架前已有超过4万次安装。
MCP Adapter对WordPress版本有什么要求?
需要WordPress 6.9或更高版本,因为它依赖的能力接口从6.9开始进入WordPress核心。从0.6.0版起,单独安装的能力接口插件不再被支持,旧版本WordPress要先升级本体。
装了MCP Adapter,AI就能操作我的整个网站吗?
不能。能力默认是私有的,只有被标记为公开的能力才能通过MCP调用,执行前还会按当前登录用户检查权限。AI能做什么,取决于站上公开了哪些能力,以及它用来认证的那个WordPress账户有什么权限。
AI客户端怎么连接到WordPress站点?
两种方式:通过WP-CLI以STDIO方式在服务器上运行;或者让支持HTTP的MCP客户端访问站点接口,默认服务器地址是/wp-json/mcp/mcp-adapter-default-server。连接时需要以WordPress用户身份认证。
MCP Adapter支持哪些MCP协议版本?
按0.7.0版的更新日志,它只按2025-11-25和2026-07-28两个修订版提供服务。客户端提出使用2025-06-18或2024-11-05这类旧版本时仍然能连接,统一按2025-11-25版处理。
插件开发者应该怎么接入MCP Adapter?
在能力接口里登记自己的功能并按需标记为公开,MCP Adapter会自动转换成MCP工具。插件头部加上“Requires Plugins: mcp-adapter”声明依赖。官方已经把“将MCP Adapter打包进其他插件”的做法列为弃用。
给AI用的WordPress账户该给什么权限?
建议单独建一个账户,权限给到够用为止:只读查询不用管理员,改内容一般编辑角色就够。认证可以用WordPress自带的应用密码,单独生成、随时撤销,不要把主账户密码交给AI客户端。
普通外贸站现在有必要装MCP Adapter吗?
多数内容站和外贸站暂时用处不大,因为AI能做的事取决于站上登记了哪些能力。插件开发者、管理多个站的建站公司和有技术能力的站长更用得上。可以等常用插件接入能力接口后再考虑。
官方MCP Adapter和第三方WordPress MCP服务器有什么区别?
第三方方案多是直接调REST接口或自定义一套工具,权限模型各不相同。官方插件建立在能力接口上,插件开发者登记的能力和权限回调可以直接复用,协议版本的兼容也由官方统一维护。
能力接口和WordPress的REST接口有什么区别?
REST接口按网址和请求方法提供数据,更偏向“地址在哪”;能力接口描述的是“能做什么”,每项能力带名称、说明、输入输出结构和权限回调,更适合让AI理解和发现。两者可以并存,MCP Adapter用的是能力接口。
怎么查站上有哪些能力对MCP公开了?
MCP Adapter的默认服务器提供“发现能力”这个元工具,连上AI客户端后调用它,就能列出当前用户能看到的公开能力。新装或升级插件后建议查一遍,确认没有意外公开的能力。
MCP Adapter收费吗?
不收费。它是WordPress.org上的开源插件,采用GPL-2.0或更高版本许可,由社区开发和维护,可以在后台搜索安装,也可以用WP-CLI命令安装。
WordPress多站点网络能用MCP Adapter吗?
能用。从0.6.0版起,会话存储改为按子站分开保存。多站点网络从更早版本升级上来时,正在使用的HTTP会话需要重新连接一次,单站点安装不受影响。
发现MCP Adapter的安全问题该怎么报告?
按GitHub仓库里安全说明文件的流程私下报告,不要在公开的问题列表或论坛里发帖。普通的错误和功能需求可以在GitHub仓库的问题列表提交。
权威参考资料
本文标题:《WordPress官方MCP Adapter插件上架:AI能调用哪些站点功能,由能力接口和用户权限说了算》
本文链接:https://zhangwenbao.com/wordpress-mcp-adapter-plugin-official-release.html
版权声明:本文原创,转载与引用请注明作者与原文链接。许可协议: CC BY 4.0