Royal MCP

セキュリティ最優先のWordPress用MCPサーバー。 Claude、ChatGPT、GeminiをAPIキー + OAuth 2.1認証、完全なアクティビティログ、ケイパビリティベースのアクセス制御でWordPressサイトに接続します。

WordPress.orgでダウンロード · ドキュメント · Royal Plugins

WordPressサイトをModel Context Protocolサーバーとして公開するプラグインです。AIエージェント（Claude.ai web、Claude Desktop、ChatGPT、カスタムクライアント）は、投稿、ページ、メディア、ユーザー、メニュー、WooCommerce注文、Elementorページを読み書きでき、すべての呼び出しはケイパビリティゲーティング、レート制限、監査ログを通過します。公式のWordPress.orgプラグインディレクトリから配布されています。

クイックファクト

Related MCP server: wp-mcp

機能

WordPressコア（84ツール、常時利用可能）

• コンテンツ — 投稿、ページ、カスタム投稿タイプ（完全なCRUD + リビジョン + アイキャッチ画像）

• タクソノミー — カテゴリー、タグ、カスタムタクソノミー、タームメタ、投稿-タームの関連付け

• メディア — 閲覧、アップロード（URLまたはbase64）、メタデータ更新、削除

• コメント — 作成、モデレーション（承認 / スパム / ゴミ箱）

• ユーザー — 表示名とロールの読み取り（メールアドレスとユーザー名は公開されません）

• メニュー — 読み取り、アイテム作成、並べ替え、破壊的書き込みガード付きで更新

• テーマ — カスタムCSS、テーマモッド、アクティブテーマの検出

• サイト — パーマリンク構造、オプション（許可リスト）、サイト情報

• 検索 — クエリによるコンテンツ横断検索

• SEO — プラグインが有効な場合のYoast / Rank Math / AIOSEOメタの読み書き

• 診断 — サイトステータス（WP/PHP/MySQL/プラグイン/テーマ/cronを1回の呼び出しで）、PHPエラーログの末尾、WP cronスケジュール、MCP royal_mcp_connection_health（ルート、認証方法、セッションID、プラグインバージョン、Divi + Elementor + Gutenbergのアクティブなページビルダーバージョンを返します）

プラグイン連携（80ツール、条件付き）

連携プラグインが有効な場合にのみ自動登録されます。

WordPress Abilities APIブリッジ（WP 6.9+）

WordPress 6.9にはAbilities APIが搭載されました。これは、AIエージェントが呼び出せる型付きケイパビリティをプラグインが登録できるようにするプリミティブです。1.4.38以降、Royal MCPのすべてのツールはWordPressアビリティとしても登録され、同じハンドラーに到達する3つの方法が提供されます。

1. ネイティブ — Royal MCPの/wp-json/royal-mcp/v1/mcp Streamable HTTPエンドポイント（変更なし、常に利用可能）。

2. WP MCP Adapter — wordpress/mcp-adapterパッケージがインストールされている場合、Royal MCPはアダプターのデフォルトサーバーとともにmcp_adapter_initフックに名前付きroyal-mcp-serverを登録します。

3. WPコアREST — WPコアのエンドポイントを好む呼び出し元向けに、/wp-json/wp-abilities/v1/abilities/{name}/runでの直接アビリティ呼び出し。

同じハンドラー、3つのトランスポート、1セットのツールごとのケイパビリティゲート。ブリッジはroyal_mcp_abilities_registration_enabledオプションで無効化できます（デフォルト：オン）。

対象外

明確なスコープ境界 — 統合モデルは「確実に動作する狭いツール」であり、「すべてのAPIサーフェスを公開する」ことではありません。

• Elementorウィジェットレベルのゼロからの生成は行いません。 アトミックウィジェット（Editor V4）は不透明なまま通過します。Elementor自体がそれらを変更する可能性があるため、アトミックスキーマをデコードすることはありません。

• Beaver Builder / BricksページビルダーJSONの書き込みは行いません。 標準の投稿コンテンツは読み書き可能ですが、ページビルダー固有のJSONストレージは、専用ツールでカバーされない限り不透明です。（ElementorとDiviには専用ツールがあります — 上記の連携テーブルを参照してください。）

• テーマビルダーテンプレートの作成は行いません（Elementorまたはその他）。

• コアファイルの変更は行いません — Royal MCPはwp-content/themes、wp-includes、wp-adminに書き込むことはありません。

• MCP経由のプラグインインストールやアップグレードは行いません。 発見は可能。インストール/有効化/無効化は不可。

• 生のSQLは使用しません。 クエリはWP_Queryと$wpdb->prepare()のみを通過します。

Royal MCP Pro（有料）

無料プラグインは個人サイトオーナー向けに完全な機能を備えています。Royal MCP Proは、代理店やマルチサイト運営者向けに拡張します。

• Divi Proスイート — ページ複製、画像差し替え、テンプレートインポート、完全なライブラリCRUD、D4→D5マイグレーター、グローバルプリセット一括適用（8ツール）

