トラブルシューティング
拡張機能が接続できない
症状： MCP ツール呼び出しが「拡張機能が接続されていません」またはタイムアウトを返す。
chrome://extensionsで DevBridge 拡張機能がインストールされ有効になっているか確認- MCP サーバーを再起動（AI ツールで停止し再追加）
- 拡張機能をリロード（
chrome://extensionsのリロードアイコンをクリック） - ネイティブメッセージングホストがインストールされていない場合、
npx devbridge-mcp@latest --installを実行して強制再インストール
プロンプトなしでツールが拒否される
症状： ツール呼び出しが承認ダイアログなしに即座に "user rejected" を返す。
これは Claude Code でツールが事前承認されておらず、Claude Code が非インタラクティブな環境（CI、ヘッドレスセッション、プロンプトが抑制されたターミナル）で実行されている場合に発生します。
解決方法： プロジェクトの .claude/settings.local.json に DevBridge の許可ルールを追加します：
{
"permissions": {
"allow": ["mcp__devbridge__*"]
}
}これで 18 個すべての DevBridge ツールが事前承認されます。詳細は Claude Code 設定セクション を参照してください。
権限が拒否された
症状： ツール呼び出しがドメインの権限エラーを返す。
DevBridge はドメインごとの機密操作に明示的な権限が必要です。誤って権限を拒否した場合：
- ツールバーの DevBridge アイコンをクリック
- 権限 に移動し、ドメインの拒否ルールをクリア
- 操作を再試行 — 再度プロンプトが表示されます
デバッガーがすでに接続されている
症状： "別の拡張機能がこのタブでデバッガーを使用しています"。
同一タブに Chrome デバッガーを接続できる拡張機能は一度に一つだけです。chrome.debugger を使用する他の拡張機能（他の自動化ツールなど）をタブから切断してから再試行してください。
アクションインジケーターが消えない
症状： アクション完了後も DevBridge の発光インジケーターが表示され続ける。
インジケーターの停止ボタンをクリックするか、タブをリロードしてください。通常、アクション完了後 50ms でインジケーターは自動的に非表示になります。
GIF が生成されない
症状： gif_creator がエラーまたは空の結果を返す。
- タブが表示状態であることを確認（GIF キャプチャにはタブがアクティブである必要があります）
- ステップ数またはキャプチャ時間を短縮する
- Chrome に十分なメモリがあるか確認する
まだ解決しない場合
ブラウザコンソール（chrome://extensions → DevBridge → バックグラウンドページ → コンソール）でエラーの詳細を確認してください。