> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCPのトラブルシューティング

> MCPサーバーの接続、認証、ツールのよくあるエラーを診断して修正します。

該当する症状を探してください。各項目に、考えられる原因と修正方法を示しています。

## Claude Code のトラブルシューティング

| 症状 | 原因 | 修正方法 |
| - | - | - |
| ブラウザーが開かない。 | 自動起動に失敗した。 | ターミナルからURLをコピーして、手動で開いてください。 |
| ポート 35535 で接続が拒否される。 | ポートが使用中。 | macOS または Linux では `lsof -i :35535`、Windows では `netstat -ano \| findstr :35535` を実行してプロセスを停止し、再試行してください。 |
| OAuth後に接続に失敗する。 | トークンが保持されなかった。 | [ステップ 2 のコマンド](https://docs.kameleoon.com/ja/mcp/set-up-clients.md#ステップ-2-oauth認証を完了する)を再実行して、トークンを更新してください。 |
| Claudeでツールが表示されない。 | サーバーを追加する前にセッションを開始した。 | 新しいClaude Codeの会話を開始してください。 |
| `experiment_update` や `trigger_list` などの新しいツールが、ツール一覧にない。 | クライアントは、Kameleoonがこれらのツールを公開する前に読み込んだツール一覧を保持している。 | サーバーを再接続してください。Claude.ai では、**Customize** > **Connectors** に移動して Kameleoon を再接続します。Claude Code では、`/mcp` を実行して **Reconnect** を選択します。 |
| `settings.json` で `mcpServers` キーが拒否される。 | ファイルが違う。Claude Code はそのキーを使用しません。 | 代わりに `claude mcp add` コマンドを使用してください。 |
| 長期間たってから認証エラーが出る。 | OAuthトークンの期限が切れた。 | [ステップ 2 のコマンド](https://docs.kameleoon.com/ja/mcp/set-up-clients.md#ステップ-2-oauth認証を完了する)を再実行してください。 |

## 一般的なトラブルシューティング

### レート制限エラー

ツールの呼び出しが、`retryAfterSeconds` の値を含むレート制限エラーを返します。

* **原因:** 呼び出しが、ユーザーごとのMCPサーバーのツール上限、またはMCP連携用のAutomation APIゲートウェイの上限を超えました。
* **修正方法:** `retryAfterSeconds` の秒数だけ待ってから、呼び出しを再試行してください。大量の作業の場合は、リクエストをまとめるか、ループの速度を制限して、上限を超えないようにしてください。

### ポート 35535 がすでに使用されています

認証が `EADDRINUSE` エラーで失敗する場合、別のプロセスがすでにOAuthのコールバックポートをリッスンしています。

* **原因:** 以前の認証試行から、古い `mcp-remote` プロセスが残っています。
* **修正方法:** ポート 35535 を使用している古いプロセスを停止し、OAuthコマンドを再実行してください。

### Codex のチャットにMCPサーバーが表示されない

Codex は、実行中のスレッドに新しく追加されたMCPサーバーをホットリロードしない場合があります。

* **修正方法:** Codex を更新するか、`config.toml` を更新した後に新しいセッションを開始してください。

### ブラウザーでの認証が完了しない

OAuthのブラウザーウィンドウは開くものの、認可が完了しない場合は、次を確認してください。

* Kameleoonのログインページで **Authorize** ボタンをクリックしたことを確認してください。
* ブラウザーまたはシステムの設定で、`localhost` へのコールバックがブロックされていないことを確認してください。
* ブラウザーがコールバックURLを自動的に開けない場合は、手動で開いてください。

### ツールが変更を行わず BLOCKED を返す

liveトラフィックを変更するツールは、確認されるまで、ステータス `BLOCKED` のプレビューを返します。これはエラーではありません。

* **修正方法:** プレビューを確認し、意図した変更であれば、AIアシスタントに、`confirm` を `true` に設定して呼び出しを繰り返すよう依頼してください。`segment_delete` と `trigger_delete` の場合は、代わりに `force` を使用してください。

### ヘルスチェックが DOWNSTREAM\_ERROR を返す

`experiment_health_check_get` は、分子のゴールが実験にアタッチされていない比率ゴールを使用する実験で失敗します。

* **修正方法:** 不足しているゴールをアプリで実験にアタッチするか、別の実験でチェックを実行してください。

### ゴールの影響が行を返さない

データの準備中は、`goal_experiment_impacts_list` が行を返さない場合があります。

* **修正方法:** `readiness` フィールド（`PREPARING`、`PARTIAL`）を確認し、`retryAfterSeconds` の後にもう一度尋ねてください。

### 1 日分の結果が日別の内訳と異なる

1 日の期間は、組織のタイムゾーンに従います。日別のバケットはサイトのタイムゾーンに従うため、2 つが対象とする 24 時間は異なる場合があります。

### バリエーションの改善度が 0 または表示されない

オリジナルのトラフィック配分が 0% の場合、比較の基準がありません。

### ページ、ページサイズ、上限が 0 の場合はデフォルト値が返される

`takeaway_list` と `goal_experiment_impacts_list` では、ページ、ページサイズ、上限に 0 を指定すると、「デフォルトを使用」を意味します。

### リリース後に新しいツールが表示されない

再接続するまで、クライアントは古いツール一覧を保持します。

* **修正方法:** リリース後は、Kameleoon MCPコネクターを再接続してください。

### ヘッドレスまたはリモートのエージェントで認証に失敗する

リモートまたはヘッドレスのエージェント（クラウドでホストされている Codex など）は、ブラウザーでの認可ステップを完了できません。

* **修正方法:** デスクトップ版のツールを使用してください。

### パッケージランナーのコマンドが見つからない

コマンドが「not found」エラーで失敗する場合は、`npx` がシステムのパスで利用できることを確認してください。Node.js の 8.2 以降のバージョンには、既定で `npx` が含まれています。