Respira For Wordpress について
Respira For Wordpress は、AI エージェントでサイトを管理するユーザー向けの WordPress MCP サーバーです。Respira プラグインと API キーが必要で、ページビルダーのネイティブ構造を編集でき、スナップショットやロールバックなどの保護機能を備えています。
主な機能
- 0119 種類のページビルダーに対応
- 02ページ要素の検索と編集
- 03宣言的な構造からページを作成
- 04HTML や Figma をネイティブ形式に変換
- 05書き込み前のスナップショットと復元
- 06ツール単位のアクセス管理
活用シーン
- 01Elementor や Divi のページ編集
- 02HTML や Figma からページを生成
- 03ページのアクセシビリティ監査と修正
- 04本番サイトの編集前にスナップショットを作成
MCP 対応
MCP クライアントに WordPress のページ、ビルダー、サイト管理ツールを提供します。Respira for WordPress プラグインと有効な API キーが必要で、ホスト型のリモート MCP サーバーも利用できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
200掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| detail | enum | いいえ | 応答の詳細レベル:"basic"(デフォルト)または "full"。basic | full |
| site_id | string | いいえ | 任意。この呼び出しに限り、グローバルな現在のサイトを変更せずにアクティブサイトを上書きします。複数の Cowork チャットで異なる WordPress サイトを並行して扱う場合、各チャットがツール呼び出しごとに対象サイトを固定するために使用します。 |
詳細
Respira WordPress MCP サーバー
19 種類のページビルダーに対応する MCP ツールと WordPress Abilities。WordPress の AI インフラストラクチャ層です。
要素単位の編集、ページ全体の作成、HTML や Figma からネイティブビルダーへの変換、デザインの方向性、サイトメモリ、アクセシビリティとセキュリティのスキャン、ツールごとのガバナンス、スナップショットとロールバックに対応します。
ウェブサイト • ドキュメント • プラグイン • MCP のセットアップ • スキル • サポート
このリポジトリの内容と、対象外のもの
このリポジトリは、Respira WordPress MCP サーバーの公開リスティングです。サーバーのソースは npm で @respira/wordpress-mcp-server として公開されています。このラッパーコードは MIT ライセンスで提供されており、自由に閲覧、フォーク、またはベンダーに組み込んでいただけます。
このサーバーはRespira WordPress プラグインのクライアントであり、単独で使える製品ではありません。実際に動作させるには、以下が必要です。
- サイトに Respira for WordPress プラグインをインストールすること
- ライセンスに紐付いた有効な Respira API キー
プラグインはオープンソースではありません。 商用ライセンスで提供されています。respira.press で無料トライアルをご利用いただけます。クレジットカードは不要です。有料プランは月額 9 EUR からです。
つまり、npx -y で実行するラッパーはオープンですが、その背後にある製品はオープンではありません。これは意図的なものです。商用依存のない、自己完結型の「AI が WordPress を編集する」スタックをお求めの場合、これは該当しません。このプラグインは一人の開発者が専任で開発・保守しており、ライセンス料金がその運営を支えています。
セキュリティに関する報告は SECURITY.md をご覧ください。
Respiraの特長
ほとんどのWordPress MCPサーバーはREST APIをラップしています。投稿や固定ページは作成できますが、実際のサイトのコンテンツが存在するページビルダーにはアクセスできません。
Respiraは、AIエージェントがページビルダー独自のデータ構造にネイティブアクセスできるWordPressプラグインと、公開中のサイトへの書き込みを安全に行うための保護機能を提供します。
| 機能 | Respira | REST APIラッパー |
|---|---|---|
| ページビルダーのサポート | 19種類 | なし |
| 要素単位の検索/更新/移動/削除 | はい | いいえ |
| 宣言型の構造からページ全体を構築 | はい | いいえ |
| HTMLまたはFigmaをネイティブなページビルダー出力に変換 | はい | いいえ |
| デザイン方針(サイト全体のアートディレクション) | はい | いいえ |
| エージェントのセッションをまたいで保持されるサイトメモリ | はい | いいえ |
| アクセシビリティのスキャンと自動修正 | はい | いいえ |
| セキュリティ監査とコアの強化 | はい | いいえ |
| 書き込みの前に毎回スナップショットを作成し、いつでもロールバック可能 | はい | いいえ |
| 編集前に複製する安全機能 | はい | いいえ |
| wp-adminからツールごとにガバナンスを設定 | はい | いいえ |
| WordPress Abilities APIとWebMCP | はい | まれ |
| WooCommerce(商品、注文、在庫、ストアフロント) | はい(アドオン) | いいえ |
クイックスタート
1. WordPressプラグインをインストールする
respira.press/pluginからダウンロードしてWordPressにアップロードし、有効化します。次に、Respira > API Keysに移動し、キーを生成します。
2. AIツールを接続する
最も簡単なのは、respira.press/dashboard/mcpで生成されたコマンドを使う方法です。サイトとキーが自動的に入力されます。手動で設定する場合は、以下を参照してください。
Claude Code
claude mcp add respira-wordpress -- npx -y @respira/wordpress-mcp-server
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json(macOS)または%APPDATA%\Claude\claude_desktop_config.json(Windows)に追加します。
{
"mcpServers": {
"respira-wordpress": {
"command": "npx",
"args": ["-y", "@respira/wordpress-mcp-server"]
}
}
}
Cursor
プロジェクト内に.cursor/mcp.jsonを作成します。
{
"mcpServers": {
"respira-wordpress": {
"command": "npx",
"args": ["-y", "@respira/wordpress-mcp-server"]
}
}
}
Codex, Windsurf, and other clients
上記と同じ形式です。Codexでは~/.codex/config.tomlのTOMLを使用します。
[mcp_servers.respira-wordpress]
command = "npx"
args = ["-y", "@respira/wordpress-mcp-server"]
または、add-mcpにツールを検出させます。
npx add-mcp "npx -y @respira/wordpress-mcp-server"
ChatGPT and remote clients
RespiraはOAuth対応のホスト型リモートMCPサーバーとしても動作するため、ローカルでNodeプロセスを実行する必要はありません。クライアントごとのセットアップ手順はrespira.press/mcpにあります。
3. サイトを追加する
ウィザードを実行します。
npx @respira/wordpress-mcp-server --setup
または、~/.respira/config.jsonを自分で作成します。
{
"sites": [
{
"id": "my-site",
"name": "My WordPress Site",
"url": "https://yoursite.com",
"apiKey": "respira_your-api-key",
"default": true
}
]
}
AIツールを再起動して、編集を始めましょう。
クライアントのツール数上限に達しましたか?
MCPクライアントによっては、有効にできるツール数が100個などに制限されています。Respiraが公開するツールはそれよりはるかに多いため、設定にenabledToolsを追加し、一覧に表示するツールだけを指定してください。
{
"sites": [{ "...": "..." }],
"preferences": {
"enabledTools": [
"respira_read_page",
"respira_update_page",
"respira_list_pages",
"respira_find_element",
"respira_update_element",
"respira_build_page",
"respira_get_site_context",
"respira_get_builder_info"
]
}
}
サイト管理ツール(respira_list_sites、respira_switch_site、respira_get_active_site)は常に含まれます。一覧にないツールも、直接呼び出せば利用できます。このフィルターは、公開するツールの表示のみを制御します。
さらに、サーバーはサイトで実際に稼働している機能に基づいてツール一覧をフィルタリングします。WooCommerceを使っていないDiviサイトには、コマース関連のツールは表示されません。検出に失敗した場合も利用できるように設計されており、判定できないときはすべてのツールが表示されます。
19 個の対応ページビルダー
level は Respira の書き込み深度を示すものであり、ビルダーの品質を示すものではありません。
| ビルダー | レベル | 備考 |
|---|---|---|
| Bricks | Deep | グローバルクラス、テーマスタイル、ACSS、コンポーネント、クエリループ、BEM の lint |
| Elementor | Full | ネイティブ API、ランタイム制御レジストリ |
| Divi | Full | Divi 4 と Divi 5、Divi 5 の 40 以上のモジュール定義 |
| Oxygen | Full | Classic と Oxygen 6 |
| Gutenberg | Full | ブロックレジストリ、FSE テンプレート、パターン、ナビゲーション |
| Flatsome | Full | ショートコードのラウンドトリップ編集、55 要素のインテリジェンス |
| Beaver Builder | Smart | ツリーユーティリティ、静的スキーマ |
| Breakdance | Smart | ツリーユーティリティ、静的スキーマ |
| Brizy | Smart | ツリーユーティリティ |
| WPBakery | Smart | ツリーユーティリティ |
| Spectra | Smart | ブロックターゲット |
| Kadence Blocks | Smart | ブロックターゲット |
| GenerateBlocks | Smart | ブロックターゲット |
| GreenShift | Smart | ブロックターゲット |
| Visual Composer | Smart | 書き込み機能は限定的 |
| Thrive Architect | Smart | テキスト編集 |
| SeedProd | Smart | 監査のみ |
| YOOtheme Pro | Full | レイアウトは YOOtheme 独自の形式で読み書きし、ビルダーを通じて保存 |
| Avada | Full | Avada Builder のショートコード、グローバルパレットとタイポグラフィ、Layouts と Library(プラグイン 9.2.6 以降) |
複数のビルダーを使用するサイトでは、サイト単位ではなくページ単位で処理します。
ツールの対象範囲
完全なリファレンスはドキュメントにあります。ツール群は以下のとおりです。
| ファミリー | 機能 |
|---|---|
| ページ、投稿、カスタム投稿 | ビルダー対応のペイロード、アウトライン、複製、翻訳を使って読み取りと書き込みを行います |
| 要素の操作 | ID、タイプ、クラス、コンテンツテキストで単一要素を検索、更新、移動、複製、並べ替え、削除します |
| ページ構築 | 宣言的な構造からrespira_build_pageでページを構築するほか、ウィジェットを1行で追加するショートカット(見出し、ボタン、画像、フォーム、スライダー、料金表など)を利用できます |
| 変換 | CSS の抽出、レスポンシブ対応のマッピング、忠実度スコアを備えた、HTML からネイティブビルダーへの変換。バンドルされたスキルを使って、Figma から Bricks、Divi、Elementor、Gutenberg に変換できます |
| デザインの方向性 | サイト全体のアートディレクションを保存、適用、有効化、エクスポートできます。確定前にプレビューし、同じ方向性を別のサイトに適用できます |
| デザイントークン | DTCG トークンを作成、更新、インポートし、デザインシステムをテーマに同期します |
| サイトメモリー | respira_remember、respira_forget、respira_list_memory。エージェントのセッション間で保持される、サイトに関する情報です |
| プレイブック | エージェントが作成、取得、実行できる、名前付きの再利用可能な手順です |
| スナップショット | 書き込みの前に毎回自動で作成し、2つのスナップショットを比較して、いずれかに復元できます |
| 分析 | SEO、AEO、可読性、RankMath、構造化データ、画像、Core Web Vitals、PageSpeed |
| SEO プラグイン | タイトル、説明、フォーカスキーワード、canonical、robots を Yoast SEO、Rank Math、SEOPress、All in One SEO 4 の各プラグイン専用フィールドに書き込み、読み戻します。Yoast のターム SEO と検索外観のツールも利用できます |
| 更新とバックアップ | 保留中の更新を一覧表示し、担当者が確認したバージョンのみをインストールします。プラグインの更新は、まず Duplicator、BackWPup、UpdraftPlus のいずれかで新しいバックアップを作成する必要があります。その後、4つのヘルスチェックを実施し、いずれかに失敗した場合は wordpress.org から以前のバージョンを戻して、処理結果を記録します |
| ビルダーの移行 | Elementor から Bricks、Divi から Bricks、WPBakery から Gutenberg など、16種類の無料移行スキル |
| アクセス制御 | アクセスプロファイル(Everything、Content、読み取り専用の Observe)、ツールごとの切り替え、下書きと SEO フィールドに制限された Publish only キーを利用できます。これらの設定はすべての接続で維持されます |
| アクセシビリティ | ページをスキャンし、スキャン結果を一覧表示して、修正を適用できます |
| セキュリティ | セキュリティ監査、検証、コアの強化、デバッグログの読み取り |
| テーマとテンプレート | FSE テンプレート、テンプレートパーツ、パターン、ナビゲーション、テーマビルダーのテンプレート、テーマファイルの読み取りと書き込み |
| サイト構造 | カスタム投稿タイプ、タクソノミー、ACF フィールドグループ、メニュー、メガメニュー、ターム |
| メディア | アップロード、URL からのサイドロード、メタデータの一括更新、自動でクレジット表記を付ける Openverse のストック画像検索 |
| 一括操作 | 1回の呼び出しで最大100ページを処理し、スナップショットを必須で作成します |
| マルチサイト | 1つの設定から複数のサイトを一覧表示、切り替え、操作できます |
| WooCommerce | カタログ、価格、在庫、注文、ストアフロントのデザインに対応するストアツールは、有料アドオンで利用できます |
すべてのツール名にはrespira_*を使用します。従来のwordpress_*エイリアスは非推奨で、今後削除されます。
数値の意味
現在の件数はライブツールカタログに掲載されているもので、リリースごとにコードから集計されます。製品全体および各プランのMCPツール、WooCommerceアドオンのツール、WordPress Abilitiesが含まれます。これらはすべての機能が有効になったサイトのカタログを示すものであり、クライアントに表示される件数ではありません。
ライブのtools/listが返す件数はカタログの総数より少なくなりますが、これは機能の欠落ではなく、正しい動作です。サーバーはサイトごとにコンテキストに応じてカタログをフィルタリングするため、BricksのツールがElementorサイトに表示されることはなく、WooCommerceがない場合はコマースツールも非表示になります。ページビルダーを使用していないブロックテーマのサイトでは、コアツールはさらに少なくなります。
Abilitiesレジストリはコンテキストに応じたフィルタリングを行わないため、同じサイトでAbilitiesの件数がツールの件数を正当に上回ることがあります。この2つは直接比較できません。
同梱スキル
このパッケージには、ツールを組み合わせて活用するためのレシピであるRespiraのClaude Codeスキルが含まれています。ページビルダーの移行(DiviからBricks、ElementorからGutenberg、WPBakeryからBricksなど)、Figmaからビルダーへの変換、サイト監査、SEOとAEOのチェック、WooCommerceのワークフローなどがあります。
npx @respira/wordpress-mcp-server install-skills
respira.press/skillsでカタログをご覧ください。
安全性
本番稼働中のサイトへの書き込みこそが、最大の課題です。そのための安全策は次のとおりです。
- 変更の前に毎回スナップショットを作成します。
respira_restore_snapshotで復元し、respira_diff_snapshotsで比較できます。 - 編集前に複製します。 エージェントがコピーを編集する間、元のサイトは変更されません。
- ツールごとのガバナンス。 管理者はwp-adminから個々のツールを有効または無効にできます。ガバナンスはREST経由、Abilities API経由、WebMCPのいずれにも適用されます。
- 読み取り専用モード。 エージェントをサイトに接続し、書き込みを許可せずに閲覧させることができます。
- アクティビティログ。 すべての呼び出しが記録され、wp-adminと
respira_list_activityから確認できます。
WordPress AIエコシステム
Respiraは、公式のWordPress AIスタックを迂回せず、それと連携して動作します。
| 経路 | 仕組み | 要件 |
|---|---|---|
| スタンドアロンMCP(このパッケージ) | npx @respira/wordpress-mcp-server | Node 20+、Respiraプラグイン |
| リモートMCP | OAuth対応のホスト型エンドポイント。ローカルプロセスは不要 | Respiraプラグイン、アカウント |
| WordPress Abilities API | RespiraのすべてのツールをAbilityとして登録し、自動検出 | WP 6.9+、Respiraプラグイン |
| MCP Adapter | WP-CLI STDIO経由でAbilitiesを公開 | WP 6.9+、MCP Adapterプラグイン |
| WebMCP | Chrome Abilities APIを介したブラウザネイティブのMCP | Chrome 146+、Respiraプラグイン |
Inhaleは、Respiraアカウントなしで少数のAbilitiesを登録する無料のコンパニオンプラグインです。まずはAbilities経由の方法を試したい場合にご利用ください。
インストール方法
npx
npx -y @respira/wordpress-mcp-server
インストール不要で、試すのに適しています。一方で、インストールの中断、外付けドライブの切断、ウイルス対策ソフトによる隔離などにより、npxのキャッシュが破損し、原因が分かりにくいENOENTエラーが発生することがあります。トラブルシューティングをご覧ください。
グローバルインストール(最も安定)
npm install -g @respira/wordpress-mcp-server
respira-wordpress-mcp
npxのキャッシュを完全に回避できます。日常的な使用に適した方法です。
CLIオプション
| フラグ | エイリアス | 説明 |
|---|---|---|
--setup | -s | 対話形式のセットアップウィザード |
--list | -l | 設定済みサイトの一覧を表示 |
--test | -t | 接続をテスト |
--doctor | -d | ヘルス診断。機械可読形式の出力には--jsonを追加 |
--install-config | 検出されたクライアント用のMCP設定を書き込み | |
install-skills | 同梱スキルをローカルのスキルディレクトリにコピー | |
--stdio | MCP Adapter用のSTDIOトランスポート | |
--version | -v | バージョンを表示 |
--help | -h | ヘルプ |
環境変数
export WORDPRESS_URL="https://yoursite.com"
export WORDPRESS_API_KEY="respira_your_key"
複数サイトを設定する場合は、RESPIRA_CONFIG_FILEとRESPIRA_CONFIG_B64を使用できます。
Grok Build プラグイン
このリポジトリは、Grok Build 用の Respira プラグインのソースでもあります。このプラグインは、意図的に小規模にしています。含まれるファイルは次の 2 つだけです。
.grok-plugin/plugin.json:マニフェスト。.mcp.json:MCP サーバーの定義。npx -y @respira/wordpress-mcp-serverを実行します。この README で説明しているものと同じパッケージです。
スキル、コマンド、エージェント、フック、インストールスクリプトはありません。
初回使用前に。 サイトに Respira for WordPress プラグインをインストールし、npx @respira/wordpress-mcp-server --setup を一度実行してください。これによりサイトリストが ~/.respira/config.json に書き込まれます。サーバーは Grok Build の起動時にこのファイルを読み込みます。このファイルにサイトが登録されていない場合、サーバーは 1 つのツール respira_redeem_token だけを起動します。このツールは respira.press/dashboard/mcp のセットアップコードを受け取り、サイトリストを書き込みます。
サーバーが呼び出すネットワークエンドポイント。
| エンドポイント | 用途 |
|---|---|
/wp-json/respira/v1/ にある、お客様自身の WordPress サイト | すべてのツール呼び出しは、設定ファイルに登録されたサイト上の Respira プラグインへのリクエストです。サイトコンテンツを読み書きするものはほかにありません。 |
https://www.respira.press | セットアップコードとサイトリストの交換、サイトリストの更新、ツール呼び出しごとの使用記録 1 件(ツール名、サイト、バージョン、所要時間。ページコンテンツや会話は含みません)。RESPIRA_USAGE_OPT_OUT=1 を設定すると、使用記録を無効にできます。不具合レポートは、依頼した場合にのみ送信されます。 |
https://registry.npmjs.org | パッケージの新しいバージョンがあるかどうかを確認します。RESPIRA_MCP_DISABLE_UPDATE_CHECK=1 を設定すると、確認を無効にできます。 |
認証情報。 サイトごとに Respira サイトキーが 1 つあり、お使いのマシンの ~/.respira/config.json に保存されます(単一サイトの場合は WORDPRESS_URL と WORDPRESS_API_KEY を使用します)。キーはリクエストヘッダーに含めて、対応するサイトにのみ送信されます。WordPress プラグインがキーを検証します。サーバーが SSH キー、.env ファイル、その他のトークンを読み取ることはありません。
プラグインを使わない場合。 Grok Build からサイトに直接アクセスすることもできます。その場合はサイトごとにコマンドを 1 つ実行します。respira.press/integrations/grok をご覧ください。
ヘルスチェック
npx @respira/wordpress-mcp-server --doctor
Node のバージョン、設定ファイル、サイトへの接続、プラグインのバージョン、API の互換性、利用可能なアップデートを確認し、各チェックの合否と、対処に役立つ情報を報告します。CI パイプラインでは --json を追加してください。
トラブルシューティング
Windows:「npx」が認識されない
フルパスを使用してください。
{ "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": ["-y", "@respira/wordpress-mcp-server"] }
または、npm install -g @respira/wordpress-mcp-server でグローバルにインストールし、{ "command": "respira-wordpress-mcp" } を使用してください。
接続に失敗する
- WordPress > Respira > API Keys で API キーを確認してください
- URL に
https://が含まれている必要があります - プラグインが有効化されている必要があります
- ホストが REST API をブロックしていないか確認してください
respira_diagnose_connection を実行すると、4 項目すべてを一度に確認できます。
JSON ではなく HTML が返される、または呼び出すたびにホームページへリダイレクトされる
一部のサイトでは、プラグインやテーマのリライトルールによって /wp-json/[anything] が捕捉され、?rest_route= クエリ変数を付けずにパスが index.php に書き換えられます。その後、WordPress はホームページに 301 リダイレクトします(リダイレクトの連鎖で x-redirect-by: WordPress が確認できます)。その結果、MCP サーバーは JSON の代わりに HTML を受け取ります。
サーバーはこれを自動検出し、サイトのルートに対して ?rest_route=... を使って呼び出しを再試行します。JSON が返された場合は、以降の呼び出しをすべて、セッション終了まで同じ方法でルーティングします。初回の有効化時に、stderr に警告が 1 回表示されます。
リライトによるシャドーイングが発生していると分かっている場合は、forceRestRoute を使って検査を省略できます。
{
"sites": [
{
"id": "my-site",
"url": "https://yoursite.com",
"apiKey": "respira_your-api-key",
"default": true,
"forceRestRoute": true
}
]
}
respira_diagnose_connection は両方の形式を検査し、rest_route_fallback_worked、rest_route_fallback_active、force_rest_route_configured を報告します。
ツールが表示されない
- ウィンドウだけでなく、AI ツールを完全に再起動してください
- 設定ファイルの JSON 構文を検証してください
- クライアントの設定ファイルの場所を確認してください
npx @respira/wordpress-mcp-server --testを実行してください
クライアントが有効なツールの数を制限している場合は、上記の enabledTools を参照してください。
/_npx/ または node_modules に関する ENOENT エラー
npx キャッシュが破損しています。よくある原因は、インストールの中断、インストール中の外付けドライブの切断、ウイルス対策ソフトによる隔離、または npx の実行中に npm cache clean を実行したことです。
# 1. Switch to a global install, most stable
npm install -g @respira/wordpress-mcp-server
# then use "command": "respira-wordpress-mcp" with no npx wrapper
# 2. Or clear the npx cache and let it rebuild
npx clear-npx-cache
npx -y @respira/wordpress-mcp-server
# 3. Or clear the whole npm cache
npm cache clean --force
セキュリティ
API キーの検証は WordPress プラグイン側で行われます。MCP サーバーは認証情報を受け渡すだけで、保存も検証もしません。
脆弱性は [email protected] まで報告してください。ポリシーの全文は SECURITY.md をご覧ください。
リンク
Respira の掲載先
| ディレクトリ | 掲載先 |
|---|---|
| npm | @respira/wordpress-mcp-server |
| Official MCP Registry | io.github.webmyc/respira-wordpress |
| Smithery | smithery.ai |
| Glama | glama.ai/mcp/servers |
| mcp.so | mcp.so |
| cursor.directory | cursor.directory |
ライセンス
MIT © Respira
コードから数えた全ツールカタログはこちら:respira.press/tools。WordPress 向けの AI インフラストラクチャ層です。
respira.press
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。