将 Cursor 连接到 Notion，以便将规格文档、任务和评论交给 agents 处理。该集成基于 Cursor SDK 构建，因此每个 agents 都使用驱动 Cursor 的同一运行时、框架和模型。
设置、聊天、@提及和任务分配均在 Notion 中完成。Cursor 会在安全的沙盒 Cloud Agent VM 中运行 agents，因此您处理其他工作时，它仍会在后台继续运行。
在此处查看 Notion 的完整文档。
Notion 中的 Cursor 目前为 beta 版，所有使用 Notion Business 或企业版方案的 Cursor 用户均可使用。
快速入门¶
要求¶
在 Notion 中连接 Cursor 前，请确保你已具备：
- 已关联到 Cursor 账户的 GitHub，用于访问代码仓库和创建 PR
- 在设置过程中创建的 Cursor User API Key
Notion 中的 Cursor 用量将通过你现有的账户结算，无需额外付费。
安装¶
- 在 Notion 中，依次选择侧边栏中的 Agents → New Agent → Cursor。
- 为智能体选择起点：
- 使用默认模板：适用于常见任务 (如代码问答和缺陷分流) 的模板可帮助你针对特定工作流自定义 Cursor。
- 从零开始：使用标准 Cursor 框架设置自己的说明、触发器和连接。
- 在仪表盘中创建或获取 Cursor API 密钥，然后将其输入 Notion。
- 添加智能体所需的页面、数据库和 Notion 空间，例如工程任务数据库和规格页面。
- 保存智能体并开始使用。
Cursor 现已连接，智能体可以根据任务或通过智能体聊天编写代码并创建 PR。
权限¶
- 此连接绑定到您的个人 API 密钥。这意味着 Cursor 的访问权限和活动均关联至您的个人 Cursor 账户，而非整个工作区。了解更多 →
- 仓库、环境和连接来自您的 Cursor 智能体设置。请在 Cursor 仪表盘中配置。
- 每个 Cursor 智能体只能访问您在 Notion 中共享的内容。权限需在 Notion 中针对每个智能体单独设置，不会继承启动运行者的权限。
使用方法¶
将 Cursor 用于 Notion 中已有的任务看板、规格文档及其他上下文。
如果尝试在 Cursor 没有权限的工作区中使用它，请设置弹窗以授予访问权限。
提及智能体¶
从规格文档或页面开始。在评论中 @ 提及 Cursor，让它实现规格、完善方案或回答问题。
Cursor 会在评论中回复。点击 查看聊天，打开完整对话。
首次在页面中提及智能体时，请在提示出现后批准页面访问权限。
提示词示例：
- “为这份规格制定方案，等待批准后再继续。”
- “评审这份文档，标记所有不清晰之处。”
- “将其转为具体任务清单，然后为每项任务创建 PR。”
分配任务¶
在任务数据库或看板中，将任务分配给 Cursor。智能体将：
- 在执行过程中更新任务状态
- 通过评论发布进度
- 链接到其创建的所有页面或 PR
疑难排查¶
智能体无法访问页面或数据库¶
- 确认页面或数据库已列在工具和访问权限中，而不只是出现在指令中。
- 确认该页面未被限制为仅供智能体不所属的群组访问。
- 如果页面是私有的，请直接将其共享给智能体。
GitHub 连接失败或智能体无法推送¶
- 确认令牌具有 Contents: read/write 和 Pull requests: read/write 权限。
- 检查你的 GitHub 组织是否需要 SSO 或组织批准。
- 确认设置中的默认代码仓库是否正确。
- 如果令牌已过期，请重新生成令牌，然后重新连接。
我 @提及智能体时，它没有被触发¶
- 确认已开启 智能体被提及 触发器。
- 请在评论中提及智能体，而非页面正文中。评论最可靠。
- 确认智能体有权访问你提及它的页面。
常见问题¶
如何计费？¶
Notion 中的 Cursor 用量将通过您现有的 Cursor 账户计费，与 Cloud Agent 用量的计费方式相同。所有 Cursor 用户均可免费使用，无需额外付费。您还需要 Notion Business 或企业版方案。
在哪里可以查看 Cursor 活动？¶
结果会显示在智能体运行所在的 Notion 页面或任务中。你还可以在 Notion 的智能体视图或 Cursor 中查看聊天会话。
从 Notion 发起的 Cursor 运行是否遵循零数据保留 (ZDR)？¶
是。智能体运行遵循您在 Cursor 中现有的隐私设置。
