Notion AI 工作区 MCP 服务器

它解决什么问题

Notion 是一个典型的「工作区型」应用：页面、数据库、子页面、属性、筛选条件分散在不同层级里。传统自动化工具要么需要手写 API 调用，要么只能在固定的模板里跑，AI 代理很难直接伸手进去操作。结果就是，人得先从 Notion 里把数据复制出来、整理好，再交给 AI 处理，流程断在中间。

这个技能要补的正是这个断点：让 AI 代理通过 Model Context Protocol（MCP） 直接读写 Notion 工作区，不需要用户手写 REST 请求，也不需要维护一套中间脚本。

它如何工作

核心是一个由 Notion 官方提供的 MCP 服务器，把 Notion 的常见操作封装成一组 工具（tools），供支持 MCP 的客户端调用：

• 查询数据源：读取已有的数据库或页面内容，拿到结构化结果；
• 创建与更新页面：在指定数据库或页面下新建子页面，或修改已有页面的文本与属性；
• 搜索内容：按关键词在工作区内定位页面；
• 管理数据库：处理数据库相关的操作请求。

调用方式上，用户用自然语言下达指令即可。比如「在本周的待办数据库里新建一条记录，标题是 XX，状态设为进行中」，MCP 客户端会把这个意图拆成工具调用，服务器再转成 Notion API 请求。同一套服务器可以挂到 Claude、Cursor、Copilot 等不同客户端上，因为 MCP 负责协议层，客户端负责交互层。

服务器本身支持两种运行形态：通过 docker compose build 在容器里跑，或用 npx @notionhq/notion-mcp-server 直接拉起。传输层可选 --transport stdio（本地进程内通信）或 --transport http（网络暴露给远程客户端）。

适用边界与注意点

先说前提条件。 Notion 要求所有 API 访问都经过一个 internal integration：需要到 https://www.notion.so/profile/integrations 创建或选择一个已有的集成，拿到 token，再把这个 token 配置到 MCP 服务器的环境里。没有这一步，服务器起得再正常也调不动任何数据。

再说权限粒度。 Notion 的集成权限是按「工作区」维度授予的，用户可以限定这个集成能访问哪些页面和数据库。建议在生产使用前先做一轮权限收敛，别把整个工作区都开放给一个集成，尤其是这个集成背后挂的是一个能自主调用工具的 AI 代理。

最后是能力边界。 工具集覆盖的是最常见的读写场景——查、建、改、搜、管数据库。它不是 Notion API 的完整镜像，一些边缘操作（例如跨工作区的复杂权限管理、批量历史回滚）可能不在封装范围内。遇到这类需求，要么确认服务器当前是否支持，要么退到 Notion 原生 API 自己写。

综合来看，这个技能适合的场景是：你已经在用 MCP 客户端跑 AI 代理，且希望代理能直接操作 Notion 里的结构化内容，而不是绕一圈手动搬运。