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

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

> QoderWake のよくある問題、ネットワーク診断表、フィードバック・サポート窓口。

このページでは、QoderWake 利用時によくある問題とその調査方法をまとめています。それでも問題が解決しない場合は、フィードバック窓口から問題レポートを送信できます。

## よくある問題

### サービスが起動しない

* ポートが使用中でないか確認します。ターミナルで `qodercli status` を実行してサービスの状態を確認します。
* 強制停止してから再起動します。まず `qodercli stop --force` を実行し、次に `qodercli start --open` を実行します。

### Waker が応答しない

* サービスが実行中であることを確認します(ブラウザで Web Console に正常にアクセスできる)。
* 「設定」→「ネットワーク設定」を開き、接続テストをクリックしてモデル API に到達可能かを確認します。
* Waker の Identity 設定が空でないことを確認します。

### WakerFlow の実行が止まる

* 実行記録 Tab で各ノードの状態を確認します。
* ユーザー入力を待っている `askUser` ノードがないか確認します。
* 対象の Waker が存在し利用可能かを確認します。

### MCP ツールの探索に失敗する

* MCP サーバーのプロセスが実行中であることを確認します。
* トランスポート方式とアドレスの設定が正しいかを確認します。
* 認証が必要なサーバーの場合は、OAuth 認可が完了していることを確認します。

## ネットワーク診断

「設定」→「ネットワーク設定」で:

* 各サービスエンドポイントの接続状態と遅延を確認します。
* 「接続をテスト」をクリックして接続テストを実行します。
* プロキシ設定が正しいかを確認します。

**よくあるネットワーク問題と解決方法:**

| 問題              | 考えられる原因        | 解決方法                      |
| --------------- | -------------- | ------------------------- |
| モデル API のタイムアウト | プロキシ未設定または設定ミス | ネットワーク設定でプロキシアドレスを正しく入力する |
| SSL 証明書エラー      | システム時刻が正しくない   | システム時刻を校正する               |
| DNS 解決の失敗       | ネットワーク環境の制限    | DNS 設定を確認するかプロキシを使用する     |
| 接続が拒否される        | サービスポートが使用中    | ポートを変更するか使用中のポートを解放する     |

## フィードバックとサポート

解決できない問題に遭遇した場合は、「設定」メニューを開き、「フィードバック」オプションをクリックして問題レポートを送信します。フィードバック送信時には、システムが関連する診断情報を自動的に添付し、問題の特定を支援します。