所有文章
AFFiNE
Toeverything·發布於 2026年8月20日
純文字面板與畫布面板連向同一個 MCP 連接埠的示意圖

Notion MCP 是什麼?連接方式、用途與限制一次看懂

重點整理

  • Notion MCP 是 Notion 官方的 MCP 伺服器:接上一次,Claude、ChatGPT、Cursor 等 AI 助理就能搜尋頁面、查詢資料庫,並在你允許的範圍內建立頁面。
  • 連接走 OAuth,幾分鐘完成——不是手貼 API 金鑰,而是用 Notion 帳號授權。
  • 兩個限制是結構性的:現行官方伺服器只有託管版(不能自架),而白板這類視覺資訊本來就不在 Notion 的資料模型裡。
  • 如果團隊的決策也留在白板上,或自架是硬需求,AFFiNE 內建的 MCP 伺服器是守備範圍更廣的選擇(文末有對照表)。

這篇會講清楚 Notion MCP 實際能做什麼、各用戶端怎麼接、哪些限制容易讓人措手不及,以及什麼情況該考慮別的伺服器。若對 MCP 本身還不熟,先讀 MCP 是什麼。

Notion MCP 是什麼?

Notion MCP 是由 Notion 託管的官方 MCP 伺服器。它把工作區功能包成型別明確的工具,讓任何 MCP 用戶端都能呼叫:搜尋頁面、讀取內容、查詢資料庫,以及建立或更新頁面。實際存取範圍會沿用完成 OAuth 的 Notion 使用者所擁有的完整工作區權限。

接之前要知道的兩個前提:

  • 由 Notion 託管:授權透過你的 Notion 帳號 OAuth 完成,伺服器跑在 Notion 的基礎設施上。現行官方伺服器沒有自行架設的選項(先前的開源版已停止維護)。
  • 權限邊界是登入的使用者:託管版伺服器會取得完成 OAuth 的 Notion 使用者所擁有的完整工作區權限,授權時不會出現逐頁選擇器。若要縮小範圍,應改用權限較低的專用帳號。
OAuth 將登入使用者的工作區權限透過 Notion MCP 帶到頁面與資料庫
託管伺服器沿用完成 OAuth 的使用者權限,並沒有另一個逐頁選擇器。

用 Notion MCP 能做什麼

實務上的價值集中在三件事:

  • 對真實筆記發問:「新人方案定價的結論是什麼?」答案來自實際的會議頁面,而不是模型的猜測。
  • 用白話查資料庫:過濾逾期任務、彙整業務管線、列出上線前的阻塞項——結構化查詢直接用中文問。
  • 往工作區寫草稿:在允許的位置建立頁面或補內容,會議摘要進對的資料庫、研究筆記直接落在 Notion。

各用戶端的接法

官方連接流程在各用戶端大致相同:加入伺服器、在瀏覽器完成 OAuth,並核准該用戶端。

  1. Claude(Desktop 與 claude.ai):從連接器目錄加入 Notion,或以自訂連接器指向 Notion 的 MCP 端點,在 OAuth 視窗完成授權。
  2. Claude Code:用 CLI 以 HTTP 傳輸加入,首次使用時在 /mcp 完成認證。步驟與在 Claude Code 加入 MCP 伺服器相同。
  3. Cursor:把 Notion 伺服器寫進 ~/.cursor/mcp.json,重啟後授權。
  4. ChatGPT:連接器支援 MCP 伺服器,自訂伺服器要在開發者模式加入,授權用的還是你的 Notion 帳號。

連接後,用一個你知道答案的問題測試:「找出比較供應商報價的頁面,列出入選名單。」若找不到,先確認登入帳號能否在 Notion 內找到該頁,再檢查用戶端是否允許所需工具。

連接前先確認權限與方案限制

Notion 的安全指南明確說明:託管版 MCP 伺服器能以登入使用者的完整權限執行。Enterprise 管理員可以核准或封鎖 MCP 用戶端,但日常使用時,OAuth 帳號本身才是最重要的安全邊界。需要限縮權限時,請使用低權限專用帳號,並撤銷不再使用的連線。

Notion 內部頁面搜尋普遍可用;Slack、Google Drive、Jira 等已連接外部來源的搜尋,則取決於 Notion AI 與方案。不同工作區能用的工具也可能不同,請以官方支援工具清單為準。

