WordPress MCP Adapter (Official)

WordPress MCP Adapter (Official) とは？

WordPress MCP Adapter (Official) は WordPress プロジェクト公式の wordpress mcp プラグインです。WordPress Abilities API で登録されたアビリティ（abilities）を MCP のツール・リソース・プロンプトに変換し、Claude、Cursor、VS Code などの AI クライアントから呼び出せるようにします。

このアダプターは AI Building Blocks for WordPress イニシアチブの一部で、WordPress/mcp-adapter で GPL-2.0-or-later として公開され、WordPress.org のプラグインディレクトリにも「MCP Adapter」として掲載されています。Abilities API がコアに含まれる WordPress 6.9 以降が必要です。Automattic の旧プラグイン wordpress-mcp の後継で、旧プラグインはアーカイブされ、このリポジトリへの移行を案内しています。

WordPress MCP Adapter (Official) の使い方

前提条件：WordPress 6.9 以上、PHP 7.4 以上。Application Password で接続する場合はサイトが HTTPS であること（ローカルサイトを除き、WordPress は HTTPS でのみ Application Password を提供します）。プロキシを使うデスクトップクライアントでは Node.js も必要です。

1. プラグインをインストールして有効化します。WP-CLI の場合：

wp plugin install https://github.com/WordPress/mcp-adapter/releases/latest/download/mcp-adapter.zip --activate

プラグインはサイトアドレスの後ろに /wp-json/mcp/mcp-adapter-default-server を付けた場所にデフォルトの WordPress MCP サーバーを作成します（例：https://example.com/wp-json/mcp/mcp-adapter-default-server）。

2. ユーザー > プロフィール > Application Passwords で、アシスタントが代理で操作するユーザーの Application Password を作成します。作業に必要な最小限の権限グループを持つ専用ユーザーの利用が推奨されています。

Claude Desktop、Cursor、VS Code、Windsurf

多くのデスクトップクライアントは @automattic/mcp-wordpress-remote プロキシを起動し、STDIO のメッセージを HTTP でサイトに転送します。Claude Desktop では Settings > Developer > Edit Config を開き、Cursor では ~/.cursor/mcp.json を編集します：

{
  "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": "your-username",
        "WP_API_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

保存してアプリを再起動します。サイト側が対応していれば、プロキシは OAuth（OAUTH_ENABLED=true）や JWT トークン（JWT_TOKEN）にも対応しています。

Claude Code

Claude Code は Basic 認証ヘッダーを付けて HTTP で直接接続できます。username:application-password を 1 行の base64 にエンコードしてからサーバーを追加します：

printf 'your-username: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 PASTE_THE_BASE64_HERE"

WP-CLI によるローカルサイト（STDIO）

WordPress が自分のマシンで動いている場合、クライアントが WP-CLI 経由でアダプターを直接起動でき、パスワードは不要です：

{
  "mcpServers": {
    "wordpress": {
      "command": "wp",
      "args": [
        "--path=/path/to/your/wordpress/site",
        "mcp-adapter",
        "serve",
        "--server=mcp-adapter-default-server",
        "--user=admin"
      ]
    }
  }
}

wp mcp-adapter list で登録済みのサーバーを確認できます。

接続テストには「List the WordPress abilities you can use on my site.」（このサイトで使える WordPress のアビリティを一覧にして）のようなプロンプトを使います。

WordPress MCP Adapter (Official) の主な機能

• WordPress 公式パッケージ。WordPress の GitHub 組織で保守され、WordPress.org で配布
• Abilities API のアビリティを MCP のツール・リソース・プロンプトへ自動変換
• HTTP トランスポート（Mcp-Session-Id セッションを使う MCP Streamable HTTP）と、wp mcp-adapter serve による STDIO
• デフォルトで非公開：meta.public（または meta.mcp.public）が付いたアビリティのみ利用可能
• すべての呼び出しは WordPress ユーザーとして実行され、権限グループと権限がそのまま適用される
• 1 サイトで複数の MCP サーバーを運用でき、それぞれ独自のトランスポート・アビリティ・権限チェックを持てる
• 差し替え可能なエラーハンドリングとオブザーバビリティのインターフェース、カスタムトランスポート
• 開発者は Requires Plugins: mcp-adapter で依存関係を宣言可能。composer require wordpress/mcp-adapter もあるが同梱は非推奨

WordPress MCP Adapter (Official) のツール

デフォルトサーバーは、サイト上のアビリティ数に関係なく 3 つのメタツールだけを公開し、tools/list を小さく保ちます：

• 検出： mcp-adapter-discover-abilities は公開アビリティの名前・ラベル・説明を一覧表示します。
• 確認： mcp-adapter-get-ability-info は 1 つのアビリティの入力・出力スキーマを返します。
• 実行： mcp-adapter-execute-ability は、アビリティが公開されていることを確認し、そのアビリティ自身の権限コールバックを実行したうえで、パラメーター付きで実行します。

アシスタントが実際に何をできるか（下書き作成、サイト情報の取得など）は、WordPress コアとプラグインが登録するアビリティ次第です。アビリティごとに個別の MCP ツールを公開したい開発者は、mcp_adapter_init フックでカスタムサーバーを作成できます。

WordPress MCP Adapter (Official) のユースケース

• アビリティを登録したプラグインを通じたコンテンツ作業：「Create a draft post titled 'Fall menu' with this text.」（このテキストで「Fall menu」という下書きを作成して）
• Claude Code や Cursor から WP-CLI STDIO でローカルサイトに接続し、プラグインのアビリティをテスト
• プラグイン開発者が別途 MCP サーバーを書かずに、機能を AI エージェントへ公開
• 制作会社が編集者（Editor）レベルのユーザーで、アシスタントに範囲を限定したクライアントサイトへのアクセスを付与
• サイトが何を公開しているかの監査：「Which abilities are public on this site, and what inputs do they take?」（このサイトで公開されているアビリティと、その入力は？）

WordPress MCP Adapter (Official) と代替ツールの比較

• Automattic wordpress-mcp： 以前のプラグインで、現在はアーカイブ済み。Automattic の告知は MCP Adapter への移行を案内しています。
• コミュニティ製の WordPress MCP サーバー： mcp-wordpress（docdyhr）や WordPress MCP Server（prathammanocha）などは WordPress の外で Node.js サーバーとして動作し、Application Password で REST API を呼び出します。そのため独自の固定ツールセットを持ち、サイトに登録されたアビリティには依存しません。一方アダプターは WordPress 内部で動作し、プラグインが登録したものだけを公開します。

WordPress MCP Adapter (Official) のトラブルシューティング

• 401 Unauthorized： 表示名ではなくログイン名かメールアドレスを使い、Application Password が完全にコピーされ失効していないか確認します。一部の Apache 環境では、Authorization ヘッダーを PHP に渡すようホスティング会社に依頼してください。
• 404 または rest_no_route： プラグインが有効か確認します。パーマリンクが「基本」の場合は https://example.com/?rest_route=/mcp/mcp-adapter-default-server を使います。
• 接続できたが何もできない： プラグインがアビリティを公開するまで一覧は空です。Abilities API に対応したプラグインをインストールしてください。
• npx: command not found： Node.js をインストールしてクライアントを再起動します。
• Missing Mcp-Session-Id header： HTTP クライアントは最初に initialize を送り、返されたセッション ID を以降のリクエストに付ける必要があります。