よくあるトラブルの解決（Troubleshooting）
ステータス
Owner: TBD · ステータス: draft · 正式な情報源: flezi.docs
利用中によく発生するエラーをすばやく解決するためのガイドです。
1. Chat 画面が停止する、または「Stream Disconnected」と表示される
- 原因: インターネット接続が不安定であるか、プロキシが SSE 接続を切断しています。
- 解決策: ブラウザーの Refresh ボタンをクリッ クします。システムは Redis Stream cursor（
Last-Event-ID）を使ってすべてのメッセージを自動的に Replay します。
2. 機能をクリックすると「403 Forbidden」エラーになる
- 原因: 現在の Workspace におけるアカウントのロールに、十分な権限がありません。
- 解決策: 正しい Workspace を選択しているか確認するか、Workspace 管理者に連絡して権限を付与してもらいます。
3. Extension Skill Recorder が Web アプリに接続できない
- 原因: Web アプリのセッションが期限切れになっているか、Extension に権限が付与されていません。
- 解決策: Web アプリで
/authorizeページを開き、Authorize Extension ボタンをクリックします。
4. MCP Connector が Needs OAuth または Test Connection timeout の状態になる
- Needs OAuth: Account & OAuth タブを開いて現在のアカウントを認証し、もう一度 Test Connection を実行します。共有された Connector でも OAuth トークンは自動的に共有されません。
- Test timeout: MCP endpoint と transport を確認します。Tool discovery には 30 秒の制限があり、Tools 一覧を返さないサーバーは Run を停止させずにエラーになります。
- STDIO command not found: Command は service runtime 環境にインストールされ、service の PATH から検索できなければなりません。Terminal の PATH だけでは不十分です。
- OAuth 後に UI に戻っても Connected にならない: Callback の成功を確認するのは
oauth_result=successだけです。mcp_connected=1だけでは不十分です。