トラブルシューティング

原因

PATH が通っていないか、グローバルインストール後にターミナルを再起動していない

解決策

新しいターミナルを開く。または `which claude` / `where claude` でパスを確認し、手動で PATH に追加する。

原因

Claude Code の MCP 設定が正しくない、または認証が切れている

解決策

`claude mcp list` で `playwright: ✓ Connected` を確認。接続が切れている場合は Claude Code を再起動。

原因

CAPTCHA・Cloudflare・JavaScript 必須フォームなど

解決策

CAPTCHA の場合は `awaiting_approval` にして人間が手動送信。Cloudflare ゲートの場合は `error` ログを記録。

原因

`sentMessage` が欠如しているか 30 文字未満

解決策

`details.sentMessage` にフォーム本文欄に実際に入力した文字列を渡す。TEL/MAIL のみのダンプは NG。

原因

Sales Claw デスクトップアプリが起動していない

解決策

Electron アプリを起動するか、`npm run dashboard:preview` でサーバーを直接起動する。

原因

`browser_take_screenshot` に正しいパスを指定していない

解決策

`screenshots/ss-{No}-input.png` の形式でパスを指定。ディレクトリが存在しない場合は手動で作成。

原因

ターゲットリストに除外スタータスが設定されていない

解決策

`data/settings.json` の `excludeStatuses` に `submitted`, `awaiting_approval` が含まれているか確認。