Notion 官方 MCP Server 怎麼配:在 Claude Code、Cursor、Codex 裏用 OAuth 連 mcp.notion.com 讀寫筆記

連接 Notion 官方遠程 MCP 伺服器無需申請 Integration Token 或本地跑 npx。本文按官方文檔整理 https://mcp.notion.com/mcp 在 Claude Code、Cursor 與 Codex 的 OAuth 配置步驟及權限排查。

NNathaniel bigo··原創首發·AI 輔助撰寫
12 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 免費帳號 帳號

結論先說

  1. Notion 官方託管了遠程 MCP 伺服器,地址是 https://mcp.notion.com/mcp,採用 Streamable HTTP 傳輸與 OAuth 授權,不需要在本地安裝 Node.js 腳本或手動生成內部集成密鑰。
  2. Claude Code 一行命令即可添加:執行 claude mcp add --transport http notion https://mcp.notion.com/mcp,隨後在會話裏輸入 /mcp 完成瀏覽器登入授權。
  3. Cursor 與 Codex 只需填一個 url 字段:Cursor 寫入 mcp.json,Codex 寫入 config.toml 後運行 codex mcp login notion 即可拉起授權頁面。
  4. AI 只能讀寫你本人在 Notion 裏有權限訪問且授權給該工作區的內容;如果搜不到某個頁面,優先檢查授權時選中的工作區(Workspace)是否正確。
  5. 主力模型訂閱與帳號配套入口:跑通 MCP 工具鏈與多文件智能體編碼依賴穩定的底層大模型配額,國內免境外卡自助開通可見本站 Claude Code 訂閱頁、ChatGPT Plus 充值頁 與 AI 會員充值總覽。

三款主流客戶端接入 Notion 官方遠程 MCP 對比

圖:本站根據 Notion 開發者文檔:Connect Notion to your AI assistant with MCP 整理的示意圖

本文根據 Notion 開發者文檔《Connect Notion to your AI assistant with MCP》《Notion MCP Overview》及 Claude Code 文檔整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Notion 或 Anthropic 官方網站。

適用於誰

  • 想在 Claude Code、Cursor 或 Codex 裏直接搜 Notion 筆記、改文檔或查數據庫,不想來回複製粘貼的開發者;
  • 還在找 Notion Integration Secret 密鑰,不知道官方已經提供免密鑰遠程 MCP 的用戶;
  • 配好 mcp.notion.com 後遇到搜不到頁面、OAuth 彈窗沒反應或切換錯工作區的人。

一、官方遠程 MCP 與舊本地包有什麼區別

早期連接 Notion 往往要在後台手動創建內部集成(Internal Integration)、複製密鑰,再用本地命令啟動進程,還必須逐個頁面手動點添加連接(Connections)。

按照 Notion 官方文檔現行方案,https://mcp.notion.com/mcp 由 Notion 官方統一託管維護:

  • 免密鑰配置:客戶端通過瀏覽器走 OAuth 2.0 授權流程,不在本地明文配置文件裏留存靜態 Token;
  • 按工作區授權:登入時直接選擇要接入的 Notion 工作區,AI 助手在你的帳號權限範圍內檢索頁面、數據庫和評論;
  • 傳輸協議更新:官方主推支持 Streamable HTTP 的 /mcp 端點,關於傳輸方式的技術差異可參考 MCP 的 stdio、SSE 和 Streamable HTTP 有什麼區別。

如果你平時主要在網頁端對話而非編程工具裏查筆記,也可以對比閱讀 ChatGPT 怎麼連接 Notion。

二、Claude Code、Cursor 與 Codex 配置步驟

1. 在 Claude Code 中配置

  1. 打開系統終端,運行添加遠程 HTTP 伺服器的命令:
bash
claude mcp add --transport http notion https://mcp.notion.com/mcp
  1. 若希望所有本地代碼倉庫都能直接調用 Notion,可在命令裏加上 --scope user 存為用戶級配置;更多作用域說明見 Claude Code MCP 配置教學。
  2. 啟動 claude 進入交互介面,輸入 /mcp,在列表中選中 notion 並選擇認證(Authenticate)。
  3. 瀏覽器會自動打開 Notion 授權頁,確認頂部顯示的帳號和目標工作區無誤後點擊允許訪問(Allow access)。

高頻在終端讓 Claude 讀需求文檔並直接改代碼,會話 token 消耗通常較快;如果遇到訂閱額度觸頂,可在本站查看 Claude Code 訂閱充值說明。

2. 在 Cursor 中配置

  1. 打開 Cursor,進入設定(Settings)> Cursor Settings > 工具與 MCP(Tools & MCP),或在項目根目錄創建 .cursor/mcp.json(全局配置位於 ~/.cursor/mcp.json)。
  2. 填入以下配置並儲存:
json
{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}
  1. 回到 Cursor 的 MCP 面板,看到 notion 旁出現連接或登入提示時點擊按鈕,在跳出的瀏覽器頁面完成 Notion OAuth 授權。完整的配置文件排錯細節見 Cursor MCP 配置教學。

3. 在 Codex(CLI / 桌面端)中配置

  1. 打開 ~/.codex/config.toml(或項目級 .codex/config.toml),新增一段遠程伺服器聲明:
