MCP Adapter装好却连不上？十分钟接线指南

插件装了、也启用了，AI 客户端里却还是那句「没有可用的工具」。MCP Adapter 的坑不在安装，在接线：它只给你的站点加了一个地址，剩下三件事——账号、密码、客户端配置——都得自己填对。

先说清这个插件到底加了什么

当前版本 0.7.1（10 月 15 日更新），活跃安装量 5 万+，要求 WordPress 6.9 或更高、PHP 7.4 或更高，兼容到 7.1.3。它做的事只有三件：在你的站点上加一个地址；把站点上已经注册过的 abilities（能力）变成 MCP 工具；客户端连上之后，只看到三个工具——列出公开能力、读某个能力的详情、执行它。

它本身不提供任何 AI 功能，后台也不会多出什么界面。所以「装了没反应」是正常现象：能力得由 WordPress 核心或其他插件注册，而且要标记为公开，MCP 才能看到。

第一步：给 AI 建一个专用账号和应用密码

• 别用管理员。用 Editor 能做完的事，就不要给 Administrator 的应用密码。
• 站点必须是 HTTPS，否则「个人资料」页里根本不会出现「应用程序密码」这一块。
• 路径：用户 → 个人资料 → 应用程序密码 → 起个能认出来的名字（比如「Claude on my laptop」）→ 复制。这串密码只显示一次，中间的空格是格式的一部分，留着。
• 一个客户端配一个密码，以后想单独掐断某个设备，点撤销就行，不影响其他的。

第二步：把地址和密码给客户端

连接地址 = 「设置 → 常规」里的站点地址，加上 /wp-json/mcp/mcp-adapter-default-server。站点装在子目录里的，路径也要带上。

桌面客户端（Claude Desktop、Cursor、VS Code、Windsurf 等）读的是一个 JSON 配置，填四个值：

• command 填 npx
• args 填 -y 和 @automattic/mcp-wordpress-remote@latest
• env.WP_API_URL 填你的连接地址
• env.WP_API_USERNAME 填登录名，env.WP_API_PASSWORD 填刚复制那串应用密码

合起来就是一整行（可直接复制改值）：{"mcpServers":{"my-wordpress-site":{"command":"npx","args":["-y","@automattic/mcp-wordpress-remote@latest"],"env":{"WP_API_URL":"https://example.com/wp-json/mcp/mcp-adapter-default-server","WP_API_USERNAME":"你的登录名","WP_API_PASSWORD":"xxxx xxxx xxxx xxxx xxxx xxxx"}}}}

Claude Desktop 在 Settings → Developer → Edit Config 打开这个文件；Cursor 的配置在 ~/.cursor/mcp.json。改完重启客户端。这条路径要求本机装了 Node.js，因为中间要靠 @automattic/mcp-wordpress-remote 这个小助手转发请求。

能自定义请求头的客户端（Claude Code 等）可以跳过助手，直接走 HTTP。先把用户名和密码拼成一行再 base64：printf '你的登录名:xxxx xxxx xxxx xxxx xxxx xxxx' | base64 | tr -d '\n'

然后把得到的字符串贴进请求头，一条命令搞定：claude mcp add --transport http my-wordpress-site https://example.com/wp-json/mcp/mcp-adapter-default-server --header "Authorization: Basic 粘贴刚才那串base64"

站点跑在自己电脑上、又有 WP-CLI 的，可以连密码都不用，直接起 STDIO：wp mcp-adapter serve --user=admin --server=mcp-adapter-default-server。

第三步：用一句话验证通没通

新开一个对话，问它：列出你能在我站点上使用的 WordPress abilities。

返回一份清单，哪怕清单是空的，也说明连接成功了——空清单代表站点上还没有把能力标记为公开。如果它报错，就是没连上，往下看。

四种典型故障，对号入座

401 未授权。 用户名要用登录名或邮箱，不是后台显示的名字；密码确认复制完整、没被撤销；还有一种常见情况是服务器把 Authorization 请求头剥掉了，WordPress 根本收不到。标准 .htaccess 里有透传这一行，被改过或主机配置不同，就要让主机把该请求头传给 PHP。

个人资料里没有「应用程序密码」。 站点不是 HTTPS，或者安全插件、主机把它关掉了。先查协议，再查安全插件设置。

404 或 rest_no_route。 先在浏览器里打开那个连接地址，看返回什么。如果返回的是网页（首页或服务器自己的 404），说明地址没被当成 API 请求，问题在固定链接或重写规则：用朴素固定链接的站，/wp-json/ 这类地址不生效，要换成 https://example.com/?rest_route=/mcp/mcp-adapter-default-server；固定链接正常但服务器返回自己的 404，去「设置 → 固定链接」点一次保存，把规则重写一遍。如果返回的是 rest_no_route 的 JSON，就是地址拼错、插件没启用，或者你装的是 GitHub 源码版、缺文件——删掉，改从官方插件目录安装。

连上了但没东西可做。 说明没有插件把 abilities 标记为公开，或者当前账号的角色没有对应权限。这一步只能靠「装一个会注册能力的插件」解决，MCP Adapter 自己变不出来。

权限这块，官方做对了两件事

一是主动开放：只有标记为公开的能力才走 MCP，而且每次执行前还要按当前用户权限再判一遍。二是可撤销：每个应用密码在个人资料页都能看到最后使用时间，点撤销立刻断开。对一个要交给 AI 改内容的站点来说，这两条比功能多少更重要。

但有个硬限制得知道：claude.ai、ChatGPT 这类网页版是通过 OAuth 登录添加连接器的，而 WordPress 没有内置 OAuth 服务，这个插件也没有补上，所以网页版连不上它。要么用桌面客户端，要么额外装一个给站点加 OAuth 登录的插件。

我的看法

这插件的定位不是「让 AI 接管网站」，而是给「AI 改站」这件事划一条能审计的边界：谁连的、用什么权限、能做什么，后台都查得到，也能一键掐断。真正卡住普通站长的是能力生态——现在公开的 abilities 还不多，连上之后能干的事有限。

所以现阶段合理的用法是：先把它当一条权限管道装好，验证通路，再等你要用的插件开始注册能力，按需逐个放开。反过来做，一上来就把管理员的应用密码交给客户端，等于把边界管理这件唯一的价值也扔了。

最后

顺序别反：建最小权限账号和应用密码 → 配客户端 → 用一句「列出能力」验证 → 最后才按需放开写操作。官方地址：wordpress.org/plugins/mcp-adapter/，文档与问题反馈在 github.com/WordPress/mcp-adapter。