WordPressへのAI接続をトラブルシューティングする
WordPressでAIタスクが失敗する原因は、クライアント、コネクター、ネットワーク、認証、WordPressの権限、または指示にあります。すべての層を一度に変更すると問題の解決が難しくなり、有効な拒否を過剰なアクセス権で回避してしまいがちです。
このハブのトラブルシューティング手法では、成功することが既知の対照と、拒否されることが既知の対照を使用します。まずリクエストが失敗した場所を特定し、次に単一の層だけを変更して、同じ小規模なテストを繰り返します。
修正する前に分類する
クライアントがサーバーを読み込めない問題と、サーバーがWordPressに到達できない問題は異なります。401(認証エラー)と、403(認可拒否)も異なります。存在しないツールと、存在するものの指定されたレコードや操作を拒否するツールも区別する必要があります。
バージョンと範囲を記録する
互換性は単なる形容ではなく、組み合わせのマトリックスです。AIクライアント、コネクターまたはMCPサーバー、WordPressの各バージョンに加え、製品アーティファクト、IDモード、通信方式、正確なタスクを記録します。すべてのエラーから機密情報を除去し、認証情報は決して含めないでください。
拒否を対照として維持する
Read Onlyで書き込みが拒否された場合、管理者アクセスを割り当てて問題を「修正」してはいけません。タスクに本当に書き込みが必要かを確認します。必要な場合は、次に適したモードで別のワークフローを作成し、公開や管理が拒否されることを確認する回帰テストを繰り返します。
証拠を添えてエスカレーションする
有用なサポート報告には、再現手順、期待される動作、観測された動作、機密情報を除去した出力、正常に機能することが判明している最小のリクエストを含めます。秘密情報を含む設定画面のスクリーンショットや、「Claudeが接続できない」といった曖昧な説明に依存してはいけません。
AI接続またはアクセスのエラーを解決する
正確なメッセージ、HTTPステータス、見つからないツールから始めます。権限を広げず、通信、認証、ユーザー、権限を分けて診断します。
組み込みアシスタントとWAP通知
- WordPressで「WAP AI Assistant requires HTTPS」と表示される原因と修正方法
- HTTPSサイトでWAP AI AssistantのHTTPS警告が表示される理由
- WordPressのWAP AI Assistantとは
- WAP AI Assistantの通知を追加したWordPressプラグインの特定方法
- Rank MathにWAP AI Assistantの通知が表示される理由
アプリケーションパスワード
- WordPressでWAPのApplication Passwordを確認する方法
- WAP AI Assistantのアクセスを取り消す方法
- WAPのApplication Passwordが持つ権限
- WordPressのApplication Passwordが無効な場合の原因と確認
- WordPressユーザープロフィールにApplication Passwordが表示されない
- WordPressのApplication Passwordで401 Unauthorizedが返る
- Application Password認証後にWordPressが403を返す
- WordPressのAuthorizationヘッダーが欠落または削除される
- Application Passwordが別のWordPressユーザーに属している
- WordPressのApplication Passwordが再作成またはローテーションされる理由
REST、HTTPS、ネットワーク
- Cloudflareまたはリバースプロキシ経由でWordPressがHTTPSを検出しない
- WordPressの/wp-json/が404を返す場合のREST API診断
- セキュリティプラグインまたはWAFがWordPress REST APIをブロックする
- WordPress AI接続のリダイレクトループを診断する
- WordPressアドレスとサイトアドレスの不一致がAI接続を壊す
- WordPress AI接続で429 Too Many Requestsが返る
- WordPress AI接続で500、502、503が返る
MCPとツール実行
認証情報監査と運用モデル
- WordPressサイトのAI認証情報を監査する方法
- AIアシスタントが使用するWordPressユーザーを特定する方法
- WordPressプラグイン内のAIアシスタントを有効化する前のチェックリスト
- プラグイン内AIアシスタント、Claude Code、Codex、MCPの比較
役立つ結果を得るためのシンプルな進め方
接続後は、サイトの構造化情報を取得し、選択した公開ページを調べられます。この公開情報の読み取りに一時タスクは不要です。公開ページはプラグインなしでも閲覧できます。Agent Control は構造化されたアクセスと、その先の許可された WordPress 作業への流れを提供します。 下書きタスクを許可し、必要な参照コンテンツを選択します。アシスタントが作成・修正できるのは、そのタスクで新しく作った下書きです。既存の参照資料は、それ自体が下書きでも読み取り専用のままです。結果を WordPress で確認してください。 内容の変更を承認しても、公開の許可にはなりません。Solo、Pro、Agency で、有効な承認を対象とする公開タスクも必要です。公開された結果はご自身で確認してください。
次に進む
HTTPステータスが得られる場合は、WordPress AI の接続エラー:401 と 403 が役立つ理由から始めます。複数の層にまたがる障害にはClaude Code または Codex の WordPress アクセスをトラブルシューティングするを使用し、意図したアクセス境界を維持してください。