説明
Royal MCP は、WordPress 向けのセキュリティを最優先する Model Context Protocol (MCP) サーバーです。Claude、ChatGPT、Google Gemini などの AI プラットフォームに、WordPress コンテンツへの構造化されたアクセスを提供します — 多くの MCP 実装がまったく省略している認証、レート制限、監査ログ機能付きです。
初回セットアップのウォークスルー(動画あり): royalplugins.com/support/royal-mcp/connecting-to-claude/
最近のセキュリティ調査によると、公開されている MCP サーバーの 41% は認証がなく、認証情報なしでツール呼び出しに応答します。Royal MCP はその逆のアプローチを取ります: すべての MCP セッションに API キーが必要で、すべてのリクエストにレート制限がかかり、すべてのやり取りがログに記録されます。
MCP においてセキュリティが重要な理由
MCP は AI エージェントに、WordPress コンテンツの読み取り、作成、更新、削除を行う機能を与えます。適切な認証がなければ、MCP エンドポイントを見つけた人は誰でも次のことができてしまいます:
- 投稿、固定ページ、メディアをすべて読み取る
- コンテンツを作成または削除する
- ユーザーデータやプラグイン情報にアクセスする
- 矢継ぎ早のリクエストでサーバーに過負荷をかける
Royal MCP は、セッション初期化時の API キー認証、タイミングセーフなキー比較、IP 単位のレート制限 (60リクエスト/分)、すべての MCP のやり取りの完全なアクティビティログによって、これらすべてを防ぎます。
無料、セルフホスト、フル機能
Royal MCP は無料の GPL ライセンスリリースでフル機能を提供します。Pro 版は存在しません — すべてのツールが wp.org プラグインに同梱されており、更新は標準の WordPress プラグインアップデーターを通じて行われます。
認証情報はサーバー上にとどまります。Royal MCP はすべて WordPress 内で完結して動作します: API キー、OAuth トークン、セッション状態はすべて自分のデータベースに保存されます。Royal MCP は Royal Plugins 自身のサーバーへのアウトバウンド接続を一切行いません — ライセンスチェックも、テレメトリーも、トラフィックビーコンもありません。AI 推論もローカルに保ちたい場合は、Ollama と LM Studio が Claude、ChatGPT、Gemini と並ぶファーストクラスのプラットフォームとして利用できます。
AI エージェントがサイトで何をしているかを確認
Royal MCP は AI エージェントを WordPress に接続します。無料の連携プラグイン Royal AI Firewall を使うと、Royal MCP 経由で接続したものだけでなく、HTTP レイヤーでサイトにアクセスするすべての AI エージェント (学習用クローラー、取得ボット、AI 検索エンジン) を把握できます。
両方をインストールすると監査ログが一本化されます。MCP のツール呼び出しと HTTP レイヤーのボットアクセスが1つのダッシュボードに並んで表示され、認識済みの60種類以上の AI エージェントについて、ボットごとに許可 / ブロック / ログのみを制御できます。Royal AI Firewall は永久に無料で、アップグレードの案内も表示されません。
78のコアツール + 74の連携ツール
WordPress コア (78ツール):
- 投稿 – 作成、読み取り、更新、削除、検索、カウント (登録されている任意の公開投稿タイプに対応、アイキャッチ画像対応)
- 固定ページ – 親ページに対応した完全な CRUD
- 投稿タイプ – サイトに登録されているすべての公開投稿タイプを検出する
- 投稿のリビジョン – リビジョン履歴を一覧表示し、投稿を任意の以前のバージョンに戻す
- メディア – 閲覧、URL または base64からのアップロード、代替テキスト/キャプション/タイトル/説明の更新、アイキャッチ画像への設定、削除
- コメント – 作成、読み取り、削除。完全なモデレーション機能 (承認待ちの一覧表示、承認、スパムとしてマーク、ゴミ箱へ移動)
- ユーザー – 表示名とロール (メールアドレスとユーザー名は公開されません)
- カテゴリー & タグ & カスタムタクソノミー – 作成、更新 (名前変更/スラッグ変更/編集/移動)、削除、割り当て、カウント、登録されているすべてのタクソノミーを検出
- タクソノミーメタ – 読み取り、更新、削除 (カテゴリーやタグに紐づくタクソノミーレベルの SEO メタ — タイトル、説明、フォーカスキーワード — に最も役立ちます)
- メニュー – メニューの一覧表示、メニュー項目の一覧表示、メニュー項目の作成 / 更新 / 削除 / 並べ替え
- 投稿メタ – カスタムフィールドの読み取り、更新、削除 (ACF、MetaBox、JetEngine、Pods、CPT UI に対応)
- SEO メタ – Yoast SEO または Rank Math のタイトル/説明/フォーカスキーワード/robots/OG フィールドを読み取り・書き込み (有効な SEO プラグインを自動検出)
- SEO Audit – fetch a post’s actual rendered HTML and report title, meta description, canonical, viewport, Open Graph and Twitter Card tags (catches conflicts that only appear in served output)
- Widgets – list widget instances (optionally filtered by sidebar), list registered sidebars, and update widget content; writes gated by the theme-appearance admin toggle
- Find and Replace – literal find/replace inside post/page content with dry-run preview, expected-count safety check, and read-after-write verification
- Undo – reverse the previous delete or reorder within 72 hours via mcp_undo_last_operation
- サイト情報 – サイト名、説明、WordPress バージョン、タイムゾーン
- サイトステータス – AI による書き込み前の検証に使う、サイトヘルスの全体スナップショット (WordPress のバージョン、PHP のバージョン、有効なテーマ、有効なプラグイン、cron の稼働状況)
- エラーログ – 直近の PHP エラーログのエントリーを読み取り、AI エージェントがシェルにアクセスせずに気付きにくい障害を診断できるようにする
- Cron スケジュール – スケジュール済みの WP cron イベントを、次回実行時刻とフック名付きで一覧表示
- 接続ヘルス – 認証済みの呼び出し元に対してルート、認証方式、セッション ID、Royal MCP のバージョン情報を返す MCP セッションの診断
- プラグイン & テーマ – インストール済みのプラグインとテーマを有効状態とともに一覧表示
- テーマの外観 – 有効なテーマの取得、テーマ変更の読み取り/書き込み (管理者トグル + 許可リストでゲート)、カスタム CSS の読み取り/書き込み
- 検索 – 投稿タイプを横断した全文コンテンツ検索
- パーマリンク構造 – パーマリンク設定の読み取りと更新 (管理者トグルでゲート)
- オプション – 許可リストに登録されたコアオプションの読み取り、スラッグによるプラグイン設定全体の読み取り (機密キーは編集済み)、管理者が有効にした場合の許可リストオプションへの書き込み
プラグイン連携 (条件付き)
Royal MCP は互換性のあるプラグインを自動検出し、専用の MCP ツールを追加します。設定は不要です — プラグインが有効であれば、ツールが表示されます。
WooCommerce 連携 (26ツール):
WooCommerce が有効な場合、AI エージェントはストアをエンドツーエンドで管理できます:
- カテゴリー、ステータス、タイプ別に商品を閲覧・検索する
- 価格、SKU、在庫レベルを指定して単純商品と可変商品を作成・更新する
- 可変商品を管理する — 商品バリエーションの一覧表示、取得、作成、更新、削除、一括更新
- グローバル属性 (
pa_*タクソノミー) を管理する — 登録済み属性の一覧表示、属性タームの一覧表示、新しい属性の登録、バリエーション軸としての商品への属性の割り当て - クーポンを管理する — 一覧表示、コードによる検索、取得、作成、更新、削除 (ゴミ箱または完全削除)、ゴミ箱の一括消去。標準の WC クーポンフィールド (割引タイプ、有効期限、利用制限、商品/カテゴリー制限、メール許可リスト) すべてに対応
- 注文と注文詳細を表示し、注文ステータスを更新する
- Create and update orders and attach order notes — for B2B, wholesale, phone orders, and support-note trails
- 注文数と合計購入金額とともに顧客を一覧表示する
- 期間別の売上、注文数、平均注文額などストア統計を取得する
Elementor 連携 (8ツール):
Elementor (無料版または Pro) が有効な場合、AI エージェントはゼロからページビルダーの JSON を生成しようとすることなく、既存の Elementor ページを複製・カスタマイズできます:
- 新しいタイトルと新規の要素 ID で既存の Elementor ページを複製する (複製したページが ID 衝突なしでエディターで開けるように)
- 各ウィジェット heading、text-editor、button、image-box、icon-box、icon-list、testimonial、tabs、accordion、toggle、star-rating、call-to-action、flip-box を横断してテキストを一括置換する
- 各ウィジェット image、image-box、background_image、gallery の設定を横断して画像 URL を入れ替える
- 任意のページのコンパクトなアウトライン (セクション/コンテナの階層、ウィジェットタイプ、テキストスニペット) を取得する。これにより、Claude は生の JSON の代わりに数 KB でページ全体を把握して推論できる
- ウィジェット / コンテナ / セクション / カラムを ID 指定で、その設定全体を読み取る (ページツリー全体を読み込まずにエージェントが正確に編集するため)
- Elementor テンプレートライブラリから保存済みテンプレートを一覧表示し、JSON からテンプレートをインポートする
- アトミックウィジェット (Elementor 4.0以降の Editor V4要素) は不透明なまま通過します — Elementor 自体がスキーマを変更する可能性があるため、アトミックスキーマをデコードすることはありません。ウィジェット単位でのゼロからの作成は意図的にスコープ外です。設計上のコミットメントは、既存の動作確認済みのソースから作業することです。
Advanced Custom Fields 連携 (4ツール):
ACF(無料版または Pro)が有効な場合、AI エージェントは ACF UI が使用するフィールドタイプ対応のフォーマットで ACF フィールドの読み取りと書き込みを行えます。WordPress メタが返す生のシリアライズ値の代わりに次のことが可能です:
- Return Format 設定に従ってフォーマットされた(ハイドレートされた投稿オブジェクト、解析されたリピーターの行、画像配列など)単一の ACF フィールドを読み取ります。
- 名前、ラベル、タイプ、値をひとまとめにして、1回の呼び出しで投稿のすべての ACF フィールドを読み取ります。AI がどのフィールドが存在するかを確認してすべてを読み取る最も効率的な方法です。
- タイプを考慮した値の処理(テキスト・数値はスカラー、リピーターとフレックスコンテンツは配列、リレーションシップは投稿 ID、画像は添付ファイル ID)で ACF フィールドを更新します。
- サイト上の ACF フィールドグループを列挙します。投稿タイプによるフィルタリングもでき、読み取りや書き込みの前に利用可能なカスタムフィールドを AI が探索するのに役立ちます。
GuardPress 連携 (7ツール):
GuardPress が有効な場合、AI エージェントはサイトのセキュリティを監視できます:
- 要因別の内訳とともに現在のセキュリティスコアとグレードを取得する
- 失敗したログイン、ブロックされた IP、アラートなどのセキュリティ統計を表示する
- 脆弱性スキャンを実行し、結果を確認する
- ブロックされた IP アドレスとログイン失敗試行を一覧表示する
- 重要度でフィルタリングしたセキュリティ監査ログを閲覧する
Royal AI Firewall 統合 (6ツール):
無料の連携プラグイン Royal AI Firewall をインストールすると、Royal MCP は MCP の呼び出し元だけでなく、サイトにアクセスするすべての AI エージェントを完全に可視化できます。Royal MCP 経由で接続した AI エージェントも、追加の6ツールを通じてボットのトラフィックを確認し、ポリシーを更新できます:
- ダッシュボードの統計を表示 — サイト全体の総アクセス数、ユニークボット数、上位のボット、上位のパス
- 直近のボットアクセスを、ボットごとの詳細、タイムスタンプ、リクエストされたパス付きで取得
- 既知のボットシグネチャーごとに AI ボットのポリシー (許可、ブロック、チャレンジ) を一覧表示
- AI ボットのポリシーを更新し、既知のシグネチャーを許可、ブロック、チャレンジに設定 (管理者のみ)
- 日次集計を取得 — 傾向を把握するための、過去 N 日間のボット別トラフィック集計
- 1回の呼び出しで全 AI ボットをブロック — 既知の AI エージェントのシグネチャーをすべて一度に対象とする緊急ロックダウン
SiteVault 連携 (6ツール):
SiteVault が有効な場合、AI エージェントはバックアップを管理できます:
- ステータスやタイプでフィルタリングした利用可能なバックアップを一覧表示する
- 新しいバックアップを開始する (完全、データベース、ファイル、プラグイン、テーマ)
- バックアップの進捗をリアルタイムで確認する
- 合計サイズ、最終バックアップ、件数などのバックアップ統計を表示する
- バックアップスケジュールを一覧表示して確認する
ForgeCache 連携 (3ツール):
ForgeCache が有効な場合、AI エージェントはページキャッシュを管理できます:
- キャッシュ全体をクリアする、または特定の URL をパージする
- ヒット率、ファイル数、合計サイズなどのキャッシュ統計を表示する
Royal Ledger 連携 (4ツール):
Royal Ledger が有効な場合、AI エージェントはソフトウェアコストとライセンスデータを確認できます:
- 継続的なソフトウェアコストと更新日を一覧表示する
- 月、ベンダー、またはカテゴリーでグループ化されたコストサマリーを取得する
- 保存されているライセンスキーを一覧表示する (キーの値は公開されません — マスクされたプレビューのみで、復号には wp-admin へのログインが必要です)
Royal Links 連携 (3ツール):
Royal Links が有効な場合、AI エージェントはブランド短縮リンクを管理できます:
- クリック数とターゲット URL とともに既存のリンクを一覧表示する
- 新しいブランド短縮リンクを作成する
- 任意のリンクのクリック統計を取得する
Redirection 統合 (4ツール):
John Godley 氏の Redirection プラグインが有効な場合、AI エージェントは 301 / 302 / 307 リダイレクトを管理できます:
- グループと URL の部分一致で絞り込んでリダイレクトを一覧表示
- 新しいリダイレクトを作成 (転送元、転送先、ステータスコード、正規表現、グループ、タイトル)
- 既存のリダイレクトを更新 (転送先、ステータス、有効状態)
- リダイレクトグループを一覧表示
Royal MCP と WordPress コアの Abilities API
WordPress 6.9は 2025年 11月に Abilities API を出荷しました — プラグインが、AI エージェントが呼び出せる型付きのケイパビリティを登録できるようにするプリミティブです。コアは 3つのデフォルトのアビリティ (サイト情報、ユーザー情報、環境情報) を出荷しており、wordpress/mcp-adapter パッケージがアビリティを MCP プロトコルに橋渡しします。
1.4.38 以降、すべての Royal MCP ツールは WordPress のアビリティとしても登録されます。同じツールへのアクセス方法は3通りあります。(1) Royal MCP ネイティブの /wp-json/royal-mcp/v1/mcp エンドポイント (従来どおりで常に利用可能)、(2) WordPress MCP Adapter をインストールしている場合はそのアダプター経由 (Royal MCP はアダプターのデフォルトサーバーとは別に royal-mcp-server という名前付きサーバーを登録します)、(3) WordPress コアの REST を直接呼ぶ /wp-json/wp-abilities/v1/abilities/{name}/run。ハンドラーは同一、トランスポートは3種類、ツールごとの権限ゲートは1組です。アビリティ層は必要に応じてオプションのフラグ1つで無効化できます。
Royal MCP は、公式アダプターに先駆けて存在する、完全な実運用対応の MCP サーバーです。完全な Streamable HTTP トランスポートを実行し、すべてのリクエストで API キー認証を強制し、Claude Desktop のネイティブコネクタフロー用に OAuth 2.0を出荷し、IP 単位でレート制限をかけ、機密データを編集し、すべてのやり取りをログに記録します。標準で、WordPress コア操作用の 67ツールに加え、WooCommerce、GuardPress、Royal AI Firewall、SiteVault、ForgeCache、Royal Ledger、Royal Links、Elementor、Advanced Custom Fields (ACF)、Redirection が有効な場合に自動読み込みされる 74の連携ツールが含まれます。
サポートされている AI プラットフォーム
- Claude (Anthropic) – Claude Desktop、Claude Code、VS Code を通じたフル MCP サポート
- OpenAI / ChatGPT – GPT-5.5、GPT-5、GPT-5 Mini、o3
- Google Gemini – Gemini 3.5 Flash、3.1 Flash-Lite
- Groq – Llama 3.3、Llama 3.1、GPT-OSS
- Azure OpenAI – Azure でホストされる OpenAI デプロイメント
- AWS Bedrock – Claude、Llama、Titan モデル
- Ollama / LM Studio – ローカルのセルフホストモデル (外部へのデータ送信なし)
- カスタム MCP サーバー – 任意の MCP 互換エンドポイントに接続
互換性のあるクライアント & フレームワーク
Royal MCP は、ツールごとの設定なしに、MCP 準拠の任意のクライアント、IDE、AI エージェントフレームワークで動作します。以下の各項目は、Royal MCP がそのターゲット向けに提供する具体的な連携方法を説明しているため、顧客は「すでに使っているツールで動作するか ?」という疑問に答えられます:
- デスクトップ AI アプリ – Claude Desktop (OAuth 2.0によるネイティブ MCP コネクタ)、ChatGPT Desktop、Gemini Advanced。
- AI コード IDE – Claude Code、VS Code (MCP 拡張機能付き)、Cursor、Windsurf、Continue、Cline、Zed、JetBrains AI Assistant。
- API テストツール – Postman、Bruno、Insomnia (
X-Royal-MCP-API-Keyヘッダーに API キーを使用)。 - カスタムフィールドプラグイン – Advanced Custom Fields (ACF) は、各フィールドの Return Format 設定に従ってフォーマットされた値を返す専用の
acf_*ツールを提供します(ACF の UI が表示する方法と同じ)。MetaBox、JetEngine、Pods、CPT UI、Custom Field Suite はwp_get_post_meta/wp_update_post_metaツールを通じてサポートされているため、AI エージェントは人間の編集者と同様にカスタムフィールドに入力できます。 - ページビルダー – Elementor には、クローンとカスタマイズのワークフロー (ページの複製、テキストの検索/置換、画像の入れ替え、アウトラインの取得、テンプレートのインポート) 専用のツールがあります – 詳細はツール一覧を参照してください。ウィジェット単位でのゼロからの作成は意図的にスコープ外です。Divi、Beaver Builder、Bricks、Gutenberg、Spectra、Stackable は、AI が読み書きできる標準的な投稿コンテンツを保存します。ページビルダー固有の JSON ストレージは、専用のツールでカバーされていない限り不透明です。
- 多言語対応 – WPML、Polylang、TranslatePress、qTranslate。翻訳された投稿は別個の投稿として表示され、標準の投稿ツールで読み書きできます。
- AI エージェントフレームワーク – LangChain、AutoGen、CrewAI、LlamaIndex、Haystack – MCP 互換の任意のフレームワークが Royal MCP のツールを呼び出せます。
- AI アプリプラットフォーム – Anthropic Console、OpenAI Playground、Google AI Studio、Vertex AI、Azure AI Studio、Amazon Bedrock Console。
MCP 仕様への準拠
Royal MCP は MCP 2025-11-25 Streamable HTTP トランスポート仕様 を実装しています:
- すべての JSON-RPC 通信用の単一の
/mcpエンドポイント - クライアントメッセージには POST、サーバー送信イベントには GET、セッション終了には DELETE を使用
- トランジエントベースのストレージによる暗号学的に安全なセッション ID
- DNS リバインディング攻撃を防ぐ Origin ヘッダー検証
- ブラウザベースの MCP クライアント向けの適切な CORS 処理
外部サービス
このプラグインはサードパーティの AI サービスに接続し、AI プラットフォームが WordPress コンテンツとやり取りできるようにします。プラットフォーム接続を明示的に設定して有効化するまで、データは一切送信されません。
**What …
スクリーンショット






