Claude Code のトラブルシューティング
一般的なトラブルシューティング
レート制限エラー
ツールの呼び出しが、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 が含まれています。