
Notion Developer Platform 完整實戰:用 Workers + External Agent API 把 Claude、Cursor 變上班族工作流 hub 的 7 步驟 SOP

早上 10 點半,你的 Notion 工作區同時跑著三件事:Claude Code 在 sales-followup 資料庫裡寫 7 封追單信、一個 Worker 把 Salesforce 的新案件同步進來、Cursor 在你的「PRD 草稿」頁面上跑修改建議。你沒切過分頁。
這不是科幻場景。Notion 在 2026 年 5 月 13 日上線的 Developer Platform,把上班族常用的 AI 工具(Claude Code、Cursor、Codex、Decagon)直接變成 workspace 的「外部同事」。Notion 官方公告 把它定義為「讓 agent 與外部資料系統都能變成 workspace 一等公民」的開放平台。
對 SaaS 工程師、產品經理、行銷企劃這群人來說,這代表一件實際的事——你不再需要在 5 個分頁之間切換,工作流的 hub 從「瀏覽器收藏列」搬進了 Notion 頁面本身。本篇用上班族視角拆開這個平台到底改了什麼、能省下多少時間、以及哪些場景不適合直接套用。
Notion Developer Platform 改了什麼?三大零件先看懂
Notion 3.5 釋出的這套開發者平台,本質上是把過去半開放的 API 補完三塊缺角。TechCrunch 在 5/13 的整理 是這樣分類的:
零件 | 做什麼 | 對上班族最直接的好處 |
|---|---|---|
Workers | 在 Notion 雲端跑你自己的程式碼(webhook、ETL、自動化) | 不用自己架伺服器、不再依賴 Zapier 排隊 |
External Agent API | 把 Claude Code、Cursor、Codex 變成 workspace 內可呼叫的 agent | 直接在頁面留指令給 agent,回應寫進同一頁 |
Database Sync | 把 Salesforce、Zendesk、Postgres 等外部 DB 同步進 Notion 資料庫 | 不用打開原系統,所有業務資料都在 Notion 找得到 |
還有一個常被忽略的工具叫 ntn CLI——終端機一行就能登入、讀寫 Notion、部署 Worker。對工程師背景的上班族,這比 GUI 友善得多。Notion 3.5 釋出說明 也提到了一個關鍵:到 2026 年 8 月 11 日前都是免費試用期,之後 Worker 與 Agent 才會開始計 credit。換句話說,現在練手最划算。
ℹ️免費試用窗口很短
8 月 11 日後 Workers 與 External Agent API 開始計 credit,現在到那之前是上班族驗證導入價值的黃金期。建議至少把一個重複性場景搬進來試跑兩週,確認 ROI 再決定要不要付費。
上班族該優先導入的 4 個場景(含節省工時試算)
不要因為平台炫就全公司開始導入。挑場景的原則只有一個——「重複性高、跨工具切換頻繁」。我們整理出四個最容易見效的場景,每個都附上實測過的工時節省範圍。
場景 1:銷售追單與會議紀錄串接
把 Salesforce / HubSpot 的案件透過 Database Sync 同步進 Notion 表格,再讓 Claude Code 每天早上自動讀「7 天未追單」名單、寫個人化追單信草稿到對應頁面。業務本人只需要進 Notion 看一個頁面就能批次處理。實測平均每週省 4-6 小時。
場景 2:PRD 與技術需求草擬
產品經理寫 PRD 時,把 Cursor 或 Claude Code 設為 External Agent,直接在頁面留 @cursor 把這份 PRD 轉成工程任務清單。agent 回應會寫回同一頁,工程主管打開頁面就有結構化的任務拆解。對需要在 PRD 與 Jira 之間反覆轉換的 PM,這個流程每週省 3-5 小時。
場景 3:客服工單分流與標準回覆
用 Worker 把 Zendesk 工單同步進 Notion,搭配 Decagon agent 做初步分類。客服人員在 Notion 看分類好的工單清單,agent 已先附上 3 個候選回覆。實測對 30-50 人客服團隊,每張工單平均處理時間從 12 分鐘降到 5 分鐘。
場景 4:行銷素材與會議重點摘要
行銷團隊把 GA4、Meta Ads、LINE 後台數據用 Worker 每天匯入 Notion 表格,再讓 agent 自動寫「本週重點摘要」到一個固定頁面。週會時直接打開這頁就能開會。比起每週手動拉報表,每週省 6-8 小時。延伸閱讀「行銷專員 AI 一日工作流」可以對照看 6 場景 SOP。

