respira-setup-assistant

Respira セットアップアシスタント

バージョン： 1.2.0 更新日： 2026-05-24 カテゴリー： オンボーディング ステータス： アクティブ 最新の更新： v1.2.0 では、v7.1 Roots の React ファーストな管理画面の再設計が反映されています。セットアップの手順では、新しい /wp-admin/admin.php?page=respira-v71-preview 管理画面シェル、11 個の新しい REST エンドポイント、command-K パレットについて説明しています。診断機能は、新しい 4 つのビルダー（Spectra、Kadence Blocks、GenerateBlocks、SeedProd）と、拡張された Divi 5 の 108 モジュールカタログに対応しています。 必要条件： Respira for WordPress プラグイン（存在しない場合は、このスキルでインストールします） テレメトリエンドポイント： https://www.respira.press/api/skills/track-usage

---

説明

Respira MCP の接続を診断し、初回セットアップを案内して、よくある接続の問題を解決します。

Respira セットアップアシスタントは、プラグインがインストールされているか、API キーが存在するか、MCP サーバーのバージョンがプラグインと互換性があるかを確認します。明確なステータスレポートを提示し、不足している手順を案内して、よくあるエラー（タイムアウト、401、403、バージョンの不一致）を平易な説明で解決します。

Respira に初めて接続するとき、WordPress の更新後、または Respira のツールが動作しなくなったときに、このスキルを使用してください。

---

トリガーフレーズ

次のいずれかをユーザーが発言したときに、このスキルが起動します。

• "set up respira"
• "connect respira"
• "respira setup"
• "respira not working"
• "respira connection failed"
• "fix respira"
• "respira setup assistant"
• "check my respira connection"
• "respira health check"
• "diagnose respira"
• "respira mcp setup"
• "is respira connected"
• "respira not connecting"
• "help me set up respira"
• "respira install"

次の場合は起動しないでください： 一般的な WordPress のタスク、Respira がすでに動作していることを前提としたリクエスト、または「内部リンクを構築する」のようにスキル側で Respira の確認を行うスキル固有のリクエスト。

---

実行ワークフロー

ステップ 1：診断チェックを実行する

まず respira_diagnose_connection を呼び出します（Respira プラグイン v7.0.16 以降／MCP サーバー v6.11.13 以降）。これは、MCP サーバーがプラグインに到達できるか、エッジレイヤー（Cloudflare、WAF）が REST 名前空間をブロックしているかを確認する最も手早い方法です。

Tool: respira_diagnose_connection
Returns: connection status, version pair, edge-layer block detection (Cloudflare "Bad Bot" pattern, WAF filters), CF allow-list snippet when blocks are detected

診断ツールを使用できない場合（古いプラグインまたは MCP の場合）は、代わりに respira_get_server_compatibility を使用します。

Tool: respira_get_server_compatibility
Returns: plugin version, MCP server version, compatibility status, minimum requirements

結果を解釈する：

結果	意味
データを正常に取得	MCP サーバーが接続され、プラグインに到達できます
接続拒否／タイムアウト	プラグインに到達できません — URL またはファイアウォールの問題です
401 Unauthorized	API キーがないか、正しくありません
403 Forbidden	REST API がセキュリティプラグインまたはホストによってブロックされています
バージョン不一致の警告	いずれかの側を更新する必要があります

呼び出しに成功した場合は、ステップ 2 に進み、完全なステータスレポートを作成します。

失敗した場合は、このエラーに該当するトラブルシューティングセクションに進みます。

---

ステップ 2：サイトの全体像を確認する

Tool: respira_get_site_context
Returns: WordPress version, PHP version, site URL, active plugins, active theme

この応答から、次の項目を確認します。

1. プラグインがインストールされ、有効になっている — 有効なプラグインの一覧に respira-for-wordpress があるか確認します
2. API キーが設定されている — コンテキスト応答には、API キーが存在するかを示すフラグが含まれます
3. WordPress のバージョン — 6.0 未満（サポート対象の最低バージョン）の場合は警告します
4. PHP のバージョン — 7.4 未満（サポート対象の最低バージョン）の場合は警告します

---

ステップ 3：ステータスレポートを作成する

明確で一覧しやすいステータスレポートを提示します。次の形式を使用してください。

## Respira Connection Status

### Plugin
- Installed: Yes / No
- Active: Yes / No
- Version: X.X.X (up to date / update available)

### API Key
- Configured: Yes / No

### MCP Server
- Version: X.X.X
- Compatible with plugin: Yes / No

### WordPress
- Version: X.X.X (supported / below minimum)
- PHP Version: X.X (supported / below minimum)

### Overall Status
[CONNECTED — ready to use]
  or
[ACTION NEEDED — see steps below]

続いて、ステータスに応じて分岐します。

---

分岐 A：すべて正常

次を出力します。

Your Respira connection is healthy.

