WordPress官方MCP Adapter插件上架:AI能调用哪些站点功能,由能力接口和用户权限说了算

WordPress官方MCP Adapter插件上架:AI能调用哪些站点功能,由能力接口和用户权限说了算
张文保 20 分钟阅读 1,017 阅读
本文目录
  1. WordPress为什么要一个“标准”的MCP插件
  2. 它是怎么工作的:能力接口加MCP
  3. 从GitHub到官方插件目录:版本和兼容性
  4. 谁需要装这个插件
  5. 装之前要守住的几道门
  6. 能力默认不公开
  7. 执行前按当前用户检查权限
  8. 两种连接方式
  9. 出问题去哪儿报
  10. 和其他接入方式的关系
  11. 常见问题解答
  12. WordPress MCP Adapter是什么?
  13. MCP Adapter什么时候上架官方插件目录的?
  14. MCP Adapter对WordPress版本有什么要求?
  15. 装了MCP Adapter,AI就能操作我的整个网站吗?
  16. AI客户端怎么连接到WordPress站点?
  17. MCP Adapter支持哪些MCP协议版本?
  18. 插件开发者应该怎么接入MCP Adapter?
  19. 给AI用的WordPress账户该给什么权限?
  20. 普通外贸站现在有必要装MCP Adapter吗?
  21. 官方MCP Adapter和第三方WordPress MCP服务器有什么区别?
  22. 能力接口和WordPress的REST接口有什么区别?
  23. 怎么查站上有哪些能力对MCP公开了?
  24. MCP Adapter收费吗?
  25. WordPress多站点网络能用MCP Adapter吗?
  26. 发现MCP Adapter的安全问题该怎么报告?
  27. 权威参考资料

摘要: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

继续阅读
发表评论
支持 Ctrl + Enter 提交