Notion 团队知识库想让 AI 直接读写,官方 MCP 托管版免配置接入

团队笔记、项目文档、客户资料都堆在 Notion 里,想让 AI 直接检索、整理、回写,以前要自己写脚本调 API。Notion 官方现在给出了正路,而且是两条:官方托管的 Remote Notion MCP(接入说明在 Notion 开发者文档),以及 GitHub 官方组织 makenotion 下的开源自托管版 notion-mcp-server(MIT 协议,已发布 v2.0)。官方当前主推哪条、自托管版是什么状态,下面按官方 README 如实说。

它能做什么

  • 托管版主打省事省 token(官方对比表口径):语义搜索整个工作区与关联应用、页面以 Markdown 原生读写、只返回与问题相关的上下文——官方的说法是更快拿到结果、更少占用上下文窗口、token 成本更低
  • 托管版 OAuth 直连:浏览器授权即接入,不需要 API 令牌、不写 JSON 配置、不手动共享页面、不维护本地服务器,并且自动沿用每个用户在 Notion 里已有的权限
  • 自托管版 22 个工具:搜索、页面、评论、数据源等 API 面全覆盖;v2.0 对齐了 Notion API 的 data source 抽象,数据库相关操作改用数据源标识
  • 页面内容 Markdown 化:两个专用工具按 Markdown 读写整页内容,比逐块 JSON 的方式省得多,还支持把会议记录转写内联进返回内容
  • 双传输模式:默认 STDIO 给桌面客户端用;Streamable HTTP 模式给 Web 应用,端口、绑定地址、认证令牌都可配,还支持单个部署多集成令牌透传
  • 状态如实标注:官方 README 顶注明自托管仓库已不再积极维护与支持、未来可能停用——企业选型应以托管版为主,自托管版留给有内网隔离要求的特殊场景

怎么获取

托管版从 Notion 开发者文档的 Remote Notion MCP 页面接入。自托管版三个官方渠道:npm 官方包 @notionhq/notion-mcp-server(npx 一条命令拉起)、GitHub 官方组织 makenotion 的 notion-mcp-server 仓库源码、Docker Hub 官方镜像 mcp/notion。接入前的两步是固定的:在 Notion 个人设置的集成页面创建内部集成拿到令牌,再把要用到的页面在集成的访问设置里授权给它——官方还提醒,可以只勾「读取内容」能力,把集成直接锁成只读。

上手怎么用

  1. 自然语言派活:官方给的示例——让它「在 Getting started 页面评论 Hello MCP」,AI 会自己规划先搜索、再评论两次调用;「给 Development 页面加个子页面」同理
  2. 会议纪要回写:读取页面时开启转写内联参数,AI 拿到的是完整语境,整理出的纪要直接写回原页
  3. 只读安全档:给集成只发读取能力,AI 能检索、能总结,但动不了你的库
  4. 找内容不翻目录:让 AI 按关键词搜全库,比人在层层页面里点着找快
  5. HTTP 模式上生产:给 Web 应用用时开 HTTP 传输,务必带上认证令牌——官方对关闭鉴权的选项标了醒目的安全警告

适合谁用

用 Notion 做团队知识库、项目管理、客户档案的中小企业办公团队;想让 AI 参与内容整理与检索、又在意权限边界的管理员;已经在用各类 AI 客户端、想把笔记数据接进工作流的深度用户。要是想把 Notion 这类协作平台接进企业 AI 工作流、又拿不准权限怎么收口,可以搜「贵州诚鑫致达科技」聊聊——我们帮企业搭 AI 工具链时,数据权限的边界正是要先定下来的一件事。