Quick-start commands to try right now:
- respira_list_pages — see all your pages
- respira_get_builder_info — find out which page builder you're using
- respira_get_site_context — full site overview

Skills available in the marketplace:
- "WordPress Site DNA" — full site audit
- "SEO & AEO Amplifier" — SEO health check
- "Internal Link Builder" — build internal links

---

分岐 B：プラグインがインストールされていない、または有効になっていない

次を出力します。

## Respira Plugin Not Found

To connect your AI assistant to WordPress, install the Respira for WordPress plugin.

### Install steps (v7.1 OAuth, recommended):
1. Go to https://respira.press/releases
2. Download the latest version
3. In WordPress admin: Plugins, then Add New, then Upload Plugin
4. Activate the plugin
5. On the Setup screen, click "Connect respira.press account". The OAuth handshake links the licence to the user's respira.press account so plan changes sync automatically and host migrations don't require re-activation.

### Install steps (manual licence-key fallback):
1. Steps 1-4 above
2. On the Setup screen, click "Or paste a licence key manually"
3. Paste the key from respira.press/dashboard/licenses
4. Go to Respira, then Settings, then API Keys, and create a new MCP key

### MCP server setup:
Run this in your terminal:
npx -y @respira/wordpress-mcp-server --setup

Follow the prompts. You'll need your WordPress site URL and the API key from the dashboard installer.

Optional after setup: install the bundled skill collection:
npx @respira/wordpress-mcp-server install-skills

Once done, come back and say: "check my respira connection"

---

分岐 C：プラグインはインストールされているが、API キーがない

次を出力します。

## API Key Missing

The Respira plugin is installed but no API key is configured. The MCP server needs a key to authenticate.

### Create an API key:
1. In WordPress admin, go to Respira, then Settings, then API Keys
2. Click "Add New Key"
3. Give it a name (e.g., "Claude Desktop")
4. Copy the generated key
5. Add it to your MCP server config by running:
   npx -y @respira/wordpress-mcp-server --setup
   and paste the key when prompted

Once done, say: "check my respira connection"

---

分岐 D：バージョンの不一致

互換性チェックで確認した特定のバージョンを使って出力します。

## Version Mismatch Detected

Plugin version: X.X.X
MCP server version: X.X.X
Required: [minimum version from compatibility response]

### To fix:

注：v6.11.13 より前のバージョンでは、古い定数に関するバグにより、アップグレード後に MCP サーバーが自身のバージョンを v6.11.4 と報告していました。最近 npm install -g @respira/wordpress-mcp-server@latest を実行した後に respira_get_server_compatibility が 6.11.4 を返す場合は、同じコマンドをもう一度実行して、エージェントを再起動してください。v6.11.13 以降の修正では、モジュールの読み込み時に package.json からバージョンを取得します。

次に、どちらの側が古いかに応じて、具体的な更新手順を示します。

プラグインを更新する必要がある場合：

Update the Respira plugin:
1. Go to Respira → Settings → Updates (or check wp-admin → Updates)
2. Or download the latest version at https://respira.press/releases
3. Install and activate

MCP サーバーを更新する必要がある場合：

Update the MCP server:
npx -y @respira/wordpress-mcp-server@latest --update

Or in Claude Desktop settings, update the command to use the latest version.

---

よくあるエラーのトラブルシューティング

ステップ 1（診断チェック）でエラーが返された場合は、以下のガイドを使用してください。エラーの内容が明確でない場合は、どのようなエラーが表示されているかユーザーに確認してください。

---

接続タイムアウト

症状： ツールが応答しない、または「connection timed out」、「ECONNREFUSED」、「fetch failed」が返される

チェックリスト — 次の順に確認してください：

1. サイト URL を確認する — MCP サーバーの設定で、URL が WordPress サイトと完全に一致していますか？正しいプロトコル（https:// または http://）を含め、末尾のスラッシュに問題がないことを確認してください。

2. サイトがオンラインか確認する — ブラウザーで WordPress サイトにアクセスしてください。サイトがダウンしている場合、Respira も接続できません。

3. ファイアウォール／サーバーによるブロックを確認する — ホスティングプロバイダーやファイアウォールによっては、REST API へのブラウザー以外からのリクエストがブロックされます。ホストに IP アドレスからのリクエストを許可するよう依頼するか、ファイアウォールプラグイン（Wordfence など）が API トラフィックをブロックしていないか確認してください。

4. REST API へのアクセスを確認する — ブラウザーで https://yoursite.com/wp-json/ にアクセスしてください。JSON レスポンスが表示されれば、REST API にアクセスできます。404 が返される場合、REST API が無効になっている可能性があります。

5. HTTP Basic Auth を使用するステージングサイト — ステージングサイトがパスワードで保護されている場合（何も表示される前に、ブラウザーでユーザー名とパスワードを求められる場合）、MCP の設定にその認証情報を含める必要があります。以下の分岐 F を参照してください。

---

401 Unauthorized

