Notion MCP

概述

Notion MCP 是由 Notion 提供的 官方托管 Model Context Protocol (MCP) 服务器。它使 AI 助手和代理能够使用开放的 MCP 标准，安全高效地与 Notion 工作空间进行交互。

用户无需管理 API 密钥或自行托管服务器，只需通过简单的 OAuth 2.0（带 PKCE）进行连接。服务器运行地址为 https://mcp.notion.com/mcp（推荐的流式 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 规范/数据库。
• 团队构建自主代理来管理路线图、wiki、任务和评论。
• 内容创作者生成和维护具有实时交叉引用的动态文档。

支持工具（部分列表）

• notion-search — 支持筛选器的强大全文搜索功能。
• 数据库与数据源操作（查询、创建、更新）。
• 页面与块管理（追加、更新富文本）。
• 评论与工作区列表功能。

工具持续更新，与 Notion API 的演进保持同步。

快速开始

立即访问官方文档 developers.notion.com/guides/mcp/mcp ，连接您的 AI 工具。

Notion MCP 代表了无缝、安全的 AI 与生产力工具集成标准 —— 堪称 Notion 生态系统中“AI 智能体的 USB-C 接口”。