Notion MCP：让 AI 直接读写你的知识库

把工作区里的页面、数据库、会议记录接给 AI，读和改都不用复制粘贴。

用 Notion 团队常有个痛点：资料都在里面，但让 AI 帮忙总结或改写时，只能手动全选复制。Notion 官方的 MCP 服务解决的就是这条链路。需要提醒一点：目前官方主推的是托管版 Remote Notion MCP（https://mcp.notion.com/mcp），走 OAuth、无需 token；之前开源的本地版 @notionhq/notion-mcp-server 已不再积极维护，官方也说明未来可能归档。本文以托管版为主，本地版作为自托管场景的备选。

配置示例

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

Claude Code 用 claude mcp add --transport http notion https://mcp.notion.com/mcp，然后在会话里跑 /mcp 完成 OAuth。Codex 在 ~/.codex/config.toml 写 [mcp_servers.notion] 与 url = "https://mcp.notion.com/mcp"，再执行 codex mcp login notion。

搜索是语义的，不用记住页面标题

托管版最明显的改进是语义检索：你说「上季度关于定价的那份讨论」，它能把相关页面找出来，而不要求你精确匹配标题关键词。它还能跨已连接的应用检索，把散在多个来源的上下文一次拉齐。对资料库大、命名随意的团队，这一条直接决定能不能用。

页面按 Markdown 读写，token 消耗低很多

本地版早期暴露的是 block JSON，一页笔记动辄几千 token，模型还没回答问题就先把上下文吃满。托管版提供 Markdown 原生的读与写：读取时直接返回整页 markdown，编辑时可以选择整页替换或局部查找替换。实测意义在于：读一篇长文档的代价大幅下降，才谈得上「让它通读一遍再总结」。

权限沿用 Notion 自己的，不用重新配

托管版走 OAuth，AI 能看到的内容跟你本人账号一致：你没权限的页面它也读不到。这一点比本地版省事得多——本地版需要建 internal integration，再逐个页面手动授权，漏一个就报「找不到页面」，是新手最常踩的坑。团队成员各自授权自己的账号，不需要管理员统一发 token。

写操作有边界，不是无限权限

通过 MCP 暴露的 API 范围本身受限，例如不支持通过 MCP 删除数据库；写操作集中在页面创建、内容更新、评论、属性修改这些日常动作。实际使用建议再加一层约束：为 AI 建一个专门的上层页面，只把该页面共享给它，形成干净的作用域。即使模型误操作，影响范围也可控。

使用上手：四步接入

1. 准备客户端。以 Claude Code 为例，先确认 claude 命令在 PATH 里，否则会报 command not found。
2. 添加服务器。执行 claude mcp add --transport http notion https://mcp.notion.com/mcp；团队共享则在项目根放 .mcp.json。
3. 完成授权。在会话里跑 /mcp，按提示在浏览器登录 Notion 并选择目标工作区。
4. 验证。让它「列出你能访问的页面」，能返回真实列表即接通；返回空通常是授权时选错了工作区。

优点与不足

优点：零 token 配置、OAuth 开箱即用；Markdown 读写大幅降低上下文开销；权限模型跟 Notion 自身一致，不会越权；官方持续维护，功能迭代快。

不足：第一，它需要联网访问托管端点，纯内网或合规要求高的环境可能不允许，只能回退到本地版并自行维护。第二，本地版官方已明确不再积极支持，issue 不常跟进，长期用要有心理准备。第三，对数据库的操作抽象变了——本地版 2.0.0 把 database 换成了 data source 概念，旧提示词里写死 database_id 的需要改。

适合谁

• 用 Notion 做团队知识库的团队：会议记录、需求文档、周报都在里面，让 AI 直接读。
• 写作者与研究者：让它通读一批页面再产出摘要或大纲，比手工导快很多。
• 把 Notion 当轻量 CRM / 项目库的人：查状态、改属性、批量打标签都能交给它。

下载与访问

• 官方文档：https://developers.notion.com/guides/mcp/get-started-with-mcp
• 托管端点：https://mcp.notion.com/mcp
• 本地版仓库：https://github.com/makenotion/notion-mcp-server

许可证与获取

本文属于「连接器」分类的 AI 资源专栏，更多评测见分类页。