インストール
royal-mcpフォルダを/wp-content/plugins/にアップロードする- WordPress の「プラグイン」メニューからプラグインを有効化する
- Royal MCP 設定に移動して設定する
- API キーをコピーする — MCP 接続の認証に必要です
- AI プラットフォームを追加し、API キーを入力する
- AI クライアント (Claude Desktop、VS Code など) で、MCP サーバー URL と API キーを設定する
- MCP 初めてですか ? ステップごとの接続ウォークスルー(動画あり)については royalplugins.com/support/royal-mcp/connecting-to-claude/ をご覧ください。
各プラットフォームの完全なセットアップガイドは royalplugins.com/support/royal-mcp/ で確認できます。
FAQ
-
MCP とは何ですか ? なぜ WordPress サイトに必要なのですか ?
-
Model Context Protocol (MCP) は、Anthropic が作成したオープンスタンダードで、AI アシスタントが外部のデータソースとやり取りできるようにします。MCP がなければ、Claude や ChatGPT のような AI ツールは、コピーして貼り付けたコンテンツしか扱えません。Royal MCP をインストールすると、これらの AI プラットフォームは、構造化された認証済みプロトコルを通じて、WordPress の投稿を直接読み取ったり、新しいコンテンツを作成したり、WooCommerce の商品を管理したり、セキュリティ状態を確認したり、バックアップを実行したりできるようになります。
-
Royal MCP は他の WordPress MCP プラグインとどう違うのですか ?
-
セキュリティについて。ほとんどの MCP プラグイン — そして公開されている MCP サーバー全体の 41% — には認証がまったくありません。Royal MCP はすべてのセッションに API キーを要求し、リクエストにレート制限をかけて悪用を防ぎ、監査目的ですべてのやり取りをログに記録し、レスポンスから機密データ (メールアドレス、PHP バージョン、管理者の認証情報) をフィルタリングします。このプラグインは、数千のサイトで使われている WordPress セキュリティプラグイン GuardPress に適用しているのと同じセキュリティ基準で構築されています。
-
Royal MCP は、WordPress コアが現在行っていることと重複しますか ?
-
いいえ。WordPress 6.9で、AI が呼び出せる関数を登録するためのプリミティブである Abilities API が追加され、
wordpress/mcp-adapterパッケージがアビリティを MCP プロトコルに橋渡しします。Royal MCP は、この素のプリミティブには含まれないセキュリティ層、コネクタフロー、プラグイン連携を備えた、完全な MCP サーバーです: 強制される API キー認証、Claude Desktop 用の OAuth 2.0、IP 単位のレート制限、監査ログ、機密データの編集、67個のすぐに使える WordPress コアツール、そして WooCommerce、GuardPress、Royal AI Firewall、SiteVault、ForgeCache、Royal Ledger、Royal Links、Elementor、Advanced Custom Fields、Redirection 用に自動読み込みされる 78個の連携ツールです。 -
Royal MCP は WooCommerce で動作しますか ?
-
はい。WooCommerce が有効な場合、Royal MCP は自動的に、商品管理 (単純商品と可変商品。バリエーションの CRUD とグローバル属性管理を含む)、完全なクーポン管理 (一覧表示/取得/作成/更新/削除 + ゴミ箱の一括消去)、注文管理 (表示、ステータス更新)、顧客データ、ストア統計にまたがる 26個の MCP ツールを追加します。追加の設定は不要です — ツールは MCP ツール一覧に自動的に表示されます。
-
AI アシスタントにプラグインの設定をしてもらうことはできますか ?
-
はい、安全対策付きで可能です。Royal MCP はプラグイン設定用に 2つのツールを公開しています:
-
wp_get_plugin_settingsを使うと、AI はスラッグで任意のプラグインの保存済み設定を読み取れます。機密性の高い値 (API キー、シークレット、トークン、パスワード、ライセンスキー、OAuth 認証情報) は、サーバーから出る前に自動的に[REDACTED]に置き換えられるため、AI アシスタントは保存された認証情報を一切見ることなくプラグインの設定を把握できます。 -
wp_update_optionを使うと、AI は WordPress オプションに書き込めますが、それには 3つのセキュリティゲートを通過する必要があります:- サイト管理者が、Royal MCP 設定ページで「AI による WordPress オプションの書き込みを許可する」トグルを有効にする必要があります (デフォルトでオフ)
- オプション名がランタイムの許可リストに含まれている必要があります。デフォルトの許可リストは意図的に最小限に絞られています —
blogname、blogdescription、posts_per_page、date_format、time_format。プラグイン作者はroyal_mcp_writable_optionsフィルターを通じて自身の設定をオプトインできます。 - ハードな拒否リストにより、許可リストやトグルの設定にかかわらず、機密性の高いオプション名 (siteurl、home、ライセンスキー、シークレット、ソルトなど) への書き込みが永久にブロックされます。
プラグイン作者は、1行で自身の設定をオプトインできます:
add_filter('royal_mcp_writable_options', fn($opts) => array_merge($opts, ['my_plugin_settings'])); -
-
Claude Desktop を WordPress に接続するにはどうすればよいですか ?
-
Royal MCP をインストールし、Royal MCP 設定に移動して、API キーと MCP サーバー URL をコピーします。Claude Desktop では、新しい MCP サーバー設定を URL とともに追加し、
X-Royal-MCP-API-Keyヘッダーに API キーを含めます。詳しいステップごとのガイドは royalplugins.com/support/royal-mcp/ にあります。接続に失敗する場合は、次の FAQ を参照してください。 -
コネクタが接続できません — どこから始めればいいですか ?
-
「接続できない」/「OAuth に失敗」/「ツールが見つからない」という問題の約 90% は、ホスト固有の対処が必要になる前に、基本的な 4ステップの確認で解決します。順番は次のとおりです: (1) Royal MCP を最新バージョンに更新する (最近のリリースはどれも意味のある OAuth のエッジケースを修正しています)、(2) 競合テストを実行する — 他のすべてのプラグインを無効化し、Twenty Twenty-Five のようなデフォルトテーマに切り替え、すべてのキャッシュ層 (キャッシュプラグイン、ホストのサーバーレベルキャッシュ、Cloudflare/CDN、ブラウザキャッシュ) をパージする、(3) 古い OAuth 状態を消去する — 1.4.17以降であれば Royal MCP 設定の「OAuth 状態のリセット」ボタンを使うか、サポート記事に記載されている 4つの
DELETESQL クエリを実行する、(4) Royal MCP アクティビティログで最新のoauth:行を確認する。これには、どの検証ルールが発動したかが正確に記録されています。コピペで使えるコマンド付きの完全なウォークスルーは royalplugins.com/support/royal-mcp/troubleshooting-start-here.html にあります。ホスト固有の対処 (Cloudflare の AI Bots トグル、SiteGround の/.well-known/静的ファイル、エッジキャッシュの除外設定) は、この 4つの基本対処を確認した後にのみ進めてください — 私たちが受け取る「高度なインフラ」関連のチケットの多くは、実際にはこの 4ステップで解決します。 -
WordPress データベースをバックアップから復元したら Claude が再接続できません。どう直せばいいですか ?
-
バックアップから復元すると、Claude が保持していた OAuth クライアント認証情報は WordPress 側の何とも一致しなくなるため、Claude のコネクタはどの Royal MCP インストールも受け付けない古いトークンを持った状態になります。Royal MCP 1.4.17以降での修正方法はワンクリックです: Royal MCP 設定 に移動し、OAuth 状態のリセット ボタンをクリックします。これにより、すべての古い OAuth クライアント、発行済みのアクセス/リフレッシュトークン、保留中の認可コードが消去されます。次に Claude 側で既存のコネクタを完全に削除し、30秒待ってから最初から再追加してください — クリーンアップされた状態に対して完全な OAuth フローが新たに実行され、接続が機能するようになります。1.4.16以前では、royalplugins.com/support/royal-mcp/troubleshooting-start-here.html に記載されている 4つの
DELETESQL クエリを実行することで同じ効果が得られます。プラグインの設定、API キー、アクティビティログは「OAuth 状態のリセット」の影響を受けません — 影響するのは OAuth ハンドシェイクの状態のみです。 -
Claude が「サインインサービスへの登録に失敗しました」または「セッションが見つかりません」と表示される場合はどうすればよいですか ?
-
両方のメッセージ(接続後 Claude.ai で「利用可能なツールがありません」というメッセージを含む)は、通常 Royal MCP の OAuth またはセッションデータベーステーブルが物理的に存在しないことを意味します。修正方法は Royal MCP を 1.4.29以降に更新することです。新しいランタイムヒーラーが欠落しているテーブルを検出し、非アクティブ化や再アクティブ化なしで次のページ読み込み時に自動的に再作成します。更新後、Claude の既存の Royal MCP コネクタを削除し、30秒待ってから新しく追加してください。すぐに更新できない場合に復旧が必要であれば、手動の回避策として
wp option delete royal_mcp_db_versionを実行してから任意の wp-admin ページを読み込んでください。完全な症状の診断(phpMyAdmin / WP-CLI)、自動復旧の説明、手動復旧の手順については royalplugins.com/support/royal-mcp/oauth-tables-missing.html をご覧ください。 -
インストールを監査していますが、`/wp-json/royal-mcp/v1/` の下に OAuth エンドポイントが見つかりません。どこにありますか ?
-
設計上、Royal MCP の OAuth エンドポイント (
/register、/token、/authorize) は、/wp-json/royal-mcp/v1/配下の REST API ルートとしてではなく、サイトルートのトップレベル WordPress リライトルール として登録されています。これは OAuth 2.0仕様 (RFC 6749) と MCP ディスカバリー仕様 (RFC 8414および RFC 9728) の要件であり、OAuth ディスカバリーに対応したクライアントがプラグインごとの設定なしに見つけられるよう、予測可能なサイトルートパスを義務付けています。REST ルートではなくリライトルールを監査している場合は、WP-CLI からwp rewrite list | grep royal_mcp_oauthで確認できます。/wp-json/royal-mcp/v1/名前空間には、/mcpにある JSON-RPC ツールエンドポイントと、それを補助する REST ルート (/posts、/pages、/siteなど) が含まれますが、OAuth ハンドシェイクのエンドポイント自体は含まれません。両方のルーティング層は正常な状態であり、コネクタがエンドツーエンドで機能するには両方に到達できる必要があります。 -
コンテンツは安全ですか ?
-
Royal MCP は多層防御の考え方で設計されています。すべての MCP セッションに API キー認証が必要です。レート制限により悪用を防ぎます (IP ごとに 1分あたり 60リクエスト)。アクティビティログがすべてのツール呼び出しを記録します。機密データはフィルタリングされます — ユーザーのメールアドレス、ユーザー名、管理者のメールアドレス、PHP バージョン、プラグイン設定内に保存された認証情報 (API キー、シークレット、トークン、パスワード) は、MCP を通じて公開されることはありません。コメント作成は WordPress のモデレーション設定を尊重します。投稿メタの値は保存前にサニタイズされます。オプションの書き込みはデフォルトで無効になっており、有効にした場合も 3つの独立したチェック (管理者トグル、許可リスト、ハードな拒否リスト) でゲートされます。プラグイン自体もデフォルトで無効の状態から始まります — 明示的に有効化するまで、何にもアクセスできません。
-
クラウドサービスの代わりにローカル AI モデルを使用できますか ?
-
はい。Royal MCP は、完全にローカルな AI 推論のために Ollama と LM Studio をサポートしています。ローカルモデルを使用する場合、データはサーバーの外に出ません — AI モデルは自分のハードウェア上で動作し、localhost 上の MCP プロトコルを通じて WordPress と通信します。
-
Royal MCP をアンインストールするとどうなりますか ?
-
Royal MCP はクリーンなアンインストールを実行します。すべてのプラグインオプション、データベーステーブル (アクティビティログ)、トランジエント、ユーザーメタが削除されます。残存データは一切残りません。
-
Royal MCP は Claude Code、VS Code、Cursor、Windsurf、その他の AI IDE で動作しますか ?
-
はい。MCP 準拠の任意のクライアントが Royal MCP に接続できます。IDE やクライアントで MCP サーバー URL (
https://yoursite.com/wp-json/royal-mcp/v1/mcp) と API キー (X-Royal-MCP-API-Keyヘッダーで送信) を設定してください。Claude Desktop はさらに、ネイティブの「コネクタを追加」OAuth 2.0フローもサポートしており、Royal MCP は Dynamic Client Registration (RFC 7591) 経由でこれを処理します — このパスでは手動の API キー管理は不要です。同じ OAuth フローは、MCP 2025-11-25仕様に準拠する任意のクライアントで機能します。 -
Royal MCP はカスタムフィールド、ACF、MetaBox、JetEngine、Pods、CPT UI で動作しますか ?
-
はい。Royal MCP は、WordPress の標準ツールである
wp_get_post_meta、wp_update_post_meta、wp_delete_post_metaを公開しており、Advanced Custom Fields (ACF)、MetaBox、JetEngine、Pods、CPT UI、Custom Field Suite を含む任意のカスタムフィールドを読み書きできます。AI エージェントは、WordPress 管理画面で作業する人間の編集者と同じように、ACF フィールドへの入力、リピーター行の設定、フレキシブルコンテンツブロックの更新、計算済みフィールドの読み取りを行えます。 -
Royal MCP は WordPress サイトを遅くしますか ?
-
いいえ。MCP エンドポイントは REST ルートであり、認証済みの AI クライアントがリクエストを行ったときにのみ実行されます — 訪問者向けページ、フロントエンドテンプレート、管理画面 (自身の設定ページを除く) では実行されません。アクティビティログは単一のインデックス付きデータベーステーブルを使用し、レスポンス送信後に非同期で書き込みます。レート制限 (IP ごとに 60リクエスト/分) により、偶発的な過負荷を防ぎます。
-
Royal MCP は WordPress マルチサイトネットワークで動作しますか ?
-
はい、サイト単位で対応しています。マルチサイトネットワーク内の各サイトは、それぞれ独自の API キー、独自のアクティビティログ、独自の設定を持ちます。AI クライアントは特定のサイトの MCP エンドポイントに接続します — Royal MCP はネットワーク内のサイト間でリクエストを橋渡ししません。
-
AI がアクセスできる投稿、固定ページ、投稿タイプを制限できますか ?
-
はい。
wp_get_postsとwp_create_postツールはpost_typeパラメーターを受け付け、登録済みの公開投稿タイプに対して検証を行うため、非公開または内部用の投稿タイプは公開されません。プラグイン作者は、royal_mcp_disabled_toolsフィルターで特定のツールを完全に無効化したり、royal_mcp_writable_optionsでオプション書き込みの許可リストの範囲を指定したりできます。WordPress の標準的な権限チェックも、すべてのツール呼び出しに適用されます。 -
Royal MCP は多言語コンテンツのために WPML、Polylang、TranslatePress で動作しますか ?
-
はい。翻訳された投稿は、それぞれ独自の ID と言語メタを持つ別個の WordPress 投稿として表示され、標準のwp_get_posts、wp_create_post、wp_update_postツールで読み書きできます。AI エージェントは、言語メタキーでフィルタリングして特定の言語の投稿を一覧表示したり、投稿を翻訳して対応する翻訳を ID で書き込んだりできます。 -
サイト上で AI が何をしているかをどう監視すればいいですか ?
-
認証済みの MCP リクエストはすべて、タイムスタンプ、クライアント IP、ツール名、パラメーター (機密値は編集済み)、レスポンスステータスとともに Royal MCP のアクティビティログに記録されます。ログは時間範囲、クライアント、ツール、ステータスコードでフィルタリングでき、CSV にエクスポートできます。ログページは AJAX で更新されるため、アクティブなセッションをリアルタイムで確認できます。
評価
貢献者と開発者
Royal MCP – Secure AI Connector for Claude, ChatGPT & Gemini はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。
貢献者変更履歴
1.4.40
- New: Every write tool re-reads modified fields after the write and returns the actual saved values.
- New: Undo tokens now cover wp_delete_post, wp_delete_term, and wp_delete_menu_item, restoring deleted objects within 72 hours via mcp_undo_last_operation.
- New: wp_update_post preserves the WooCommerce product_type when generic post updates would otherwise reset it to Simple.
- New: wc_get_order returns fee_lines, shipping_lines, and the raw payment method ID for full write-verification.
- New: wp_get_seo_meta and wp_update_seo_meta now support AIOSEO and SEObolt alongside Yoast and Rank Math.
- New: wp_get_widgets returns widget instance content and parsed block markup for before/after diffs.
- New: OAuth endpoint paths (authorize/token/register) are filterable via royal_mcp_oauth_rewrite_paths.
- New: Admin notice detects when a published page shadows an OAuth endpoint.
- Enhancement: wp_get_posts + wp_count_posts accept non-public post types when the caller has edit capability.
- Enhancement: Option writes require opt-in to the read allowlist first; admin_email + default_role + mailserver_* permanently denylisted.
- Enhancement: JSON-RPC envelope hardening re-forces “2.0” against edge-layer transformations.
- Enhancement: Royal MCP Pro promotion refreshed for post-launch with a green Upgrade to Pro link in the sidebar.
- Fix: elementor_replace_text is now multi-byte and case-insensitive.
- Fix: Uninstalling the free plugin no longer removes data used by Royal MCP Pro when Pro is installed on the same site.
- Fix: seo_audit_meta_tags now counts characters instead of bytes so titles and descriptions containing non-ASCII content are measured correctly.
1.4.39
- 新規: Royal MCP Pro がすでに有効な場合、無料版プラグインは有効化を拒否。
- 新規: OAuth セッション長の設定を追加。AI セッションが再認可を求められるまで接続を維持する時間をサイト所有者が選択可能。
- 新規: 「設定 OAuth」からすべての有効な AI セッションを失効可能に。
- 新規: 投稿コンテンツ内をリテラルで検索置換する wp_replace_in_post ツールと wp_replace_in_page ツールを追加。ドライラン、想定件数による安全確認、書き込み後の読み取り検証に対応。
- 新規: フィルターのコードを書かずに、サードパーティ製プラグインのオプションを
wp_update_optionの許可リストへ追加できるセクションを設定ページに追加。 - 新規: ウィジェット関連ツールを追加。ウィジェットインスタンスの一覧表示 (サイドバーによる絞り込みも可能)、サイドバーの一覧表示、ウィジェットコンテンツの更新に対応。書き込みはテーマ外観の管理トグルで制御。
- 新規: wp_reorder_menu_items が取り消しトークンを返すように変更。72時間以内であれば mcp_undo_last_operation がこのトークンを消費して直前の並び順を復元可能。
- 新規: mcp_undo_last_operation ツールを追加。取り消しトークンを消費して、そのトークンを生成した操作を元に戻す。
- 新規: seo_audit_meta_tags を追加。投稿の実際にレンダリングされた HTML を取得し、title、meta description、canonical、viewport、Open Graph、Twitter Card の各タグを報告。配信された出力にしか現れない競合を検出。
- 新規: WooCommerce の注文書き込みツール (wc_create_order、wc_update_order、wc_add_order_note) を追加。B2B、卸売、電話注文、サポートメモの履歴に対応。
- 修正:
elementor_replace_textが Blockquote ウィジェットのフィールド (著者名と引用本文) も走査するように修正。 - 改善: OAuth セッションのデフォルトを24時間に変更。
- 改善: 管理画面が BitNinja WebShield による OAuth ディスカバリーの妨害を自動検出し、ホスティング事業者へ問い合わせるための手順を表示。
- 改善: 「アクティビティログ」に /authorize、/token、/register の診断情報を追加。
- 改善: readme で、Royal MCP と併用して HTTP レイヤーの AI ボットを可視化する連携プラグインとして Royal AI Firewall を紹介。
1.4.38
- 機能: WP 6.9 以降ではすべてのツールが WordPress のアビリティとして登録され、ネイティブの MCP エンドポイントに加えて WP Abilities REST API と WordPress MCP Adapter からも利用可能に。
- 機能: Redirection プラグインとの統合により、リダイレクトの一覧表示、作成、更新とグループの一覧表示を行う4ツールを追加。
- 機能: Google Site Kit の GA4 設定を、機密キーを伏せた状態で AI エージェントから参照可能に。
- 機能:
royal_mcp_connection_healthツールが有効なページビルダーのバージョン (Divi、Elementor、WordPress コア) を返すようになり、エージェントは事前の探索呼び出しなしに複数ステップの操作を計画可能に。 - 機能: Claude Desktop へワンクリックでインストールできる
.mcpbバンドルを追加。 - 機能: 近日公開の Royal MCP Pro に向けた Founding Members ウェイトリストの通知を追加。
1.4.37
- 機能: Royal AI Firewall の新しい6ツールを追加。ダッシュボードの統計、直近のボットアクセス、ボットごとのポリシー、ポリシーの更新、日次集計、全 AI ボットの一括ブロックに対応。
- 機能: 「Royal Tools」管理画面を追加。無料の Royal Plugins ファミリーをすべて一覧表示し、ワンクリックのインストールリンクを提供。
- 機能: 診断ツール
royal_mcp_connection_healthを追加。認証済みの呼び出し元に対してルート、認証方式、セッション ID、バージョン情報を返す。 - 機能:
elementor_get_widget_settingsツールを追加。Elementor のウィジェット、コンテナ、セクション、カラムを ID 指定で、その設定全体を読み取る。 - 機能: Elementor 自身の MCP モジュールも有効な場合に、Elementor ツールの説明へルーティングのヒントを表示する共存検出を追加。
- 機能: すべての Royal MCP 管理画面に、「ドキュメントを表示」と「サポート」のボタンを備えた独自のトップヘッダーバーを表示。
- 改善: 軽量な管理画面フッターに Royal Plugins ファミリーのリンクと現在のプラグインバージョン表示を追加。
- 改善:
wp_update_postとwp_update_pageがmenu_order、post_parent、password、comment_status、ping_status、excerpt、post_authorの各フィールドを受け付け、実際に保存された値を返すように変更。WordPress による値の暗黙的な破棄が隠れずに表面化。 - 改善: 新しい
royal_mcp_tool_contextフックを追加。従来のroyal_mcp_tool_calledアクションと並行して発火し、後段のファイアウォール統合向けに情報を拡充したペイロードを渡す。 - 修正:
wp_get_seo_metaが Rank Math のサイトで noindex の状態を正しく報告するように、またwp_update_seo_metaのレスポンスがリクエストされた値ではなく実際に保存された値を反映するように修正。
1.4.36
- 機能:
wp_get_site_statusツールを追加。WordPress、PHP、MySQL、プラグイン、テーマ、環境の情報を1回の呼び出しで返す。 - 機能:
wp_get_error_log_tailツールを追加。デバッグログの末尾の行を返し、キーワードによる絞り込みも可能。 - 機能:
wp_get_cron_scheduleツールを追加。スケジュール済みのイベントをすべて一覧表示し、次回実行時刻と実行遅延フラグを返す。 - 修正: 投稿メタ、タームメタ、タームの説明、コメント、注文メモ、投稿と固定ページの抜粋、クーポンの説明で HTML が保持されるように修正。
- 機能:
royal_mcp_meta_value_sanitizerフィルターを追加。サイトごとにキー単位のサニタイズをカスタマイズ可能。 - 機能: Imunify360 が OAuth ディスカバリーのエンドポイントを横取りしていることを検出し、対処方法の記事へリンクする管理画面通知を追加。
- 機能: サイトが「基本」パーマリンクを使用していることを検出し、「設定 -> パーマリンク」へ直接リンクする管理画面通知を追加。
- 改善: 複数の読み取り系ツールの説明文を改良。
- 改善:
wp_get_termsとwc_get_ordersの一覧レスポンスにtotal_countフィールドを追加。
1.4.35
- 修正: OAuth で認証した MCP セッションがアクセストークンのローテーション後も有効なままになるように修正。
1.4.34
- 機能:
wp_update_post_metaが任意の JSON 型 (文字列、数値、真偽値、配列、オブジェクト) を受け付けるように変更。 - 機能:
wp_add_post_metaツールを追加。同じキーの既存の値を上書きせずにメタ行を追加する。 - 機能:
wp_get_termsツールを追加。登録済みの任意のタクソノミーのタームをページ送り付きで一覧表示する。 - セキュリティ: メタ書き込み系ツールが、PHP のシリアライズ済みペイロードとみられる文字列をスキーマの境界で拒否。
1.4.33
- 機能:
wp_create_post、wp_update_post、wp_create_page、wp_update_pageが予約投稿と日付のさかのぼり用にdateパラメーターを受け付けるように変更。 - 機能: 投稿作成と固定ページ作成のステータス列挙に
future、pending、privateを追加。 - 機能:
royal_mcp_tool_calledアクションフックを追加。MCP ツールの呼び出しごとに(tool_name, status, error_message)を伴って発火する。 - 機能: 「アクティビティログ」ページに、HTTP レイヤーの AI ボットを可視化する無料プラグイン Royal AI Firewall への案内を表示。
1.4.32
- 機能:
wp_searchが抜粋付きの結果を返すためのsnippetとper_pageを任意パラメーターとして受け付けるように変更。 - 機能:
wc_get_ordersがpageパラメーターを受け付け、{orders, page, per_page, total, total_pages}を返すように変更。 - ドキュメント: readme 全般のクリーンアップと更新。
1.4.31
- 堅牢化:
wp_delete_postの権限チェックを投稿の存在確認より先に実行するように変更。 - 堅牢化:
wp_get_post_metaが保護されたメタキー (アンダースコアで始まるもの) に対してedit_post権限を必須化。 - 堅牢化: 更新系ツールに空文字列のテキストフィールドを渡した場合、既存の値を空にせず保持するように変更。
- 改善: 投稿を指定するすべてのツールが
idとpost_idのどちらでも受け付けるように変更。 - UX: 設定ページに wp.org のレビュー依頼バナーを追加。プラグインのバージョンごとに非表示にできる。
1.4.30
- 機能:
elementor_add_widgetツールを追加。Elementor のページをウィジェット単位で構築でき、よく使うウィジェットタイプ11種類にはショートカットを、それ以外には生データのパススルーを用意。 - 堅牢化:
elementor_add_widgetが未知のウィジェットタイプのスラッグを境界で拒否。 - 堅牢化: 統合ツールのラッパー6件で権限チェックの順序を厳格化。
1.4.29
- 修正: 実行時の DB マイグレーションが、すべてのインストール環境でセッションテーブルと OAuth テーブルを確実に作成するように修正。
- 修正: OAuth テーブルが存在しない場合に
/registerが自動で復旧するように修正。 - 修正: 再インストール時に完全にまっさらな状態にするため、
uninstall.phpがroyal_mcp_db_versionオプションも削除するように修正。
1.4.28
- 機能: MCP クライアントが、従来の
X-Royal-MCP-API-Keyヘッダーに加えて標準のAuthorization: Bearerヘッダーでも API キーを送信可能に。 - 機能:
wp_get_seo_metaとwp_update_seo_metaが既存の SEO フィールドに加えて投稿の URL スラッグにも対応。
1.4.27
- 信頼性: MCP のセッション状態を専用の
wp_royal_mcp_sessionsテーブルへ移動。 - クリーンアップ: 未使用の管理画面 AJAX ハンドラーを削除。
- コンプライアンス: プラグイン説明の一部を書き換え。
1.4.26
- セキュリティ: コンテンツ、ユーザー、ターム、コメント、統合のすべてのツールにツール単位の WordPress 権限チェックを追加し、ステータスの絞り込みを許可リスト方式に変更。
1.4.25
- UX: すべてのクライアント共通の受信用 URL として、「MCP サーバー URL」を「一般設定」の先頭に表示。
- 機能: Claude.ai、ChatGPT、Claude Desktop、Cursor に対応した「MCP クライアントセットアップガイド」のアコーディオンをプラグイン内に追加。
- UX: 「送信側 AI プロバイダー設定」の名称を変更し、受信側の MCP 設定から分離。
- UX: 従来の「REST API ベース URL」と手動設定の「OAuth クライアント ID / シークレット」を「詳細設定」のサブセクションへ移動。
- 改善: 管理画面のアイコン配置を全体で統一、設定ページのボタンにキーボードフォーカスリングを追加、補助テキストのコントラストを改良。
1.4.24
- 機能: Advanced Custom Fields との統合として4ツール (
acf_get_field、acf_get_fields、acf_update_field、acf_get_field_groups) を追加。 - 修正:
wc_create_productがtype引数に従い、対応する WooCommerce の商品クラス (シンプル、バリエーションあり、グループ化、外部) を作成するように修正。 - ドキュメント: 「説明」と「インストール」のセクションから初回セットアップの解説へリンク。
1.4.23
- 修正: 「AI プラットフォーム」のモデル選択ドロップダウンを Claude、OpenAI、Gemini、Groq、Bedrock で最新化。
1.4.22
- 修正: 「AI プラットフォーム」の Claude の「接続テスト」が、ドロップダウンで選択したモデルを使用するように修正。
- 修正: 手動設定した OAuth のクライアント ID とシークレットを UI から消去できるように修正。
- 堅牢化: OAuth ルートのリライトルールが、末尾スラッシュの有無どちらにも一致するように変更。
- 機能: POST
/registerに対するホスト側の 301 リダイレクトを検出する管理画面通知を追加。 - 機能:
.well-known/のセルフチェックを追加。プラグインやテーマがディスカバリーのエンドポイントを HTML ページで横取りしている場合に検出する。
1.4.21
- 修正: Gutenberg のブロックコンテンツが投稿書き込み系ツールを通してもバイト単位で同一のまま往復するように修正。
1.4.20
- 修正: WooCommerce の注文ツールが返金レコードの処理でハングしないように修正。
1.4.19
- 機能: Elementor の複製とカスタマイズを行う6ツール (
elementor_clone_page、elementor_replace_text、elementor_replace_image、elementor_get_page_outline、elementor_list_local_templates、elementor_import_template) を追加。 - 機能: 古い静的な
.well-known/oauth-authorization-serverファイルを検出する管理画面通知を追加。 - ドキュメント: ページビルダーのセクションに Elementor の扱いを明記。
1.4.18
- 修正: MCP エンドポイントへの認証済み GET が、Anthropic のセッション探索に対応して User-Agent を判別するように修正。
- 修正:
wp_update_menu_itemとwp_reorder_menu_itemsが更新に含まれなかったフィールドを保持するように修正。 - ドキュメント: DB 復元後の復旧、OAuth エンドポイントの場所、トラブルシューティングの FAQ 項目を追加。
1.4.17
- 修正: 認可コードを専用の
wp_royal_mcp_oauth_auth_codesテーブルへ移し、1行単位でアトミックに消費するように修正。 - 機能: 管理画面に「OAuth の状態をリセット」ボタンを追加。登録済みクライアント、トークン、保留中の認可コードをワンクリックで消去する。
- 機能: MCP の
tools/callリクエストが、呼び出しごとに構造化された「アクティビティログ」エントリーを記録 (引数のキーは記録し、値は除外)。 - 修正: 「アクティビティログ」の「詳細を表示」モーダルがリクエスト / レスポンスの JSON を表示するように修正。
- 改善: プラグイン管理画面の CSS / JS でコンテンツハッシュによるキャッシュバスティングを使用。
1.4.16
- 機能: OAuth フローが
/token、/register、/authorizeの失敗ごとに構造化された「アクティビティログ」エントリーを記録 (認可コード、PKCE の verifier、シークレット、トークンは除外)。
1.4.15
- 修正: 「API キーを再生成」ボタンが確実に新しいキーを発行するように修正。
- 改善: 新しい API キーを32文字の小文字16進数文字列に変更し、見間違いによる転記ミスを解消。既存のキーはそのまま使用可能。
- 改善: MCP セッションで、アクセスのたびに延長される24時間の TTL を使用。
- 堅牢化:
/wp-json/royal-mcp/*のすべてのレスポンスでCache-Control: no-store, no-cache, must-revalidate, privateを送信。 - 堅牢化: 無効な API キーに対して、RFC 7235 に従い
WWW-Authenticate: Bearerを伴う HTTP 401 を返すように変更。
1.4.14
- 修正: MCP エンドポイントへの未認証の GET が、RFC 9728 に従い
WWW-Authenticate: Bearer resource_metadata="..."を伴う HTTP 401 を返すように修正。Web ベースの MCP クライアントが OAuth ディスカバリーを正しく開始できるように。 - 機能: ホストが
/.well-known/oauth-authorization-serverをブロックしていることをセルフチェックで検出し、手動での対処方法を記載した非表示可能な管理画面通知を表示。
1.4.13
- 堅牢化: OAuth エンドポイントのレスポンス (
/register、/token、/authorize) がデフォルトでCache-Control: no-storeを送信。 - 機能: WooCommerce のバリエーションと属性向けに10ツールを追加。CRUD、一括操作、属性タームの管理に対応。
- 機能: WooCommerce のクーポン管理向けに7ツールを追加。CRUD 一式に加えてゴミ箱への移動と完全削除に対応。
1.4.12
- 改善: 現在の Claude Desktop のビルドに合わせて MCP の
protocolVersionを2025-11-25に更新。 - 修正: MCP の GET ストリームが
Allow: POST, DELETE, OPTIONSを伴う HTTP 405 を返すように修正。 - 改善:
wp_get_taxonomiesがslugフィールドのエイリアスを返し、wp_get_term_metaが他のタームメタ系ツールと揃った構造化レスポンスを返すように変更。
1.4.11
- 機能:
wp_update_term、wp_get_term_meta、wp_update_term_meta、wp_delete_term_meta、wp_get_taxonomiesの各ツールを追加。 - 改善:
wp_create_term、wp_delete_term、wp_add_post_termsが登録済みの任意のタクソノミーを受け付けるように変更。 - 改善:
wp_create_termが任意指定のslugを、wp_create_postとwp_update_postがpost_authorのユーザー ID を受け付けるように変更。
1.4.10
- 機能: Royal Ledger 統合 (4ツール)、ForgeCache 統合 (3ツール)、Royal Links 統合 (3ツール) を追加。いずれも連携先プラグインが有効なときに自動で読み込まれる。
- 機能: SEO メタツール (
wp_get_seo_meta、wp_update_seo_meta) を追加。有効な SEO プラグインを自動検出し、タイトル、説明、フォーカスキーワード、robots、OG の各フィールドを読み書きする。 - 機能: パーマリンク構造ツールと投稿リビジョンツール (履歴の読み取りと復元) を追加。
1.4.9
- 機能: テーマ外観ツール (有効なテーマ、テーマ設定値、追加 CSS の読み書き) を追加。管理トグルと
royal_mcp_writable_theme_modsの許可リストフィルターで制御。 - 機能: メニュー項目の CRUD (作成、更新、削除、並べ替え) とコメントのモデレーション (承認待ちの一覧、承認、スパム、ゴミ箱) を追加。
1.4.8
- 修正: 初期ビルドから更新したサイトで、無効化と再有効化をしなくてもカスタムコネクターのセットアップが成功するように修正。
- 修正: DB への書き込みが失敗した場合に、動的クライアント登録 (
POST /register) が原因のエラーを含む本来の 500 を返すように修正。
1.4.7
- 機能:
wp_get_plugin_settingsツールを追加。プラグインのスラッグに一致する wp_options を、機密キーを伏せた状態で返す。 - 機能:
wp_update_optionツールを追加。管理トグル (デフォルトはオフ)、royal_mcp_writable_optionsフィルター、機密性の高いオプション名の強制拒否リストで制御。 - セキュリティ:
wp_get_optionが機密キーを伏せるように変更。外向き HTTP のタイムアウトを10秒に短縮。 - ドキュメント: プラグインディレクトリのバナーとタグを刷新。
1.4.6
- 機能:
wp_upload_media_from_url(SSRF 対策済み)、wp_upload_media(base64)、wp_set_featured_image、wp_update_mediaの各ツールを追加。 - 改善:
wp_create_postとwp_update_postがfeatured_mediaの添付ファイル ID を受け付けるように変更。 - 改善: 管理者しか取得できないキーの信頼レベルに合わせ、API キーで認証したリクエストを管理者権限で実行するように変更。
1.4.5
- 機能: プラグインの掲載ページから WordPress Playground のライブプレビューを利用可能に。
- 機能: プラグインの掲載ページに操作解説動画を埋め込み。
1.4.4
- 機能: カスタム投稿タイプに対応。
wp_get_postsとwp_create_postがpost_typeを受け付け、新しいwp_get_post_typesツールが登録済みの公開投稿タイプをすべて検出する。
1.4.3
- セキュリティ: MCP REST API エンドポイントにアクセス制御を追加。すべてのツール呼び出しに、認証済みの API キーまたは OAuth Bearer が必要。
1.4.2
- セキュリティ: すべての MCP リクエストで認証を必須化し、セッションを認証済みの資格情報に紐付け。
1.4.1
- 修正: WordPress 7.0 での有効化時に発生する致命的エラーを解消。
1.4.0
- 機能: OAuth 2.0 認可サーバーを追加。動的クライアント登録 (RFC 7591)、PKCE で保護された認可コードフロー、ローテーション付きのトークンリフレッシュ、WordPress ログインの同意画面、
/.well-known/oauth-authorization-serverでのディスカバリーに対応。 - セキュリティ: アクセストークンを SHA-256 ハッシュで保存、認可コードは10分で失効する使い捨てに変更、PKCE (S256) を必須化、リダイレクト URI を localhost または HTTPS に限定。
1.3.0
- 機能: WooCommerce 統合 (9ツール)、GuardPress 統合 (7ツール)、SiteVault 統合 (6ツール)。
- セキュリティ: MCP エンドポイントで API キー (
X-Royal-MCP-API-Keyヘッダー) を必須化。IP あたり毎分60リクエストのレート制限と、タイミング攻撃に強い比較を追加。
1.2.3
- セキュリティ: 外向き URL の SSRF 対策、テキストドメインの
royal-mcpへの変更、wp.org のガイドライン準拠のためのメニュースラッグ更新。
1.2.2
- 機能: 「プラグイン」ページにドキュメントへのリンクを、設定ページにドキュメントのバナーを追加。
1.2.1
- 修正: Claude Connector のセットアップガイドへのリンクが正しく表示されない問題を解消。
1.2.0
- セキュリティ: DNS リバインディング対策の Origin ヘッダー検証、セッション ID の形式検証、MCP 2025-03-26 の Streamable HTTP 仕様への準拠、
royal_mcp_allowed_originsフィルターを追加。
1.1.0
- 機能: マルチプラットフォームの AI 対応 (Claude、OpenAI、Gemini、Groq、Azure、Bedrock)、Claude Desktop の MCP コネクター、アクティビティのログ記録、接続テストを追加。
1.0.0
- 初回リリース。
