🛠 儀表板安裝設定
首次使用需完成以下步驟，讓儀表板連上你的 Asana 與 Gmail。之後可隨時從右上角「⚙ 設定」回來修改（交接時也是在這裡換人）。
🤖 不知道在哪裡？請教你的 AI 最佳夥伴 Claude Code
0 前置作業總覽（開始前先確認）
以下項目需要你本人的帳號操作或註冊——OAuth 授權無法由他人代辦，請先準備好再開始：
| 項目 | 誰的帳號／怎麼做 | 費用・額度 |
|---|
| MCP 連接器授權步驟 1 | 本人 Google＋Asana 帳號，claude.ai 上 OAuth 本人登入 | 免費 |
| Firecrawl API key步驟 1 | 本人用公司信箱到 firecrawl.dev 註冊 | 額度自負（free tier 起） |
| 自動化 routines步驟 1 | 公司的 Claude 帳號建立 | 訂閱用量（帳號自己的額度） |
| Asana Token步驟 2 | 本人 Asana 帳號建 PAT | 免費 |
| Apps Script（選填）步驟 5 | 本人 Google 帳號部署＋本人點 Gmail 授權 | 免費 |
✅ 不需要個人帳號的：儀表板網址、Cloudflare 部署與資料庫（已由工程師開通）。帳號備妥後往下走，約 10 分鐘完成。
建議的第一步：把這段貼給公司 Claude 帳號的 Claude Code，讓它全程帶你安裝、每一步實際驗證通過才往下（防呆教練）
1 Claude 基礎建設（公司的 Claude 帳號）
儀表板的資料由 claude.ai 的自動化 routines 餵入。用公司的 Claude 帳號完成三件事（此步驟在 claude.ai 完成，不在本頁面）：
① 授權 MCP 連接器（claude.ai/customize/connectors）：
- 📬 Gmail — 每日信件同步分類（本週 Tab 待辦）、週報／月報建立草稿
- 📅 Google 日曆 — 本週行程同步
- 📋 Asana — 客戶 Pipeline 同步、聯繫記錄寫回
② 申請 Firecrawl API key（firecrawl.dev 用公司信箱註冊）：產業趨勢研究的新聞搜尋用，額度各自負擔。
③ 建立自動化 routines——不用自己寫！完成 ①② 後，按下方按鈕複製指令，貼到公司 Claude 帳號的 Claude Code 對話，它會照標準範本自動建好 8 條（任何人建出來都一致）：
- 每日同步（Gmail 待辦分類＋Asana 動態，09:00／13:00）、行事曆同步（09:00／21:00）
- 商機客戶同步（Asana S1~S7→儀表板，每日 3 次——開發／客戶 Tab 的資料來源）
- 每日日誌（Asana 聯繫紀錄，19:31）、業務週報（週五 19:00 草稿給主管）
- 產業趨勢研究（週一 09:00）＋新產業補跑（每小時）、產業月報（每月 25 號產次月版）
貼上前把指令裡兩個「___」換成：同步金鑰（開通儀表板的人給你）與你的 Firecrawl key
④ 設定雲端環境網路白名單——沒設的話所有 routines 都會被 403 擋、儀表板收不到任何資料：
- claude.ai/code → Routines → 點開任一條 routine → 右上 ✏️ Edit → Environment 下拉 → 滑鼠移到環境名稱（Default）上，點右側浮出的「Edit environment」（⚠️ 不是「＋ Add environment」）
- Network access 從 Trusted 改選 Custom（選了下方才會出現 Allowed domains 欄位）→ 填兩行、不帶 https://：本儀表板網域 與 api.firecrawl.dev
- Environment variables／Setup script 留空（嚴禁放金鑰，該欄公開可見）→ 儲存 → 手動執行「行事曆同步」驗證資料有進來
2 連接 Asana
到 Asana 開發者頁面建立「個人存取權杖」（Personal Access Token），貼到下方。
3 業務 Pipeline 專案
貼上你的 Asana 業務專案網址（專案需有 S1~S7 區段與「聯繫窗口／開發階段／名單來源／客戶需求」欄位，可直接複製既有專案範本）。
4 使用者資料
產業趨勢 Tab 與月報會依產業各自呈現。⚠️ 產業一經儲存即鎖定不可修改，之後僅能從趨勢頁「＋ 產業」追加（最多 3 個）。
「本週」Tab 的待辦分類會優先參考這段描述。分類不準時回來補一條規則即可，改完最快下一次同步（每天 09:00／13:00）生效。
5 Gmail 草稿（選填）
月報／週報一鍵建立 Gmail 草稿用。照 DEPLOYMENT_RUNBOOK 用自己的 Google 帳號部署 Apps Script 後，貼上網址與金鑰。跳過則沿用預設部署。
6 完成與驗收
- 按下方「完成設定」→ 頁面重新載入，左上角出現你的名字即設定成功
- 各 Tab 的資料要等 routines 首次執行才會進來——不想等的話，把「每日同步」「商機客戶同步」「行事曆同步」請 Claude Code 立即手動執行一次（routines 頁面每條都有「立即執行」）
- 驗收清單：本週 Tab 有信件待辦 ✓ 開發／客戶 Tab 有客戶卡 ✓ 本週 Tab 行事曆有行程 ✓ 趨勢 Tab 有產業資料（新產業約 1 小時）✓
- 卡住了？🤖 請教你的 AI 最佳夥伴 Claude Code，或找開通儀表板的人
