Notion 插件连上以后，很多人会停在下一步。
界面上显示"已连接"，但真正要用时，还是会犹豫：让 Codex 写到哪个页面？它能不能新建内容？写完以后怎么检查？哪些正式资料不能让它碰？
这篇只跑一个小案例。
在 Notion 里准备一个测试页，把 Playwright Java 的两篇官方文档链接交给 Codex，让它整理成入门笔记，再返回写回后的页面链接。
这个流程跑通以后，Notion 插件就不只是"能搜资料"。它可以把一组公开链接整理成学习笔记、工具卡片和下一步行动，后面还能继续使用。
至于 MCP，也就是 Model Context Protocol，可以理解成 AI 工具连接外部系统的一套通道。使用 Codex App 现成插件时，主流程不是安装 MCP，而是插件授权、写回位置和结果验收。本文后面只用一小节说明什么时候才需要关心 MCP。
图片占位：文章首屏结果图｜建议放 Codex App 调用 Notion 后返回的页面链接，加 Notion 新页面截图拼图｜发布前替换为真实脱敏截图
这次演示要做到什么
这次不搭复杂系统。
只做一个最小闭环。
| 步骤 | 要做什么 | 成功标志 |
|---|---|---|
| 1 | 打开 Codex App 的 Notion 插件 | 插件状态显示已连接或可授权 |
| 2 | 登录 Notion 并授权 | 浏览器或 App 内授权完成 |
| 3 | 准备一个 Notion 测试页 | 页面名叫「AI 写回测试区」 |
| 4 | 让 Codex 读取 Playwright 官方文档 | Codex 输出结构化内容 |
| 5 | 让 Codex 写回 Notion | Codex 返回新建页面链接 |
| 6 | 人工打开 Notion 检查 | 页面标题、正文和待确认事项都能看到 |
OAuth，就是网页授权登录。它的意思是通过浏览器确认"允许这个工具访问我的 Notion 工作区"，不是把 Notion 密码写进配置文件。
第一步，先看 App 里有没有 Notion 插件
打开 Codex App，进入插件、Apps 或 Connectors 面板。
不同版本的入口名字可能不完全一样。有的叫插件，有的叫 Apps，有的叫连接器。判断标准很简单：能看到 Notion，并且能点击连接或授权，就从这里开始。
如果已经显示 Notion 已连接，就不用再配置 config.toml，也不用执行 codex mcp add。
config.toml 是 Codex CLI 的配置文件。CLI，就是命令行工具，也就是在终端里输入命令使用的 Codex。本文讲的是 Codex App，所以不把它放在主流程里。
第二步，连接 Notion 并控制授权范围
点击 Notion 插件的连接按钮。
按提示登录 Notion，选择要授权的工作区或页面。
第一次不要无脑全开。
更推荐先授权一个低风险页面，比如下面要用的测试页。等写回流程跑通后，再决定是否扩大到正式知识库。
Notion 插件不是管理员后门。它能看到什么，取决于当前 Notion 账号的权限，以及授权时允许它访问哪些页面或工作区。
第三步，准备一个 Notion 测试页
先在 Notion 里新建一个普通页面，名字叫：
text
AI 写回测试区这个页面只用来测试。里面不用提前写复杂模板。
如果已经有正式知识库，也建议先建测试页。第一次接入要验证权限、格式和写回动作，不要直接动正式资料库、隐私资料库或重要台账。
第四步，给 Codex 一个明确任务
现在回到 Codex App。
这一步别省。
只给一句"帮我写到 Notion"，AI 很容易卡在 3 个问题：写到哪、能不能新建、写完怎么回给人检查。
可以直接复制下面这段提示词。
text
请使用 Notion 插件做一个写回测试。
目标：
读取下面 2 个公开链接，并整理成一篇 Notion 知识库页面。
写入位置：
写到 Notion 页面「AI 写回测试区」下面。
如果找不到这个页面，先告诉我，不要写到其他地方。
权限边界：
可以新建页面。
不要修改已有正式页面。
不要删除任何内容。
资料来源：
1. Playwright Java 安装文档：https://playwright.dev/java/docs/intro
2. Playwright Java 生成测试文档：https://playwright.dev/java/docs/codegen-intro
整理要求：
- 只基于上面 2 个公开链接整理，不要编造其他来源。
- 如果无法读取网页，先告诉我，不要写回 Notion。
- 用适合新手的方式解释 Playwright Java 是什么。
- 写清楚最小上手步骤、关键命令、适合整理成后续任务的事项。
输出要求：
页面标题用「Playwright Java 入门笔记」。
正文包括一句话结论、适合谁、最小上手步骤、关键命令、容易卡住的点、下一步阅读、资料来源链接。
写入完成后返回 Notion 页面链接，并列出你写入了哪些内容。这段提示词真正有用的是 5 个边界。
| 边界 | 为什么要写 |
|---|---|
| 目标 | 让 Codex 知道不是闲聊，是写回测试 |
| 写入位置 | 防止它写到错误页面 |
| 权限边界 | 防止误改正式资料 |
| 资料来源 | 给它明确链接，不让它乱找 |
| 输出要求 | 让它返回链接，方便人工验收 |
成功以后应该看到什么
如果流程跑通，Codex 应该返回类似这样的结果。
text
已写入 Notion。
页面标题：Playwright Java 入门笔记
写入位置：AI 写回测试区
页面链接：https://www.notion.so/xxxx
已写入内容：
1. 一句话结论
2. 适合谁
3. 最小上手步骤
4. 关键命令
5. 容易卡住的点
6. 下一步阅读
7. 资料来源链接然后打开 Notion 页面检查。
页面里应该能看到这几块内容。
text
一句话结论：
Playwright Java 适合用 Java 做浏览器自动化和端到端测试，先用官方最小示例跑通页面打开，再考虑录制测试和接入团队工程。
适合谁：
- 已经在用 Java 或 Maven 的开发、测试同学。
- 想先跑通浏览器自动化，再逐步学习断言、定位器和测试生成的人。
最小上手步骤：
- 在 Maven 项目里加入 Playwright 依赖。
- 写一个 `App.java`，启动浏览器并打开 `https://playwright.dev`。
- 执行 Maven 命令，确认程序能运行。
关键命令：
- `mvn compile exec:java -D exec.mainClass="org.example.App"`
- `mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="codegen demo.playwright.dev/todomvc"`
容易卡住的点：
- 运行环境要满足 Java 和操作系统要求。
- 第一次运行会下载 Playwright 包和浏览器二进制文件，网络不好时可能会慢。
- 生成测试代码不等于测试已经设计好了，还要人工整理断言和用例边界。
下一步阅读：
- 安装文档
- 生成测试文档
- 运行和调试测试这就算最小闭环跑通了。
不是因为这段内容多复杂，而是因为它证明了三件事：Codex App 能读取公开资料，能使用 Notion 插件，能把整理后的结果写回目标页面。
如果没有写进去，先查这几个地方
第一，看 Notion 插件是否已连接。
如果插件仍然显示未连接，先重新登录和授权。这里不是提示词问题，而是 Codex App 还没有拿到 Notion 访问许可。
第二，看授权范围是不是太小。
如果只授权了某个页面，Codex 就不一定能访问其他页面。第一次测试最好把「AI 写回测试区」明确授权给插件。
第三，看目标页面名称是否准确。
如果提示词里写的是「AI 写回测试区」，Notion 里实际叫「AI写回测试区」，中间少了空格，Codex 可能找不到。第一次测试也可以直接给页面链接。
第四，看当前 Notion 账号有没有权限。
当前账号看不到的页面，Codex 也不应该能看到。
第五，看要做的是不是图片或文件上传。
Notion 官方 MCP 文档说明，Notion MCP 目前不支持图片和文件上传。插件能力以当前 Codex App 和 Notion 授权页面显示为准。写文字页面、任务、报告通常更适合；自动上传截图、PDF 这类动作要单独确认。
那 MCP 到底什么时候需要管
如果使用 Codex App，并且 App 里已经有 Notion 插件，普通用户不需要手动安装 MCP。
MCP 只在下面这些情况才需要关心。
| 场景 | 是否需要手动配置 MCP |
|---|---|
| Codex App 里已经有 Notion 插件 | 不需要 |
| 使用 Codex CLI 终端版 | 可能需要 |
| 团队要接自建工具或内网系统 | 可能需要 |
| 想把同一套工具配置复用到多个项目 | 可能需要 |
| 只是想让 Codex App 读写 Notion | 不需要 |
所以本文的推荐路径是：有 App 插件就用 App 插件。不要为了"看起来更技术"再绕到 CLI 配置。
正式使用时，不要一上来全自动
真正用在长期知识库里，建议按这个顺序来。
先只读。
text
请使用 Notion 插件搜索和「某个主题」相关的 5 篇页面。
只读，不要修改。
返回标题、链接和一句话摘要。再整理。
text
请把上面的资料整理成一份知识库草稿。
先在聊天里给我看，不要写回 Notion。最后写回。
text
请把确认后的草稿写入 Notion 页面「某某知识库」下面。
标题用「某某学习笔记」。
写完返回页面链接和修改摘要。这个顺序看起来慢一点，但更稳。
因为读、整理、写回是三种不同风险的动作。
搜索和摘要属于低风险。创建测试页面属于中低风险。更新正式资料、批量改数据库、删除页面、覆盖正文，都属于高风险。
高风险动作必须先确认。
可以直接做和必须确认的事
| 动作 | 建议 |
|---|---|
| 搜索 Notion 页面 | 可以直接做 |
| 读取已授权页面 | 可以直接做 |
| 整理摘要、清单、学习结论 | 可以直接做 |
| 新建测试页面 | 可以直接做，但要限定测试区 |
| 写入正式知识库 | 先给草稿，再确认写入 |
| 修改任务状态 | 先列出将修改哪些任务 |
| 批量更新数据库 | 先给影响范围和回滚口径 |
| 删除页面、覆盖正文 | 必须人工确认 |
| 处理隐私资料、密钥、合同、账号 | 默认不要交给 AI 自动处理 |
这不是不信 AI。
这是把工作分层。
低风险动作让 AI 快速做。高风险动作保留人工确认。这样 Notion 才不会变成另一个被 AI 搞乱的资料堆。
这套流程适合哪些内容
最适合的是这几类。
| 场景 | 写回成什么 |
|---|---|
| 公开文章摘录 | 知识卡片、参考链接、待验证问题 |
| 读书笔记 | 读书卡片、重点句子、行动清单 |
| 课程学习 | 章节笔记、术语解释、练习清单 |
| 工具试用 | 安装记录、踩坑清单、复测步骤 |
| 个人复盘 | 复盘记录、下一步动作、注意事项 |
如果资料一直停在聊天窗口里，但最后没有进入知识库，那这些内容很快就会丢。
Codex 接 Notion 的价值，就是把"这次聊明白了"变成"下次还能找到、还能继续用"。
最小验收清单
照着本文做完以后，只看 6 件事。
| 检查项 | 通过标准 |
|---|---|
| 插件 | Codex App 里 Notion 已连接 |
| 授权 | Notion 授权范围包含测试页 |
| 测试页 | Notion 里有「AI 写回测试区」 |
| 写回 | Codex 返回了 Notion 页面链接 |
| 内容 | 页面里有标题、结论、结果、问题和下一步 |
| 边界 | 没有修改正式资料，没有写入敏感信息 |
先把这个小闭环跑通，再考虑接正式知识库。
如果这个闭环都没跑通，不要急着写复杂提示词。先回到插件连接、授权范围、页面权限这三个地方查。
参考资料
- OpenAI Codex App 介绍：https://openai.com/index/introducing-the-codex-app/
- OpenAI Codex 产品页：https://openai.com/codex/
- Notion MCP 介绍：https://developers.notion.com/guides/mcp/mcp
- Notion MCP 连接指南：https://developers.notion.com/docs/get-started-with-mcp
- Notion MCP 安全建议：https://developers.notion.com/guides/mcp/mcp-security-best-practices
- Notion MCP 支持工具说明：https://developers.notion.com/guides/mcp/mcp-supported-tools
- Playwright Java 安装文档：https://playwright.dev/java/docs/intro
- Playwright Java 生成测试文档：https://playwright.dev/java/docs/codegen-intro