Notion MCP
Notion官方托管模型上下文协议（MCP）服务器。将AI工具（如Claude、Cursor和ChatGPT）安全连接到您的Notion工作区，支持实时读取、搜索、创建和更新操作，采用OAuth认证—无需API密钥或自行托管。
概述
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 接口”。