CD-07辦公室難度:進階Code約30分鐘

把第一個外部工具(Gmail 或日曆)接給 Claude Code

完成後 Claude Code 會多一個真正的工具:它能直接讀你的 Gmail 或 Google 日曆,不用你再把郵件、行程一筆筆複製貼進對話框。

開始前準備(3 項)

  • 前置檢查:已完成 CD-01,而且你的 Claude Code 是用 Claude.ai 訂閱帳號登入(不是填 API 金鑰)——連結器(Connectors,由 claude.ai 官方管理的外部工具連線)只有在訂閱登入時才會載入
  • 準備一個你願意讓 AI 讀取的帳號(建議先用工作用、不含高度隱私的 Gmail 或日曆)
  • 認知準備:接外部工具是 Claude Code 前期最花時間的一步,通了之後後面都很快——像新同事報到,先給工具再交辦

照著做(5 步)

  1. 先問它、別自己猜開 claude 後,用下方 prompt 直接問「要怎麼把 Gmail 或日曆接進來」。遇到不會的設定,讓 AI 幫你上網查、一步步帶,通常比自己土法搜尋更準——這是台灣創作者雷蒙在實戰示範裡反覆強調的心法。
  2. 到 claude.ai 開啟連結器Gmail、Google 日曆這類由 Anthropic 官方託管的連結器,要在瀏覽器登入 claude.ai,到「設定 → 連結器(Settings → Connectors)」把它打開並完成 Google 授權。在終端機遇到這類工具時,系統也會提示你改到這裡連。實際畫面與名稱以官方當下畫面為準。
  3. 回終端機用 /mcp 確認回到 Claude Code 對話框輸入 /mcp(管理外部工具連線的指令),看清單裡有沒有出現剛連好的工具、旁邊顯示的工具數量。若某些工具需要在終端補做授權,它會跳出瀏覽器視窗完成 OAuth(一種免密碼的授權流程)。
  4. 小心複製授權網址的隱形錯誤若流程要你把授權網址複製貼回終端機,終端機常會把長網址折行、或在開頭多一個空格。貼上前逐字檢查:把多出來的空格、被拆成兩段的接縫處修回連續,再按 Enter,否則授權會失敗。這是雷蒙示範裡真實卡最久的一關。
  5. 用一句白話測試連好後直接用自然語言測:「幫我看今天日曆有哪些行程」或「摘要我最近三封重要郵件」。它答得出你帳號裡的真實內容,才算工具真的接上。

指令範本(複製後把括號換成你的內容)

我想讓你可以直接讀取我的 [請填寫:Gmail 或 Google 日曆]。請用最白話的方式一步步教我怎麼連——我是完全不懂技術的人。如果需要到 claude.ai 的連結器(Connectors)設定,或在終端機用 /mcp 授權,請明確告訴我每一步要點哪裡、輸入什麼;過程中你不確定的地方,先幫我上網查最新做法再教我。

怎麼驗收

輸入 /mcp 看得到該工具已連線(旁邊有工具數量);用一句白話請它讀今天日曆或最近郵件,回來的是你帳號裡的真實資料,不是它憑空編的。

注意

連任何外部工具前先確認你信任來源;會抓外部內容的工具有被「提示注入(prompt injection,惡意內容假裝成指令來騙 AI 動作)」的風險,重要或不可逆的動作(寄信、刪除)要自己把關。Gmail/日曆屬官方託管連結器,以 claude.ai 的連結器設定為準,終端機的步驟與畫面以官方當下畫面為準。官方說明:https://support.claude.com/en/articles/10166901-use-google-workspace-connectors 與 https://code.claude.com/docs/en/mcp 。
想練熟?再做一次(選用)
練習一次

用本頁的範例與指令原樣跑一遍,確認流程通。

套用工作

把[請填寫]換成你自己的資料(記得先去識別化)再做一次。

驗收

對照上面「怎麼驗收」逐項確認;卡住就回頭看「注意」。

下一步

工具接好了,做 CD-08:用這些工具做一個 /morning 每日早報指令。

回任務清單 · 逛指令庫