將 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 中現有的隱私設置。