toml
[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"
  1. 在終端運行登入命令觸發瀏覽器認證:
bash
codex mcp login notion
  1. 瀏覽器提示授權成功後,回到 Codex 即可在對話裏直接讓它搜尋或創建 Notion 頁面。若使用 Codex 遇到額度限制,也可在本站了解 ChatGPT Plus 充值。更多參數寫法見 Codex 怎麼配置 MCP。

三、連上後能做什麼與讀寫邊界

完成授權後,Notion 官方 MCP 會向客戶端暴露搜尋、讀取頁面、創建頁面、更新屬性與評論等工具。常見用法包括:

  • 讀規格寫代碼:在提示詞裏寫「在 Notion 搜尋標題含『支付重構』的技術方案文檔,按裏面的字段定義生成 TypeScript 接口」;
  • 查任務數據庫:讓工具查詢指定 Notion 數據庫中狀態為進行中的條目並彙總進度;
  • 把代碼變更寫回筆記:代碼提交前,讓助手在指定父頁面下新建一篇接口變更記錄,自動整理 Markdown 表格與說明。

需要注意,寫操作會直接修改真實工作區裏的文檔。讓 AI 更新長篇筆記前,建議在提示詞裏明確要求「先列出擬修改的段落或新建子頁面,不要直接覆蓋原正文」。

Notion 官方 MCP 連接與查不到頁面的排查路徑

圖:本站根據 Notion 開發者文檔:Connect Notion to your AI assistant with MCP 整理的示意圖

四、授權失敗與搜不到頁面排查

  1. 搜不到明明存在的頁面:多數情況是瀏覽器裏有多個 Notion 工作區,OAuth 授權時選錯了個人空間或舊團隊空間。在客戶端斷開並重新發起 /mcp 或重新登入,核對授權頁右上角的工作區名稱。
  2. 企業工作區提示無權限安裝:Notion Enterprise 支持企業統一管理授權(Enterprise-managed authorization)。若工作區管理員限制了外部 MCP 客戶端接入,普通成員無法自行放行,需聯絡管理員在工作區安全後台審批。
  3. 瀏覽器授權完客戶端仍顯示未連接:檢查本地防火牆或安全軟件是否攔截了客戶端監聽的本地回調端口,儲存或授權後在客戶端執行一次刷新或重啟會話以重新拉取工具列表。

常見問題

問:mcp.notion.com 官方 MCP 收費嗎?

答:Notion 官方不單獨對 MCP 接口額外按次收費,遵循你當前 Notion 帳號所在工作區的權限規則;但 AI 客戶端讀取長文檔返回的內容會正常消耗你在 Claude、Cursor 或 Codex 裏的模型上下文額度。

問:地址末尾一定要寫 /mcp 嗎?

答:要寫。Notion 官方文檔給出的標準 Streamable HTTP 地址是 https://mcp.notion.com/mcp,只填主域名會導致客戶端握手返回 404 或協議識別失敗。

問:不想讓 AI 繼續訪問我的 Notion 怎麼撤銷授權?

答:除了在本地刪掉 mcp.json 或運行 claude mcp remove notion,還可以打開 Notion 設定(Settings)裏的已連接應用(Connections)列表,找到對應的 MCP 客戶端授權記錄並移除訪問權限。

問:配置好開發環境後,國內沒有外幣卡怎麼開通 Claude 或 ChatGPT 編程訂閱?

答:可在 本站充值中心 自助選購卡密開通 Claude Code(Pro / Max) 或 ChatGPT Plus / Pro,全程無需交出帳號密碼,支持開具增值稅發票;實時價格與售後邊界(封號不在質保範圍)以對應商品頁為準。

相關教學

參考資料

  • Notion 開發者文檔:Connect Notion to your AI assistant with MCP — https://developers.notion.com/guides/mcp/get-started-with-mcp
  • Notion 開發者文檔:Notion MCP Overview — https://developers.notion.com/guides/mcp/overview
  • Claude Code 官方文檔:Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    用 ChatGPT 速讀英文產品手冊、開源文檔與 GitHub Issue 並沉澱團隊中文內訓手冊

    團隊引入海外 SaaS 工具或開源框架時,全英文文檔晦澀冗長、真正的坑全藏在幾十頁 GitHub Issue 討論裏。本文分享速讀拆解英文手冊、歸類 Issue 排障庫以及重構團隊中文內訓 SOP 的完整實戰流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 寫油猴腳本(Tampermonkey)與瀏覽器書籤小工具解決網頁繁瑣重複操作實戰

    每天在後台系統裏重複勾選幾十個複選框、手工複製網頁表格或清理遮擋閱讀的側邊欄,既枯燥又浪費時間。本文分享不會寫 JS 也能用 F12 配合 ChatGPT 寫出油猴腳本與書籤小工具的完整實戰流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 寫高質素 SQL 窗口函數(RANK / LAG / SUM OVER)做留存與漏斗分析實戰

    做用戶留存率、復購間隔與有序轉化漏斗時,多層自連接既難讀又拖垮數據庫,窗口函數則是高效解法。本文整理數據庫方言喂數規範、CTE 分層提示詞以及用內置沙盒先驗證再上線的完整實戰流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 連接 Canva、Figma、Linear、Jira、Dropbox 等第三方應用搜不到數據或授權失效怎麼辦

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 後,明明顯示已連接卻搜不到文件工單,或老提示授權失效怎麼辦?本文拆解帳號錯綁、OAuth 範圍漏選、權限繼承與管理員攔截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  6. 06

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~