症状： ツールから「401」、「Unauthorized」、または「Invalid API key」が返される

チェックリスト：

1. API キーが存在する — WordPress 管理画面 → Respira → API Keys に移動します。キーが存在し、有効期限が切れていないことを確認してください。

2. API キーが正しい — API キーは作成時に一度だけ表示されます。紛失した場合は、削除して新しいキーを作成してください。余分なスペースが入らないよう、注意してコピーしてください。

3. キーが正しい設定フィールドにある — MCP サーバーのセットアップでは、キーは RESPIRA_API_KEY フィールドに入力します。WordPress のユーザー名／パスワード欄ではありません。

4. HTTP Basic Auth を使用するステージングサイト — ステージングの認証情報の追加方法については、分岐 F を参照してください。

---

403 Forbidden

症状： ツールから「403」、「Forbidden」、または「REST API disabled」が返される

チェックリスト：

1. REST API が無効になっていない — セキュリティプラグインやホスティング環境の設定によって、WordPress REST API が無効になっている場合があります。セキュリティプラグイン（Wordfence、iThemes Security、All-In-One WP Security）で「Disable REST API」設定を確認して無効にするか、Respira のエンドポイントを許可リストに追加してください。

2. Respira のエンドポイントが許可リストにある — Respira が使用する REST API エンドポイントは /wp-json/respira/v1/ です。REST API へのアクセスをフィルタリングするセキュリティプラグインでは、このパスを許可リストに追加してください。

3. ユーザーロールの制限 — 環境によっては、ログインユーザーに限って REST API へのアクセスを許可しています。Respira の API キー認証はこの制限を回避しますが、キーが有効な場合に限ります（上記の 401 の手順を参照してください）。

4. Cloudflare または WAF によるブロック — サイトで Cloudflare または Web アプリケーションファイアウォールを使用している場合、Respira のリクエストがボットのトラフィックとしてブロックされている可能性があります。v7.0.16 では、Cloudflare の「Bad Bot - Action Block」パターンの検出が追加されました。respira_diagnose_connection は OPTIONS /wp-json/respira/v1/ping を実行し、GET が成功している一方でエッジ側でそのメソッドがブロックされている場合に報告します。診断レスポンスには、Respira の REST 名前空間で PUT、PATCH、DELETE、OPTIONS を許可する、Cloudflare 固有の許可リスト用スニペットが含まれます。

---

分岐 F：HTTP Basic Auth を使用するステージングサイト

ブラウザーレベルのパスワード保護が必要なステージングサイトにアクセスする場合：

## Staging Site Setup

Your staging environment has HTTP Basic Authentication (the browser prompts for a username and password before showing the site). Respira needs these credentials in addition to the API key.

In your MCP server configuration, add these fields:
- RESPIRA_BASIC_AUTH_USER: your staging username
- RESPIRA_BASIC_AUTH_PASS: your staging password

These are separate from your WordPress login and your Respira API key.

Re-run the setup:
npx -y @respira/wordpress-mcp-server --setup

And select the option to configure Basic Auth credentials.

---

クイックスタートの例

接続したら、ユーザーがすぐに使い始められるよう、次の例を共有してください。

## You're connected. Here's what to try:

### Explore your site
- "list my pages" → respira_list_pages
- "what page builder am I using?" → respira_get_builder_info
- "show me my site overview" → respira_get_site_context

### Make changes (safe — always uses drafts)
- "create a draft of my homepage to experiment with"
- "find the text 'Contact Us' on my site"
- "update the title of my About page"

### Run a full audit
- "analyze my site" → runs WordPress Site DNA skill
- "check my SEO" → runs SEO & AEO Amplifier skill

---

安全に関する注意事項

• このスキルは診断中は読み取り専用で、サイトを変更することはありません
• ユーザーが後の手順で明示的に承認しない限り、変更は行われません
• API キーがこのスキルによってログに記録されたり、保存されたりすることはありません

---

ツール

使用するコアツール

• respira_diagnose_connection（v7.0.16+ / MCP v6.11.13+ での使用を推奨）
• respira_get_server_compatibility
• respira_get_site_context

テレメトリー

実行完了後、次の宛先に利用状況の追跡データを非同期で送信します。

• POST https://www.respira.press/api/skills/track-usage

次の情報を含めます。

• skill_slug = respira-setup-assistant
• サイト／バージョンのコンテキスト（取得可能な場合。プラグインが接続されていないと取得できないことがあります）
• 所要時間と結果（connected / action_needed / error）
• 実行した分岐（A / B / C / D / F / troubleshooting）

テレメトリーの送信に失敗しても、ユーザーの操作を妨げないでください。

関連スキル

• WordPress Site DNA（セットアップ後に実行してサイトを把握）
• Site Onboarding（接続後、初回実行時のガイド）
• Technical Debt Audit

---

Respira が WordPress 向けに開発 https://respira.press/skills/respira-setup-assistant