• Elementor Proの深い連携 — 無料版の連携を超える追加のElementorツール

• ユニバーサル監査ログ — すべてのAI操作を帰属情報付きで記録 + エクスポート

• すべての書き込みに対する72時間のアンドゥ — Proの破壊的ツールはすべてアンドゥトークンを返し、期間内なら任意の操作を元に戻せます

• 標準のWordPressアップデータによるライセンスゲート付き更新 — 外部ライセンスサーバーへの実行時依存なし

royalplugins.com/royal-mcp-proで詳細を見る

接続

インストール

1. WordPress.orgからインストール（推奨 — WP管理画面から自動更新）またはGitHubリリースのzipをアップロード。

2. Royal MCP → 設定 → APIキーを生成をクリック。

3. 以下のクライアントから選択。

Claude.ai web（OAuth — 推奨）

最も簡単な方法 — 設定ファイルの編集も、クライアントへのAPIキー入力も不要です。

1. Claude.aiで設定 → コネクター → カスタムコネクターを追加。

2. URL: https://yoursite.com/wp-json/royal-mcp/v1/mcp

3. プロンプトが表示されたらOAuth同意画面を承認。Claude.aiがサイトに対する動的クライアント登録 + PKCEフローを処理します。

Claude Desktop（.mcpbワンクリックバンドル — 1.4.38の新機能）

Claude Desktopで最も簡単な方法 — mcp-remoteもnpxも設定ファイルの編集も不要です。

1. 最新のGitHubリリースからroyal-mcp-1.4.38.mcpbをダウンロード。

2. .mcpbファイルをダブルクリック — Claude Desktopがインストールプロンプトを開きます。

3. プロンプトが表示されたらサイトURLとAPIキーを入力。接続が確立されます。

このバンドルには、Claude Desktopに同梱されているNode ≥18用の依存関係ゼロのstdio-to-HTTPSブリッジが含まれています。.mcpb仕様についてはClaude Desktop MCP Bundlesを参照してください。

Claude Desktop（mcp-remote経由のOAuth）

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://yoursite.com/wp-json/royal-mcp/v1/mcp"]
    }
  }
}

設定パス: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows)。

Claude Desktop (APIキー)

OAuthをスキップしてヘッダー経由で認証:

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://yoursite.com/wp-json/royal-mcp/v1/mcp",
        "--header", "X-Royal-MCP-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

ChatGPT

ChatGPTのカスタムMCPコネクタはClaude.ai webと同じURLを使用します。ChatGPTのコネクタフローに従い、https://yoursite.com/wp-json/royal-mcp/v1/mcp を貼り付けてください。

Raw HTTP (カスタムクライアント)

# 1. Initialize a session. -i prints headers so you can grab Mcp-Session-Id.
curl -i -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "X-Royal-MCP-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "id": 1,
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {"name": "my-app", "version": "1.0"}
    }
  }'

# 2. List available tools using the session id from the response header.
curl -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "X-Royal-MCP-API-Key: YOUR_KEY" \
  -H "Mcp-Session-Id: <session_id>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 2}'

セキュリティモデル

完全なセキュリティアーキテクチャ: royalplugins.com/support/royal-mcp/

プロジェクトの状態

• アクティブなメンテナンス — ほぼ毎週リリース。変更履歴は releases を参照。

• MCP仕様準拠 — Streamable HTTP transport (2025-11-25) を実装。

• Issues — github.com/royalplugins/royal-mcp/issues。顧客に影響する問題は通常24時間以内に認識され、バージョン目標とともにトリアージされます。

• コントリビューション — PR歓迎。プラグインのソースはこのリポジトリとwp.orgのSVN trunkの両方にコミットされており、リリースはwp.orgのレビュープロセスを通じて調整されます。

関連資料

• Editing Elementor with Claude: The Four Workflows That Work Today — AIでElementorページを編集するための4つの実用的なアーキテクチャと、それぞれをいつ使うべきか。プロンプト、例、クローン＆カスタマイズフローのビデオデモ付きのユーザー向けバージョン。

• Editing Elementor with Claude: 4 MCP Architectures — Hashnodeのエンジニア向け版。elementor_clone_page の内部のPHP、6つのツールシグネチャ、HTTP-BasicとOAuth 2.1の認証モデルのトレードオフ。

関連プロジェクト

• GuardPress — WordPressセキュリティ強化

• SiteVault — WordPressバックアップと移行

• ForgeCache — キャッシュとパフォーマンス

• FormForge — PDF生成対応のフォームビルダー

• SEObolt — WordPress向けSEOツールキット

ライセンス

GPLv2以降 — LICENSE または GNUサイト を参照。

Royal MCPは現状のまま提供されます。APIキーはエンドポイントを保護します。他の認証情報と同様に厳重に管理してください。AIプラットフォームがWordPressサイトで実行できるコンテンツ、コマンド、アクションについては、お客様の責任となります。