Notion MCP Server 是什么？
Notion MCP Server 是把 Notion 页面和数据库接入 AI 助手的官方服务。它让 Codex 在你明确共享的范围内搜索、读取、整理或更新真实工作区内容，不需要反复把文档复制进对话。
一句话理解在用户授权的 Notion 页面和数据库范围内读取、整理或更新知识内容。
为什么需要它？
让助手在真实知识库中查找上下文，而不是依赖重复粘贴或过期摘要。
接入前，AI 只能依赖你粘贴的材料、截图或旧上下文；接入后，它可以在你授权的范围内调用真实工具，并把结果、来源和状态带回当前任务。
核心能力
读取已授权页面和数据库
把真实信息带回当前任务，减少反复复制和手动核对。
搜索工作区内可见内容
在明确授权范围内调用工具，并保留执行过程和结果。
在允许写入时创建或更新内容
回读来源、状态与限制，方便继续处理和人工验收。
适合谁？怎么用？
- 在 Notion 里找项目资料和会议记录
- 把项目文档、会议记录、研究资料或内容计划维护在 Notion 的个人与团队。
- 返回的页面确实在已共享范围内，并能核对页面标题、更新时间和链接。
- 不适合默认开放整个工作区，或让助手直接改写正式知识库。
- 集成可见范围取决于共享页面与工作区授权
- 写权限会允许改变真实文档或数据库
怎么接入？
- 1准备
优先使用 Notion 当前维护的远程 MCP 与 OAuth。
- 2授权
在客户端登记 Notion 远程端点并完成账号授权。
- 3连接
只共享测试页面或必要数据库。
- 4开始使用
搜索一页测试文档，确认返回范围。
安装命令
添加 Notion MCP Server
codex mcp add notion --url https://mcp.notion.com/mcp添加后按客户端提示完成 Notion OAuth，只授权确实要用的页面。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时，把下面整段发给 Codex。它会先核对官方说明和前置条件，遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 Notion MCP Server
请帮我在当前电脑上接入并验证 Notion MCP Server。
官方来源：https://github.com/makenotion/notion-mcp-server
目标接入命令：codex mcp add notion --url https://mcp.notion.com/mcp
请按以下步骤执行：
1. 先阅读官方 README，核对当前推荐接入方式与上述命令。如果官方说明已经变化，先告诉我差异，不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证，也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符，先列出需要我提供的值并停下来，不要自行猜测。
4. 条件满足后执行接入命令，再运行 codex mcp list，确认 Notion MCP Server 已登记，并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接：请用 Notion MCP 在已授权页面中搜索本周会议记录，只读取标题、日期和行动项，不要编辑页面。
6. 不要创建、修改、删除、发送内容，也不要连接生产环境；需要写权限或更高权限时先征求我确认。- 复制完整指令，发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境；遇到 Token、项目 ID、路径或其他占位符时，应停下来向你确认。
- 接入后运行
codex mcp list，再用 Notion MCP Server 的只读首测任务回读结果。
第一次调用示例
登记完成后，新开一个任务，先用下面这句做只读验证，把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请用 Notion MCP 在已授权页面中搜索本周会议记录，只读取标题、日期和行动项，不要编辑页面。怎样算成功
返回的页面确实在已共享范围内，并能核对页面标题、更新时间和链接。
- 先搜索并读取页面，不直接修改。
- 核对页面 ID、父级和最后编辑时间。
- 写入前在测试页生成小段内容。
- 回到 Notion 页面检查区块与数据库字段。
权限与安全
凭证与连接方式
远程 HTTP/OAuth；先只共享测试页面或必要数据库。
- 集成可见范围取决于共享页面与工作区授权
- 写权限会允许改变真实文档或数据库
- 不要使用 README 中关闭 HTTP 认证的高风险选项
