Notion MCP

概覽

Notion MCP 是 由 Notion 提供的官方託管模型上下文協議 (MCP) 伺服器。它讓 AI 助手與代理能夠使用開放的 MCP 標準，安全且高效地與 Notion 工作區進行互動。

使用者無需管理 API 金鑰或自行託管，只需透過簡單的 OAuth 2.0 with PKCE 進行連接即可。伺服器運行於 https://mcp.notion.com/mcp (推薦的 Streamable HTTP 傳輸方式) 和 https://mcp.notion.com/sse (後備選項)。

它由 Notion 積極維護，並針對現代 AI 工作流程進行優化，取代了已不再積極維護的舊版開源專案 notion-mcp-server。

主要功能

安全的 OAuth 驗證：在連接期間進行細粒度權限範圍設定 — 不會暴露長期有效的令牌。

20+ 個 AI 優化工具：包括 notion-search (可跨工作區及 Slack、Google Drive、Jira 等已連接來源進行搜尋)、資料庫查詢 (已針對 2025-09-03 API 及資料來源更新)、建立頁面、附加區塊、更新屬性、評論等功能。

即時雙向存取：讀取豐富內容 (自動轉換為 Markdown 以提高權杖使用效率)、建立/更新頁面與資料庫、新增評論。

零基礎設施需求：完全託管並始終保持最新 — 無需 Docker、伺服器或任何維護工作。

串流支援：採用現代傳輸方式，提供更快的回應和更佳的代理體驗。

廣泛的客戶端相容性：原生支援 Claude Desktop、Cursor、VS Code、ChatGPT (需調整工具名稱)，以及自訂的 MCP 客戶端。

運作方式

Notion 同時託管 MCP 伺服器及其底層的 Notion API。您 AI 工具中的 MCP 客戶端會自動發現可用工具，透過自然語言呼叫它們，並接收結構化的結果。一個程式碼生成管線將 Notion 的 OpenAPI 架構轉換為經過驗證的 MCP 工具 (使用 Zod)，確保了高品質與一致性。

設定選項

推薦方式：一鍵畫廊連接，或直接匯入 URL (https://mcp.notion.com/mcp) 。

Claude：執行 claude mcp add --transport http notion https://mcp.notion.com/mcp ，然後透過 /mcp 進行驗證。

Cursor：在設定中將其新增為全域 MCP 伺服器。

自訂客戶端：遵循 Notion 的 OAuth + PKCE 指南來建置您自己的整合。

Notion MCP 與舊版開源伺服器的比較

舊版 GitHub 儲存庫 (makenotion/notion-mcp-server) 仍然可用，但已不再積極維護。Notion 強烈推薦使用託管版本，以獲得更好的安全性、效能、易用性，以及與最新 API 變更的相容性。

使用案例

知識工作者總結筆記並自動建立待辦事項。

開發者在編碼時，能於 Cursor 或 Claude 中直接參考 Notion 規格文件/資料庫。

團隊建置能夠管理路線圖、維基、任務與評論的自動代理。

內容創作者生成並維護能進行即時交叉引用的動態文件。

支援工具（部分清單）

• notion-search — 具備篩選功能的強大全文搜尋。
• 資料庫與資料源操作（查詢、建立、更新）。
• 頁面與區塊管理（追加、更新富文本）。
• 評論與工作區列表。

工具會隨 Notion API 的發展保持最新狀態。

快速開始

立即造訪官方文件 developers.notion.com/guides/mcp/mcp ，連接您的 AI 工具。

Notion MCP 代表了無縫、安全的 AI 與生產力工具整合標準 — 是 Notion 生態系統中「AI 代理的 USB-C」。