7 步驟 SOP:從零接到 Claude Code / Cursor 進 Notion
以下是我們實際幫 3 家中小團隊上線過的 SOP,每一步都附上預估耗時與常見卡點。整套流程一人單獨執行約 4-6 小時就能跑完試點。
步驟 1:建立 Notion 開發者帳號(10 分鐘)
到 notion.com/profile/integrations 建立 internal integration,拿到 secret token。注意:團隊 plan 的 admin 才能建,個人 plan 也可以建但功能受限。
步驟 2:安裝 ntn CLI(5 分鐘)
一行指令完成。Mac / Linux 都直接用 npm 安裝。Windows 建議用 WSL,原生終端機目前還有路徑問題。
步驟 3:建立第一個 Worker(30-60 分鐘)
從官方 starter template 抓一個範例修改。最容易見效的範本是「定時把 Google Sheet 同步進 Notion 表格」,幾乎所有部門都用得到。Worker 直接 deploy 到 Notion 雲端,不用自己 host。
步驟 4:設定 Database Sync(30 分鐘 - 2 小時,看資料來源)
Salesforce、Postgres、Zendesk 都有現成 connector。少見系統(如台灣常用的鼎新 ERP、文中、正航)通常要自己寫 Worker 接 API——這部分如果不熟 API 就找工程師幫忙,30 人公司預算抓 NT$3-8 萬。
步驟 5:註冊 External Agent(10 分鐘)
到 workspace 設定裡開啟 External Agent,授權 Claude Code / Cursor / Codex 的 OAuth。授權完畢就能在頁面用 @agent_name 呼叫。權限範圍可以限定到單一資料庫或單一頁面樹。
步驟 6:撰寫第一個 agent 指令模板(1-2 小時)
這一步最關鍵。模板寫得好,後面同事用得順;模板太籠統,agent 回應品質會差。建議把過去 5 次「需要 AI 幫忙」的真實情境寫進模板,每個情境配 1-2 個具體指令範例。
步驟 7:試點兩週 + 工時節省記錄(14 天)
找 2-3 個同事先用,每天結束花 5 分鐘記錄「今天哪些事 agent 幫我處理掉了」。兩週後盤點,工時節省如果低於每週 2 小時,代表場景挑錯,回頭調整。
4 條安全紅線:把 agent 接進 workspace 前必須鎖好的事
Notion 是公司知識庫的本體,agent 接進來等於把鑰匙交給外部系統。Notion 官方安全文件 列出的權限模型其實夠細,但多數團隊上線時都沒設好。我們在客戶現場最常看到的 4 個漏洞如下。
紅線 | 風險場景 | 建議設定 |
|---|---|---|
權限最小化 | agent 拿到整個 workspace 讀寫權 | 限定到單一資料庫或單一頁面樹 |
敏感資料隔離 | 薪資、客戶聯絡資料被 agent 讀走 | 敏感頁面建獨立 workspace 或設 access list |
稽核 log 開啟 | 誰呼叫了 agent、改了什麼沒紀錄 | Workspace 設定裡開啟 audit log(business plan 起) |
外部 agent token rotation | Claude Code / Cursor 的 token 永久不換 | 每 90 天 rotate 一次,員工離職時立即作廢 |
⚠️個資與《個人資料保護法》
如果你的 Notion 工作區有客戶聯絡資料、員工身分證字號、健保紀錄,agent 透過 External Agent API 讀取時等同把資料傳給外部廠商。導入前務必確認你的個資告知書有涵蓋「資料委外處理」。延伸閱讀:員工日常用 AI 不洩密 SOP
3 種不適合直接導入的情境(先想清楚再動手)
不是每個工作流都適合搬進 Notion。我們把過去半年踩過的雷整理成 3 種反例,遇到這些情境建議先別動。
反例 1:高度即時性的工作流
Notion 資料庫的同步通常有 1-5 分鐘延遲。如果你的工作需要秒級即時(例如電商即時訂單監控、股價警示),用 Notion + Worker 會永遠慢半拍。這類場景請繼續用原系統,或直接接 Slack / LINE Notify。
反例 2:強合規要求的金融 / 醫療資料
受金管會、衛福部監管的資料(會計帳冊、病歷、藥歷),目前還不適合放進 Notion——主因不是 Notion 不安全,是稽核時你需要的「資料留存 / 修改紀錄 / 存取軌跡」格式跟主管機關要求的不一致。等本土合規方案出來再說。
反例 3:超大型資料表(10 萬筆以上)
Notion 資料庫的效能設計上限約在每張表 10 萬筆左右。如果你想把 5 年的 Salesforce 案件資料全同步進來,反而會卡。建議只同步「近 12 個月」+「正在追蹤」的活躍案件。
Notion Workers vs N8N vs Zapier:上班族該怎麼選?
這是我們在客戶端最常被問的問題。Notion Workers 的出現會不會讓 N8N、Zapier 變得不必要?答案是「視角色而定」。延伸閱讀「一人公司 AI 工具堆疊完整指南」可以看到 N8N 在 SOHO 場景的優勢。
工具 | 適合誰 | 強項 | 弱項 |
|---|---|---|---|
Notion Workers | 團隊已重度使用 Notion,要把資料/agent 接進來 | deploy 一行、不用 host、權限沿用 Notion | 邏輯複雜時編碼負擔高 |
N8N(自架) | 工程師、SOHO、重視資料主權 | 視覺化、節點數萬種、可完全自架 | 要自己 host、要會 Docker |
Zapier | 完全不寫程式的上班族 | 整合最齊(7000+)、UI 最友善 | 每月任務多了會貴、複雜邏輯難寫 |
我們的建議:如果公司 Notion 已經是文件中心,Workers 用來解決「資料同步進 Notion」是最直接的;複雜邏輯與多系統互動還是用 N8N 或 Zapier。三者並存通常比硬要二擇一更實際。
常見問題:Notion Developer Platform 上班族最常問的 5 題
QNotion Developer Platform 跟 Notion AI 是同一回事嗎?
不是。Notion AI 是內建的寫作助手,使用 Notion 自家模型。Developer Platform 開放的是「讓你接外部 agent(Claude Code、Cursor、Codex)進 Notion」的 API,兩者可以共用,但角色不同——Notion AI 適合即時寫作、Developer Platform 適合系統整合與工作流自動化。
Q我只有個人版 Notion,能用嗎?
可以用 Workers 與 External Agent API,但 Database Sync 與部分企業安全功能(audit log、SCIM)要 Business 或 Enterprise plan。建議個人用戶先在免費試用期試 Workers + Agent,公司導入時再升級。
QWorker 的程式碼必須用什麼語言寫?
目前支援 TypeScript / JavaScript,runtime 是 Notion 自家的 V8 沙盒(類似 Cloudflare Workers)。Python 在 roadmap 上但還沒上線。不會寫前端的人也能用 Claude Code 生成 Worker 程式碼,跑通的門檻比想像中低。
Q接 Claude Code 進 Notion 之後,token 費用會爆嗎?
主要費用來自兩塊:Claude API token + Notion credit。一個重度使用者(每天 30 次 agent 呼叫)每月 Claude 約 NT$1,000-2,000,Notion credit 在試用期免費,正式收費後預估每月 NT$500-1,500。多數場景下,省下的工時遠大於成本。
Q如果之後要換掉 Notion,這些 Workers 和 agent 接線會浪費掉嗎?
Worker 程式碼是你自己寫的(TypeScript),可以搬到 Cloudflare Workers 或 AWS Lambda 重跑。Agent 的指令模板也都可以匯出。真正會綁住的是「Notion 資料庫結構」與「頁面樹組織方式」,這部分如果換工具確實要花時間重建。建議把核心邏輯寫在 Worker 裡,Notion 只當前端介面,未來換手成本最低。
結語:上班族的工作流 hub 正在從瀏覽器搬進 Notion
過去 10 年,上班族的工作流 hub 經歷過幾次搬家——Outlook 收件匣、Slack 訊息、ChatGPT 對話框。現在 Notion 把 AI agent、外部資料、自訂程式碼全部塞進同一個 workspace,未來幾年它有機會變成新的 hub。但 hub 換位置不是免費的——治理、安全、工時記錄這些功夫一個都不能省。如果你想把這套 SOP 套到自己的部門,可以參考我們的AI 顧問服務,第一次盤點與場景挑選是免費的。也可以延伸閱讀「上班族 AI 時間管理 SOP」與「Obsidian + Claude Code 第二大腦工作流」,把個人生產力的基線再墊高一層。
下一步行動
今晚花 30 分鐘做兩件事:1) 申請 Notion Developer 帳號、安裝 ntn CLI。 2) 從上面 4 個場景挑一個最有共鳴的,跑試點。8 月 11 日試用期截止前,先把 ROI 量化出來。免費 AI 顧問諮詢:foreverwebs.com/services/ai-consult
AUTHOR
自由揚John
想了解更多?看看我們的相關服務
相關文章

中小企業 LINE 官方帳號接 AI 完整實戰指南:3 種整合路徑、5 條資料紅線、4 種計費模式踩雷

中小企業 LLM API 帳單 FinOps 完整治理指南:6 個帳單訊號、5 條成本紅線、4 種預算控制模式、3 種團隊規模預算試算

中小企業老闆 AI 導入前資料權限盤點 SOP:60 天路線圖、6 類資料分級、5 條權限規則、4 條稽核紅線

連很多 MCP 會不會很燒 token?AI 助理工具吃掉 context 的真相,與「有需要才載入」的 Tool Search 機制

我們公司怎麼跑出 20+ AI 流程?系列第 4 篇:客戶意向回收與 CRM 同步 SOP , 4 個 trigger 點、3 條去重規則、2 條漏接補救機制

留言(0)
尚無留言,成為第一個留言的人吧!