我不會寫程式，可以用 Claude API 接 Notion 嗎？

可以。用 n8n 或 Make 這類 no-code 自動化工具，透過 Webhook 觸發 Claude API 呼叫，再用 Notion API 寫回結果。不需要寫任何程式碼，設定約 1 小時。

從 Notion Business 降到 Plus + Claude API，現有的 Custom Agents 設定可以直接遷移嗎？

不能直接遷移。Custom Agents 是 Notion 內建功能，降到 Plus 後無法使用。你需要在 Claude 端重新設定 agent 邏輯（system prompt + MCP 工具呼叫），但資料庫結構和頁面內容不受影響。

Notion Custom Agents 開始計費了：用 Claude API + Notion MCP 自建替代方案，省下 80% 月費

2026 年 5 月 4 日起，Notion Custom Agents 正式結束免費試用，改為按 credits 計費。如果你是 Notion Business 用戶，每天跑 10 次 agent，一個月要在 $20 月費之外再多花 $33-99。但你有第二條路：Claude Haiku 4.5 + 官方 Notion MCP Server，每次跑不到 $0.01，全月 API 費用 $3 起跳，設定只需 30 分鐘。

TL;DR

Notion Custom Agents 實際費用：Business 月費 $20 + credits 費 $33-99/月（10 次/天）= $53-119/月
Claude API + Notion MCP 替代：Plus 月費 $10 + API 費 $3/月（300 次）= $13/月（省 80%+）
非工程師也能用：n8n/Make 搭配 Claude API，不需寫程式碼
已知限制：Notion MCP 不支援圖片上傳、不能刪除資料庫；npm 套件已不再主動維護

注意：credits 費用因 agent 任務複雜度而異，上列為中度使用估算（根據官方 Help Center 公布的每次 run 費用範圍）。

先算清楚你要付多少

很多人以為 Notion Business $20/月已經「包含」Custom Agents，但事實不是這樣。Custom Agents 是 Business 和 Enterprise plan 的額外付費功能，5 月 4 日起按 Notion credits 計費，價格為 $10/1,000 credits。

每次 run 的 credits 消耗

根據官方定價頁面，不同類型的 agent 每次 run 費用不同：

Agent 類型	每次費用（美元）	影響因素
Q&A 查詢	$0.03-$0.11	讀取資料量
任務分派	$0.05-$0.15	判斷步驟數
狀態更新	$0.08-$0.18	寫入操作數
信件分類	$0.04-$0.10	郵件內容長度
每日摘要	$0.10-$0.30	彙整資料範圍

用量成本對照表

使用頻率	每月次數	每月 credits 費用	加上 Business 月費
低頻（2 次/天）	60 次	$6-18	$26-38/月
中頻（10 次/天）	300 次	$33-99	$53-119/月
高頻（30 次/天）	900 次	$99-270	$119-290/月

我們實際用 Claude API 跑類似的 Notion 自動化工作流程，對比之下，中頻使用的成本差距最明顯：Notion 方案每月 $53-119，而 Claude API 路徑只要 $13。

Claude API + Notion MCP 是什麼、怎麼算

Notion MCP Server 是 Notion 官方維護的 Model Context Protocol 套件，讓任何支援 MCP 的 AI 工具（包括 Claude Desktop、Claude Code）直接讀寫你的 Notion workspace。

支援的 22 個操作

MCP 套件支援完整的 Notion 資料操作：

搜尋頁面與資料庫
讀取/建立/更新頁面內容
查詢/建立/更新資料庫項目
新增評論
讀取使用者資訊

每次 run 的實際成本

用 Claude Haiku 4.5（官方定價：$1/MTok input + $5/MTok output）跑一次典型的 Notion agent 任務：

Input：~5,000 tokens（system prompt + Notion 資料回傳 + 使用者查詢）
Output：~1,000 tokens（結構化回應或操作指令）
單次費用：(5,000 × $1 + 1,000 × $5) / 1,000,000 = $0.01

每月 300 次 = $3 API 費用。加上 Notion Plus（$10/user/月，協作功能不變），單人總費用 $13/月。

三種接法比較

方式	技術門檻	適合對象	全自動化
官方託管 MCP（mcp.notion.com）	低	一般用戶	否（需 OAuth 人工授權）
npm 套件 + NOTION_TOKEN	中	工程師	是
n8n/Make + Claude API	低	非工程師	是

重要：官方託管版本必須 OAuth 授權，每次需要人工參與，無法完全自動化。如果你要排程 24/7 自動跑，需要用 npm 套件或 n8n 路徑。

30 分鐘設定教學（npm 套件版）

這是給有基本終端機操作能力的人。實際操作時間約 30 分鐘，我們的 fleet 就是用這個方式接通 Notion。

Step 1：建立 Notion Internal Integration

前往 notion.so/my-integrations
點「New integration」
命名（例如：claude-agent），選擇你的 workspace
記下產生的 Internal Integration Token（ntn_ 開頭）
在「Capabilities」確認勾選：Read content、Update content、Insert content

Step 2：共享頁面給 Integration

在 Notion 裡，對你要讓 agent 存取的頁面或資料庫：

