为什么需要 Notion MCP
知识管理的痛点：
你：帮我把刚才会议纪要整理进 Notion
传统流程：
1. AI 生成整理好的纪要
2. 你手动复制
3. 切到 Notion
4. 建页面、贴内容、设属性
5. 选好父页面、分类
→ 5 步，4 次手动操作
Notion MCP：
你：把会议纪要整理进 Notion 的"会议记录"库
AI：
1. 搜索定位目标库
2. 自动建页面
3. 写入整理好的内容
4. 设置日期、参会人等属性
→ 1 步，0 次切换
Notion MCP 把"AI 生成 + Notion 存储"连成自动流水线。
核心能力
| 工具 | 说明 |
|---|---|
| 搜索 | 全库关键词/语义搜索 |
| 获取页面 | 读取页面内容、属性 |
| 创建页面 | 在指定父下建页面 |
| 更新页面 | 改内容、属性、块 |
| 列出数据库 | 查所有数据库 |
| 查询数据库 | 按属性筛选数据库条目 |
安装与配置
Step 1：创建 Notion 集成
- 访问 https://www.notion.so/my-integrations
- 新建集成，取名（如
mcp-bot） - 保存
Internal Integration Secret（secret_xxx）
Step 2：给集成授权页面
在 Notion 里：
目标页面 → 右上角 ... → Connections → 添加 mcp-bot
→ 该页面及子页面可被 MCP 访问
注意：集成默认看不到任何页面，需手动授权。
Step 3：各客户端配置
Claude Desktop
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-notion"],
"env": {
"NOTION_API_KEY": "secret_xxxxxxxxxxxx",
"OPENAPI_MCP_HEADERS": {
"Authorization": "Bearer secret_xxxxxxxxxxxx",
"Notion-Version": "2022-06-28"
}
}
}
}
}
Cursor / VS Code Continue
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-notion"],
"env": {
"NOTION_API_KEY": "secret_xxxxxxxxxxxx"
}
}
}
}
Step 4：验证
列出我能访问的数据库
AI 返回授权的数据库清单，确认配置成功。
五个实战场景
场景 1：知识检索
你：上次讨论 RAG 的纪要在哪？帮我找要点
AI：
1. 搜索 "RAG"
2. 命中 3 个页面
3. 读最新那条
4. 提炼要点：
- RAG = 检索 + 生成
- 用 [Embedding](/glossary/2026-08-15-embedding) 做语义检索
- 适合知识库问答
场景 2：会议纪要自动入库
配合录音转文字 + AI 整理：
你：这是会议录音转写，整理成纪要存进"会议记录"库
[录音转写文本...]
AI：
1. 提炼：主题、时间、参会人、决议、待办
2. 在"会议记录"库建页面
3. 标题：[日期] 主题
4. 属性：date=今天, attendees=张三;李四
5. 内容：决议 + 待办清单
6. 待办同步到 Tasks 库
场景 3：需求文档转页面
你：把这份需求文档结构化进 Notion
[需求文本...]
AI：
1. 拆解：模块、功能点、验收标准
2. 在"需求"库建页面
3. 用 toggle 块组织模块
4. 每个功能点建子页面
5. 验收标准做成 checkbox
场景 4：批量整理
你：把"待整理"库里 20 条笔记按主题归档
AI：
1. 查询"待整理"库所有条目
2. 读每条内容，判断主题
3. 按 5 个主题分组
4. 移到对应主题库
5. 删除"待整理"原条目
→ 20 条 30 秒归档完毕
场景 5：知识图谱生成
你：把我 Notion 里关于 AI 的笔记整理成知识图谱
AI：
1. 搜索 "AI" 相关 30 个页面
2. 读内容，提取概念关系
3. 输出关系：
[RAG] → 用 → [Embedding]
[RAG] → 是 → [LLM应用]
[Transformer] → 基础 → [Embedding]
4. 生成 Mermaid 图
5. 存为"AI 知识图谱"页面
权限管控要点
1. 只读优先
日常检索用只读集成
写操作用独立集成 + 二次确认
创建两个集成：
mcp-reader：只勾选 Read 能力mcp-writer：勾选 Read + Write，只在写场景用
2. 授权范围
✗ 给集成授权整个 workspace → 风险大
✓ 只授权需要的库/页面
例：只授"会议记录""需求""待办"三个库
3. 敏感内容隔离
✗ 财务/合同页面也授权给 MCP → AI 可能输出敏感信息
✓ 敏感页面单独建，不给 MCP 授权
4. 写操作 system prompt 规则
你连的是生产 Notion。规则：
1. 创建页面前先确认标题与父页面
2. 不删除已有页面（只标记"待清理"）
3. 修改共享页面前提示用户
4. 大批量操作（>10 条）需用户确认
注意事项
1. API 限流
Notion API 限速约 3 请求/秒。批量操作加 sleep：
import time
for page in pages:
notion.create_page(page)
time.sleep(0.4) # 避免限流
2. 块结构复杂
Notion 内容是"块"数组，非纯文本。AI 写内容时注意块类型：
段落：paragraph
标题：heading_1/2/3
列表：bulleted_list_item
代码：code
折叠：toggle
3. 属性类型
数据库属性有类型，AI 操作时要匹配：
text: "字符串"
select: "选项名"（不是 id）
date: {"start": "2026-08-17"}
people: [{"id": "user_id"}]
checkbox: true/false
4. 搜索局限
Notion 搜索是关键词匹配，非语义
→ 换个同义词可能搜不到
→ 配合 [Postgres MCP](/mcp/2026-08-16-postgres-mcp) 把内容同步到 DB 做语义检索
5. 版本兼容
Notion API 版本迭代快
NOTION_API_KEY 配的版本（2022-06-28）要与 server 兼容
→ 升级 server 时检查 API 版本
与其他 MCP 的协作
| 组合 | 场景 |
|---|---|
| Notion + Filesystem | 本地文档批量导入 Notion |
| Notion + Slack | Slack 消息自动存档到 Notion |
| Notion + Postgres | Notion 数据同步到 DB 做分析 |
| Notion + GitLab | 代码文档双向同步 |
与直接用 Notion 的区别
| 维度 | Notion MCP | 手动用 Notion |
|---|---|---|
| 检索速度 | 快（语义 + 自动读） | 慢（翻页找） |
| 批量操作 | 强 | 弱 |
| 入门门槛 | 自然语言 | 学 Notion 操作 |
| 适合场景 | 整理、归档、检索 | 精细编辑、排版 |
| 上线建议 | 整理用 MCP，精排手动 |
小结
Notion MCP 把知识库从"需要手动翻找、手动整理"变成 AI 的原生能力。
记住一个原则：只读集成日常用，写操作用独立集成 + 二次确认。配合 Filesystem MCP 导入、Slack MCP 归档、Postgres MCP 分析，你能搭一个从信息收集到知识沉淀的全自动知识助手。