AI 软件接入 Notion MCP 配置记录：Codex / CatPawAI / Trae

type

Post

status

Published

date

May 15, 2026

slug

notion-mcp-codex-catpawai-trae

summary

记录 Codex、CatPawAI、Trae 等 AI 工具接入 Notion MCP 的完整配置过程，包括官方 MCP Server 和 suekou 非官方 MCP Server 两种方案的对比与配置方法。

背景

为了让 AI 软件可以读取、整理和更新 Notion 文档，我尝试给 Codex、CatPawAI、Trae 等工具接入 Notion MCP。

MCP 的作用是让 AI 客户端通过统一协议调用外部工具。接入 Notion MCP 后，AI 可以在授权范围内搜索页面、读取数据库、整理内容、创建文档和更新任务。

当前已验证方案

目前在 CatPawAI 中已成功接入两种 Notion MCP Server：

Notion 官方 MCP Server

suekou 维护的非官方 Notion MCP Server

两种方式都可以使用，但定位略有不同。

方案一：Notion 官方 MCP Server

官方仓库：

https://github.com/makenotion/notion-mcp-server

官方远程 MCP 地址：

https://mcp.notion.com/mcp

npm 包：

`@notionhq/notion-mcp-server`

本地全局安装命令：

Windows 本地命令路径示例：

`D:\dev\nodejs\node_global\notion-mcp-server.cmd`

CatPawAI JSON 配置示例：

特点：

官方维护，稳定性更好

适合标准 Notion API 读写

默认 stdio 方式适合本地 AI 客户端

也支持 HTTP transport

方案二：非官方 suekou MCP Server

仓库地址：

https://github.com/suekou/mcp-notion-server

npm 包：

`@suekou/mcp-notion-server`

本地全局安装命令：

Windows 本地命令路径示例：

`D:\dev\nodejs\node_global\mcp-notion-server.cmd`

CatPawAI JSON 配置示例：

特点：

更偏向 AI 文档编辑体验

适合读取页面、整理内容、追加 Markdown、批量处理文档

不是 Notion 官方维护

需要 Node.js 22 或更高版本

Node.js 环境

当前使用 nvm 管理 Node.js 版本。

推荐版本：

Node.js 22 LTS

常用命令：

如果 npm 下载失败，可以切换国内镜像：

Windows 全局 npm 路径

本机 npm 全局安装目录示例：

`D:\dev\nodejs\node_global`

如果命令行提示找不到 notion-mcp-server，需要把这个目录加入系统 Path。

也可以在 CatPawAI 配置中直接使用绝对路径，这种方式最稳定。

Notion Token 注意事项

Notion Integration Token 需要从 Notion integrations 页面创建：

https://www.notion.so/profile/integrations

创建后，需要把目标页面或数据库授权给该 Integration。

如果页面没有授权，MCP Server 即使连接成功，也无法读取 Notion 内容。

重要安全提醒：

Token 不要发到聊天、截图或公开文档中。如果曾经泄露，需要立刻重新生成 token，并废弃旧 token。

建议增加的使用规则

为了避免 AI 误改 Notion 内容，建议在 Notion 中新增一个页面，命名为：

AI 操作规则

建议规则：

AI 默认只读取，不修改

批量修改前必须先列出 dry-run 清单

不允许删除页面或数据库

修改重要页面前必须先总结当前内容

每次修改后追加一段变更记录

项目相关文档需要明确项目名，例如 fjfy、spike 等

token、密码、服务器地址等敏感信息不要写入公开页面

常用提示词

只读总结：

请搜索 Notion 中标题包含"xxx"的页面，只总结内容，不要修改。

创建文章：

请在"spike博客"下面新增一篇文章，标题为"xxx"，内容如下。

批量修改前预览：

请先 dry-run，列出你准备修改的页面、字段和值。等我确认"执行"后再真正修改。

任务整理：

请读取任务库中状态为"进行中"的任务，按优先级生成今日待办，不要修改原页面。

当前结论

如果 AI 客户端支持远程 MCP，优先尝试官方远程地址：