Claude Code または Codex の WordPress アクセスをトラブルシューティングする

Claude Code または Codex の WordPress アクセスを外側から内側へ向けてトラブルシューティングします。クライアントが意図した設定を読み込むこと、MCP サーバーまたは REST ツールに到達できること、WordPress の認証情報が認証されること、アイデンティティが必要な能力を持つこと、タスクが有効な入力で利用可能なツールを要求していることを確認します。

クライアント、コネクタ、認証情報、権限を同時に切り替えないでください。一つのレイヤーを変更し、一つの既知のテストを再実行し、期待される拒否境界を維持します。

一文で言うと： スタック全体を一つの接続として扱うのではなく、クライアント、コネクタ、認証、認可、タスク設計を分離します。

このガイドで達成できること

このガイドは、クライアント固有の設定参照を保持しながら、主要な二つのコーディングエージェントクライアントに共通する診断方法を提供します。サポートの曖昧さを減らし、将来の互換性に関する主張に適した証拠を生成するよう設計されています。

有用な AI ワークフローは、回答の品質だけで定義されるものではありません。アシスタントが到達できるデータ、実行を許可された行為、その後に検査できる証拠、アクセスを取り消せる容易さによっても定義されます。

これが重要な理由

接続は WordPress に接触する前、認証後、または一つの行為に対してのみ失敗することがあります。ユーザーはしばしば、すべてを再インストールしたり、より広いアクセスを付与したりして対応し、実際の問題を特定できたはずの証拠を破壊します。

レイヤーごとの方法は障害を再現可能にし、問題がクライアント、コネクタ、サイト、製品モード、またはプロンプトのどこに属するかを明らかにします。

期待される出力

成功した実行では、次を生成する必要があります：

• レイヤーごとの診断記録。
• 一つの既知の正常な読み取りテスト。
• クライアント、コネクタ、認証情報、能力、またはタスクの失敗の分類。
• 最小の修正と回帰テスト。
• サポートまたは文書化のためのバージョンに紐付いた証拠。

レイヤー 1：クライアント設定

Claude Code では、構成済みの MCP サーバーとスコープを調べます。Codex では、アクティブな config.toml レイヤーと利用可能な MCP サーバーを調べます。必要な場合にプロジェクトが信頼されていること、環境変数が値を出力せずに存在していることを確認します。

レイヤー 2：コネクタまたはサーバー

プロセスが開始すること、または HTTP エンドポイントに到達できることを確認します。タスクの実行とは独立してツール検出を調べます。パッケージバージョン、トランスポート、起動タイムアウト、サーバーの指示を検証します。ツールが存在しないことは、403 を返すツールとは異なります。

レイヤー 3：WordPress 認証

可能な場合は、認証情報と HTTPS パスを検証するために、最小の非 AI リクエストを使用します。プロキシ、ファイアウォール、セキュリティプラグインが認証を取り除いていないか確認します。認証情報をサポートログに貼り付けないでください。

レイヤー 4：WordPress の認可と対象範囲

認証済みアイデンティティ、製品モード、WordPress の能力、要求された行為を特定します。現在の製品対象範囲とコネクタツールのスキーマを確認します。ガイドまたはプロンプトは、利用できない行為を存在させることはできません。

レイヤー 5：タスクと入力

プロンプトが、有効なレコード ID、ステータス、フィールド、制限を含む利用可能なツールを呼び出していることを確認します。タスクを五件のレコードの読み取りに縮小します。動作したら、一度に一つの要素ずつ複雑さを加えます。

安全なワークフロー

1. スタック内のすべてのコンポーネントとバージョンを記録します。
2. クライアントが期待される MCP またはツール設定を読み込むことを確認します。
3. コネクタが開始し、ツールを一覧表示することを確認します。
4. WordPress 認証を独立してテストします。
5. 既知の Read Only 行為をテストします。
6. 失敗した行為を、アイデンティティに意図された能力と比較します。
7. 最小の修正を適用します。
8. 既知の読み取り、対象行為、拒否の回帰を再実行します。

プロンプトの型

このプロンプトをコピーする前に、角括弧内のすべての値を置き換えてください。認証情報、顧客データ、非公開情報を指示に貼り付けないでください。

この Claude Code または Codex の WordPress 接続を段階的に診断するのを支援してください。

