| 症状 | 確認ポイント |
|---|---|
| MCP tools が agent から見えない | ~/.claude/settings.json の mcpServers.codens.command が実際にインストールされた codens-mcp の絶対パスになっているか確認。which codens-mcp の結果を貼ってください。 |
expired_token でログインが完了しない |
Device Code Flow の user_code 有効期限は 15 分。codens-mcp login 実行直後にすぐ https://auth.codens.ai/device を開いて code を入力してください。連続失敗する場合は、ブラウザを先に開いておいてから codens-mcp login を実行するのが確実です。code は再度 login するたびに新しく発行されます。 |
UNAUTHORIZED が連発する |
token が期限切れの可能性。codens-mcp whoami で現状確認 → 失敗なら codens-mcp login を再実行。token は ~/.purple-codens/credentials.json に保存されます。 |
cross-service で UNAUTHORIZED / ORG_NOT_FOUND |
Red / Blue / Green / Purple は各サービス独立の organization_id を持ちます。organization_id を渡さないことで codens-mcp v0.7.5+ が自動解決します（複数 org に属する場合は候補一覧が出るので必要なものを選んで再呼び出し）。 |
| workflow run が「pending」のまま動かない | Fargate / VPS pool が満杯の可能性。purple_workflow({ action: "get_run_status", run_id }) の status を確認。15 分以上動かない場合は run_id を添えて連絡。 |
| PR が作成されたがテストが落ちている | Purple の fix_verify ループで自動修正が走る（最大数回）。それでも落ちる場合は red_bug_report({ action: "create" }) → red_bug_fix_plan({ action: "submit_to_purple" }) で別 chain として再実行。 |
| Notion 同期が反映されない (Green) | org の Notion 連携が link されているか green_notion({ action: "status" }) で確認。link されていない場合は green_notion({ action: "link" }) の URL から OAuth を実行（admin 権限必要）。 |
| E2E テスト実行で対象サイトに到達できない | Blue 側 outbound IP がテスト対象環境の許可リストに登録されているか確認。Blue ダッシュボード → Project → Environments → IP allow list。 |
| Sentry webhook が Red に届かない | Sentry の Internal Integration の Signing Secret が Red ダッシュボードの値と一致しているか確認。ヘッダ署名検証エラーは Red のログ（Project → Activity log）で確認できます。 |