權限邊界區分 Notion 內部搜尋,以及還要通過 AI 方案條件的外部來源搜尋
工作區權限決定 MCP 能到哪裡;已連接外部來源的搜尋還可能需要 Notion AI 方案。

容易措手不及的限制

  • 只有託管版:現行官方伺服器沒有自架路徑。如果合規要求知識基礎設施必須放在自己的機器上,這是結構性的不合,不是設定問題。
  • 守備範圍是文字與資料庫:Notion 的資料模型是頁面加資料庫。白板、圖解、便利貼牆——視覺化思考不在產品的模型裡,伺服器自然也搜不到。
  • 託管版不支援服務帳號 Bearer Token:官方流程採使用者 OAuth,無人值守或 Headless 自動化需要改用其他整合設計。
  • 更深的 AI 檢索是付費功能:Notion 自家跨外部應用程式的 AI 搜尋屬於 AI 方案;MCP 連線給的是工具存取權,不會順便解鎖那些功能。

以資料庫為核心的團隊,這些都不致命。真正有感的是兩種情境:知識是視覺的,或自架不可讓步。

什麼時候 AFFiNE MCP 更合適

AFFiNE 解的是同一個問題——讓工作區能被 AI 讀懂——但起點不同:文件與白板本來就在同一個工作區,內建 MCP 伺服器把兩者都當一等公民。

Notion MCPAFFiNE MCP
伺服器官方,由 Notion 託管官方,內建於產品
自架不支援(現行伺服器)支援——自架環境跑同一套伺服器
白板不在資料模型內索引畫布文字,回傳元素與框架定位
搜尋在登入使用者的完整權限內搜尋 Notion;外部來源搜尋取決於 Notion AI關鍵字加語意檢索,涵蓋整個工作區(依你的權限)
憑證使用者 OAuth,連線沿用該使用者的工作區權限按用戶端發放,可設期限並即時撤銷,預設唯讀
費用連接免費AFFiNE Cloud 與開啟 AI 功能的自架環境免費

對照基於 2026 年 8 月時點的公開資訊。

團隊最先有感的差異是白板。決策很少只留在文字裡——架構評審的那張圖、回顧會議的便利貼牆。能「搜尋思考發生的地方」的伺服器,回答得了純文字伺服器答不了的問題。設定也在產品內完成:設定 → Integrations → MCP Server → Create credential → 把生成的 JSON 貼進用戶端。

把比較拉到產品層面,誠實的分法是:以資料庫營運為主的團隊選 Notion;文件與視覺工作混合、又可能需要自架的團隊選 AFFiNE。單看 AI 接入層,上面那張表就是決策表。

常見問題

Notion MCP 免費嗎?

有 Notion 帳號就能免費連接,基本工具存取在免費工作區也能用。但 Notion 自家的 AI 功能(例如跨外部應用程式的 AI 搜尋)屬於付費 AI 方案,MCP 連線不會解鎖那部分。

Notion MCP 能在 ChatGPT 用嗎?

能。ChatGPT 透過連接器支援 MCP 伺服器,自訂伺服器在開發者模式加入。Claude、Claude Code、Cursor、Cline 也都支援——一個伺服器,所有相容助理都能用,這正是 MCP 的意義。

Notion MCP 可以自架嗎?

不行。現行官方伺服器只有 Notion 託管版,先前的開源版已停止維護。若 AI 可用的知識庫必須自架,AFFiNE 在自架環境提供與 Cloud 相同的 MCP 伺服器。

Notion MCP 搜得到白板或圖表嗎?

搜不到——Notion 的資料模型是頁面與資料庫,本來就沒有畫布內容可搜。AFFiNE 的 MCP 伺服器會索引 Edgeless 畫布上的文字,並回傳元素與框架定位,圖解和便利貼牆也能用搜尋找到。

Notion MCP 和 Notion API 差在哪?

API 是 Notion 給開發者寫程式用的介面;MCP 伺服器是在其上的標準層,把工作區功能包成 AI 助理能自行發現、安全呼叫的型別化工具。使用 MCP 幾乎不用寫程式——OAuth 授權加一段設定就完成。

結語

把伺服器接在團隊決策真正居住的地方。如果那是資料庫,Notion MCP 是好選擇;如果是文件加上計畫成形的那塊白板——把兩者都交給你的助理。幾分鐘即可完成;開啟 AI 功能時不另收 MCP 費用。