點右上角「...」→「Connections」
搜尋你剛建立的 integration 名稱
點「Confirm」

Step 3：安裝 Notion MCP Server

npx -y @notionhq/notion-mcp-server

Step 4：設定 Claude Desktop 的 MCP 配置

在 Claude Desktop 設定檔（~/Library/Application Support/Claude/claude_desktop_config.json）加入：

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_你的_token"
      }
    }
  }
}

重啟 Claude Desktop，MCP 圖示出現代表連線成功。

Step 5：測試

在 Claude 對話中輸入：「搜尋我的 Notion workspace 裡所有包含『專案』的頁面」。如果能回傳結果，設定完成。

非工程師路徑（n8n/Make 版）

不想碰終端機？用 n8n（自架免費）或 Make（雲端方案）也能達成同樣效果。

運作原理

觸發：Notion Webhook 偵測到資料庫變更（2026 年起 Notion 支援原生 Webhooks，不再需要輪詢）
處理：n8n 節點呼叫 Claude API，傳入 Notion 資料作為 context
寫回：Claude 回應後，n8n 透過 Notion API 更新頁面或建立新項目

實際範例：客戶 feedback 自動分類

場景：電商團隊每天收到 20 則客戶回饋，需要自動分類（產品問題/物流問題/正面評價）並建立對應任務。

n8n 流程：

Notion Webhook → 新 feedback 進入資料庫時觸發
HTTP Request → 呼叫 Claude Haiku 4.5 API，prompt：「將以下 feedback 分類為 product/logistics/positive，並建議跟進動作」
Notion API → 根據 Claude 回應更新分類欄位 + 建立跟進任務

費用：每則 feedback 約 $0.005-$0.01（input 更短），每月 600 則 = $3-6。

Webhook 限制注意

根據官方文件，Notion Webhooks 有幾個限制：

每個 automation 最多 5 個 webhook actions
API 呼叫頻率約 3 次/秒
Payload 為 sparse format（只傳 ID，需要再 call API 取完整內容）

已知限制與風險

自建方案不是萬能的。在決定切換前，你需要知道這些限制。

Notion MCP 不支援的操作

圖片上傳（無法透過 MCP 上傳附件到 Notion 頁面）
刪除資料庫（只能刪除頁面，不能刪除整個 database）
複雜的 relation/rollup 寫入（可讀取，寫入支援有限）

npm 套件的維護狀態

官方 @notionhq/notion-mcp-server npm 套件已不再主動維護，Notion 官方建議遷移到遠端 MCP（OAuth 版本）。這代表：

目前功能可正常使用，但未來新 API 功能不一定會支援
如果 Notion API 有 breaking change，npm 套件可能不會即時更新
建議定期檢查 GitHub repo 的 issue 和 release 狀態

資料隱私考量

使用 Claude API 處理 Notion 資料時，你的資料會傳送到 Anthropic 伺服器。根據 Anthropic 隱私政策：

API 呼叫的資料不會用於模型訓練（除非你主動 opt-in）
資料在傳輸和儲存時加密
但如果你的 Notion 含有高度機密資料（客戶 PII、財務紀錄），需評估是否符合你的合規要求

可靠性對比

面向	Notion Custom Agents	Claude API + MCP
穩定性	Notion 平台保證	依賴 Anthropic API uptime
錯誤處理	內建重試機制	需自行處理 API 錯誤
管理介面	Notion UI 直接管理	需要設定檔或 n8n dashboard
Fallback	自動降級處理	需自建 fallback 邏輯

決策框架：誰適合留、誰適合切換？

根據我們測試和成本分析，這是我們的建議：

你的情境	建議	原因
非工程師 + 低頻（<60 次/月）	繼續用 Notion Custom Agents	credits 費 $6-18，省事不折騰
工程師 + 中高頻（>100 次/月）	切換 Claude API + npm MCP	省 80%+，30 分鐘設定
非工程師 + 高頻（>100 次/月）	切換 n8n + Claude API	No-code 也能省大錢
需要圖片/附件操作	繼續用 Notion Custom Agents	MCP 不支援圖片上傳
5+ 人團隊 + 集中管理	繼續用 Notion Custom Agents	團隊管理介面的便利性 > 成本
已在用 Claude API 的開發者	立即切換	邊際成本幾乎為零

5 人團隊成本對比

Notion 方案：$100（Business × 5）+ $45（共用 credits）= $145/月
Claude API 方案：$50（Plus × 5）+ $3（共用 API）= $53/月
年省：($145 - $53) × 12 = $1,104/年

結論

Notion Custom Agents 計費不是世界末日，但對中高頻用戶來說，每月多花 $33-99 確實值得考慮替代方案。Claude Haiku 4.5 + Notion MCP 的組合，在我們實際部署中穩定運作，成本只有 Notion 方案的 1/5 到 1/10。

你的下一步：

先到 Notion credits dashboard 看你目前的 Custom Agents 用量
如果每月超過 100 次，前往 notion.so/my-integrations 建立 Integration Token
30 分鐘後你就有一個每次跑 $0.01 的 Notion agent