篇只跑一个小案例。在 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 写回 NotionCodex 返回新建页面链接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 里新建一个普通页面名字叫AI 写回测试区这个页面只用来测试。里面不用提前写复杂模板。如果已经有正式知识库也建议先建测试页。第一次接入要验证权限、格式和写回动作不要直接动正式资料库、隐私资料库或重要台账。第四步给 Codex 一个明确任务现在回到 Codex App。这一步别省。只给一句“帮我写到 Notion”AI 很容易卡在 3 个问题写到哪、能不能新建、写完怎么回给人检查。可以直接复制下面这段提示词。请使用 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 应该返回类似这样的结果。已写入 Notion。 页面标题Playwright Java 入门笔记 写入位置AI 写回测试区 页面链接https://www.notion.so/xxxx 已写入内容 1. 一句话结论 2. 适合谁 3. 最小上手步骤 4. 关键命令 5. 容易卡住的点 6. 下一步阅读 7. 资料来源链接然后打开 Notion 页面检查。页面里应该能看到这几块内容。一句话结论 Playwright Java 适合用 Java 做浏览器自动化和端到端测试先用官方最小示例跑通页面打开再考虑录制测试和接入团队工程。 适合谁 - 已经在用 Java 或 Maven 的开发、测试同学。 - 想先跑通浏览器自动化再逐步学习断言、定位器和测试生成的人。 最小上手步骤 - 在 Maven 项目里加入 Playwright 依赖。 - 写一个 App.java启动浏览器并打开 https://playwright.dev。 - 执行 Maven 命令确认程序能运行。 关键命令 - mvn compile exec:java -D exec.mainClassorg.example.App - mvn exec:java -e -D exec.mainClasscom.microsoft.playwright.CLI -D exec.argscodegen 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 只在下面这些情况才需要关心。场景是否需要手动配置 MCPCodex App 里已经有 Notion 插件不需要使用 Codex CLI 终端版可能需要团队要接自建工具或内网系统可能需要想把同一套工具配置复用到多个项目可能需要只是想让 Codex App 读写 Notion不需要所以本文的推荐路径是有 App 插件就用 App 插件。不要为了“看起来更技术”再绕到 CLI 配置。正式使用时不要一上来全自动真正用在长期知识库里建议按这个顺序来。先只读。请使用 Notion 插件搜索和「某个主题」相关的 5 篇页面。 只读不要修改。 返回标题、链接和一句话摘要。再整理。请把上面的资料整理成一份知识库草稿。 先在聊天里给我看不要写回 Notion。最后写回。请把确认后的草稿写入 Notion 页面「某某知识库」下面。 标题用「某某学习笔记」。 写完返回页面链接和修改摘要。这个顺序看起来慢一点但更稳。因为读、整理、写回是三种不同风险的动作。搜索和摘要属于低风险。创建测试页面属于中低风险。更新正式资料、批量改数据库、删除页面、覆盖正文都属于高风险。高风险动作必须先确认。可以直接做和必须确认的事动作建议搜索 Notion 页面可以直接做读取已授权页面可以直接做整理摘要、清单、学习结论可以直接做新建测试页面可以直接做但要限定测试区写入正式知识库先给草稿再确认写入修改任务状态先列出将修改哪些任务批量更新数据库先给影响范围和回滚口径删除页面、覆盖正文必须人工确认处理隐私资料、密钥、合同、账号默认不要交给 AI 自动处理这不是不信 AI。这是把工作分层。低风险动作让 AI 快速做。高风险动作保留人工确认。这样 Notion 才不会变成另一个被 AI 搞乱的资料堆。这套流程适合哪些内容最适合的是这几类。场景写回成什么公开文章摘录知识卡片、参考链接、待验证问题读书笔记读书卡片、重点句子、行动清单课程学习章节笔记、术语解释、练习清单工具试用安装记录、踩坑清单、复测步骤个人复盘复盘记录、下一步动作、注意事项
