Notion 任务与页面集成
在 Notion 中创建 Cursor Agent,按 Agent 共享页面并使用个人 Cursor 身份执行。
This page has not been translated into English yet. The original Chinese version is shown below.
Notion 集成处于 beta,面向具备 Notion Business 或 Enterprise 的 Cursor 用户。它基于 Cursor SDK,任务在 Cloud Agent VM 执行,Notion 负责配置、聊天、提及和任务分配。
创建 Agent
- 在 Notion 侧栏 Agents > New Agent > Cursor 新建。
- 选择 Code Q&A、Bug Triage 等模板,或从空白配置。
- 在 Cursor dashboard 创建或取用个人 User API Key,填入 Notion。
- 添加需要访问的 pages、databases 和 spaces,保存。
- 确认 Cursor 已连接 GitHub,并配置仓库和运行环境。
活动关联个人 API key 所属账号,不自动成为整个 Notion workspace 的身份。仓库、环境和外部连接来自 Cursor 设置。
页面与任务
在页面评论中 @mention Agent,可请求实现规格、制定计划或评审文档。首次提及时按提示授予页面访问;通过 View chat 查看完整会话。也可在任务数据库/board 把任务分配给 Cursor,它会更新状态、发表评论并链接产物或 PR。
页面权限按 Agent 配置,不继承每个发起人的全部权限。只在指令中引用一个页面不会自动授予访问。
排障
无法访问内容时检查 Tools & access 中是否已列出页面/数据库,是否受限于 Agent 未加入的 group,私有页面是否直接共享。提及未触发时检查 agent mentioned trigger,并优先在评论而非页面正文提及。
无法 push 时检查 GitHub 连接、组织 SSO/审批、默认仓库和 token 有效性。官方对 GitHub token 的 Contents/PR read-write 要求属于 GitHub 访问,不应混作 Cursor API key 的 scope 设置。
计费与隐私
官方“no extra cost”指集成本身没有额外收费,运行仍按现有 Cursor 账号的 Cloud Agent 用量计费,并需要 Notion Business/Enterprise。任务遵守已有 Cursor 隐私设置,不能将此表述推断成运行时完全不存储数据;参照云端隐私与保留。