スタック：
- クライアント／バージョン： [Claude Code or Codex]
- 設定スコープ： [local/project/user]
- コネクタ／MCP サーバー／バージョン： [value]
- トランスポート： [stdio/http/rest]
- WordPress／バージョン： [value]
- WP Agent Control のアーティファクト／バージョン： [value]
- アイデンティティ／モード： [value]
- 観察された利用可能なツール： [list]
- 失敗したタスク： [task]
- サニタイズ済みエラー： [error]

指示：
1. 失敗したレイヤーを分類してください。
2. 秘密の値を要求しないでください。
3. 最小の診断テストを一つ提案してください。
4. テストの後にのみ最小の修正を一つ提案してください。
5. 意図された権限境界を維持してください。
6. 既知の読み取り、対象行為、禁止行為、取り消しから成る回帰マトリックスで終えてください。

このプロンプトがこのように構成されている理由

このプロンプトは、規律のあるサポート対話を生み出します。コンポーネントのバージョンと観察されたツールを必要とし、秘密を除外し、スタック全体にわたる同時変更を防ぎます。

推奨アクセス境界

Read Only アイデンティティを使用します。アシスタントは範囲に含まれる WordPress データを検査できますが、コンテンツの作成、編集、削除、公開を試みる場合は拒否される必要があります。

このワークフローは編集上の意思決定に影響を与えたり、未公開の変更を作成したりする可能性があります。スコープを狭く保ち、提案されたすべての変更を確認します。

アクセスレベルは出発点となる推奨であり、普遍的な権利ではありません。アイデンティティに利用可能な正確な WordPress の能力は、この記事だけでなく、インストールされている製品バージョンと公開された対象範囲に基づく必要があります。

タスクの外に留めるべきこと

• 秘密の値または生の認可ヘッダーを扱わない。
• 一つの診断ステップで複数レイヤーを変更しない。
• テスト済みのアーティファクトとバージョンなしに互換性を主張しない。
• 拒否の回帰を破る権限昇格を行わない。

WP Agent Control の位置付け

これはWordPressの一般的な作業手順であり、Agent Controlがここで扱うすべての対象や連携機能を編集できるという意味ではありません。ガイド付き手順では、まず公開ページから始めます。プラグイン、テーマ、ユーザー、設定、ファイル、削除、WooCommerce、ACF、ページビルダーの操作は、標準のガイド付きタスクではありません。必要に応じて、別途検証されたツールと権限を使ってください。

接続後は、サイトの構造化情報を取得し、選択した公開ページを調べられます。この公開情報の読み取りに一時タスクは不要です。公開ページはプラグインなしでも閲覧できます。Agent Control は構造化されたアクセスと、その先の許可された WordPress 作業への流れを提供します。

AI を接続する: docs first profile · 機能と対応環境を見る: coverage

検証チェックリスト

• ☐ スタックのすべてのコンポーネントとバージョンが記録されている。
• ☐ クライアントが期待されるサーバーとツールを認識している。
• ☐ 認証が独立してテストされている。
• ☐ 認可が選択されたモードに一致している。
• ☐ 一度に適用される修正は一つだけである。
• ☐ 読み取り、対象、拒否、取り消しの回帰が成功する。

よくある失敗パターン

• スタックの再インストール： 障害を分離するために必要な証拠が破壊されます。
• クライアントをすぐ切り替える： サーバーまたは WordPress の問題がワークフローに残り、未解決のままになります。
• ツール名が能力を意味すると仮定する： ツールは存在しても、認証、権限、実装が失敗することがあります。
• 対象行為だけをテストする： 既知の正常および既知の拒否のコントロールが存在しません。

発展的な注記

互換性は、クライアントバージョン、コネクタバージョン、WordPress バージョン、プラグインアーティファクト、アイデンティティモード、タスクにわたるテスト済みのマトリックスとして表現する必要があります。サポート回答は、最も近いテスト済みセルに基づいて解決でき、現在の組み合わせが未検証の場合はそれを明確に示せます。

関連ガイド

• Claude CodeをWordPressに接続する方法
• Codex を WordPress に接続する方法
• WordPress AI の接続エラー：401 と 403 が役立つ理由
• AIアシスタントのWordPressアクセスを取り消す方法

続行

次の手順： すぐに管理者アカウントへ切り替えて拒否を回避しないでください。失敗したレイヤーを特定し、そのレイヤーだけを修正して、最小のテストを繰り返します。