Agent Skills
返回列表
🤖

Notion MCP 服务器

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/notion-mcp-server。

技能介绍

问题：Notion 的内容被困在应用里

Notion 的工作区由 block 构成文档与数据库。对工程师来说，直接在里面处理内容并不容易：数据导出受限，走 API 又要自己处理认证、分页和 block 结构转换。当 AI Agent 需要读取需求文档、查询任务数据库或更新页面时，没有标准化的接入方式，每个项目都得重写一遍胶水代码。

它是怎么工作的

这个技能把 Notion 官方 API（基于 @notionhq/client）封装成 MCP 工具集，让支持 MCP 的 Agent（如 Claude）可以直接调用 Notion 的操作。流程大致是：

  • Agent 发起工具调用，服务器把 MCP 请求映射为对 Notion API 的具体调用
  • 认证与网络细节由服务器统一处理，Agent 只面对语义化的工具名和参数
  • 返回结果转换回 Agent 可读的结构，供后续推理使用

能力上覆盖 Notion API 的核心面：搜索工作区、读取页面与 block、查询数据库、创建或更新内容。Agent 因此能在对话里完成「查上周的需求变更并更新对应页面」这类任务。

边界与注意点

  • 运行环境需要 Node.js 与 npm，且必须提供有效的 Notion API token 及工作区授权
  • Notion API 对写入有速率限制，批量操作要做好节流
  • block 层级深，工具返回的上下文可能很长，需要在 prompt 层做裁剪
  • 该技能说明较简略，具体工具清单以源码和 Notion API 文档为准

使用场景

  • 需求评审前，工程师用 Agent 搜索 Notion 工作区，按关键词调出上季度需求文档并读取全文
  • 团队用 Notion 数据库跟踪任务，工程师让 Agent 查询进行中的条目并批量更新状态字段
  • 文档负责人离开时，接手人通过 Agent 读取 Notion 页面树，梳理项目文档结构并补全内容
  • 发布前，工程师让 Agent 检索 Notion 变更记录，定位本周更新过的页面并补充发布说明

适合人员

  • 维护多份需求文档的工程师，需要在评审前快速检索并汇总 Notion 页面内容
  • 用 Notion 数据库管理迭代任务的技术负责人，想把查询和更新操作交给 Agent 处理
  • 负责知识库整理的开发运营，需要定期扫描 Notion 页面并同步结构变更
  • 为团队编写发布文档的工程师，需要按 Notion 更新记录生成版本说明