よくある問題
サービスが起動しない
- ポートが使用中でないか確認します。ターミナルで
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 設定を確認するかプロキシを使用する |
| 接続が拒否される | サービスポートが使用中 | ポートを変更するか使用中のポートを解放する |