Notion
Cursor を Notion に接続すると、仕様、タスク、コメントをエージェントに委任できます。この連携は Cursor SDK を基盤としているため、すべてのエージェントで Cursor と同じランタイム、ハーネス、モデルが使用されます。
セットアップ、チャット、@メンション、タスクの割り当ては Notion で行います。Cursor は安全なサンドボックス環境の Cloud Agent VM でエージェントを実行するため、他の作業をしている間もバックグラウンドで動作し続けます。
Notion の詳細なドキュメントはこちらを参照してください。
Notion の Cursor はベータ版で、Notion Business またはエンタープライズプランをご利用のすべての Cursor ユーザーが使用できます。
はじめ方
要件
Notion で Cursor を接続する前に、以下を用意してください。
- リポジトリへのアクセスやプルリクエストに使用する、Cursor アカウントに接続済みの GitHub
- セットアップ時に作成する Cursor User API Key
Notion での Cursor の利用料金は既存のアカウントに請求され、追加料金はかかりません。
インストール
- Notion で、サイドバーの「Agents」→「New Agent」→「Cursor」に移動します。
- エージェントの開始方法を選びます。
- デフォルトテンプレートから始める: コード Q&A やバグトリアージなど、一般的なタスク向けのテンプレートを使って、特定のワークフローに合わせて Cursor をカスタマイズできます。
- ゼロから始める: 標準の Cursor ハーネスを使って、独自の指示、トリガー、接続を設定します。
- ダッシュボードで Cursor API キーを作成または取得し、Notion に入力します。
- エンジニアリングタスクデータベースや仕様ページなど、エージェントに必要なページ、データベース、Notion スペースを追加します。
- エージェントを保存して作業を開始します。
これで Cursor が接続され、エージェントはタスクやエージェントチャットからコードを記述し、プルリクエストを作成できます。
権限
- 接続は個人用 API キーに紐づいています。そのため、Cursor へのアクセスと利用状況は、ワークスペース全体ではなく、個人の Cursor アカウントに紐づきます。詳細 →
- リポジトリ、環境、接続は Cursor エージェントのセットアップに基づきます。これらは Cursor ダッシュボードで設定します。
- 各 Cursor エージェントがアクセスできるのは、Notion で共有したコンテンツのみです。権限は Notion でエージェントごとに設定され、実行を開始したユーザーから継承されることはありません。
使用方法
Notionにすでにあるタスクボード、仕様書、その他のコンテキストでCursorを活用できます。
Cursorに権限がないワークスペースで使用しようとすると、アクセスを付与するためのポップアップが表示されます。
エージェントにメンションする
仕様書やページで、コメントを残して Cursor を@メンションします。仕様の実装、プランの改善、質問への回答を依頼できます。
Cursor はコメントで返信します。会話全体を開くには、チャットを表示をクリックします。
ページで初めてエージェントにメンションするときは、求められたらページへのアクセスを承認します。
プロンプト例:
- "この仕様のプランを作成してください。承認を待ってください。"
- "このドキュメントを確認し、不明確な点があれば指摘してください。"
- "これを具体的なタスクのチェックリストにして、それぞれの PR を作成してください。"
タスクを割り当てる
タスクデータベースまたはボードで、タスクをCursorに割り当てます。エージェントは次のことを行います。
- 作業の進行に応じてタスクのステータスを更新
- コメントで進捗を報告
- 作成したページやPRへのリンクを追加
トラブルシューティング
エージェントがページまたはデータベースにアクセスできない
- ページまたはデータベースが、指示で参照���れているだけでなく、Tools & accessに追加されていることを確認します。
- ページへのアクセスが、エージェントが所属していないgroupに制限されていないことを確認します。
- ページがPrivateの場合は、エージェントに直接共有します。
GitHub への接続に失敗する、またはエージェントがプッシュできない
- トークンに Contents: read/write と Pull requests: read/write のスコープがあることを確認します。
- GitHub 組織で SSO または組織の承認が必要か確認します。
- セットアップで指定したデフォルトリポジトリが正しいことを確認します。
- トークンの有効期限が切れている場合は再生成し、再接続します。
エージェントを@メンションしても起動しない
- エージェントがメンションされたトリガーがオンになっていることを確認します。
- ページ本文ではなく、コメント内でエージェントをメンションします。コメントが最も確実です。
- エージェントをメンションしたページへのアクセス権がエージェントにあることを確認します。
よくある質問
請求の仕組み
Notion での Cursor の利用料金は、Cloud Agent の利用料金と同様に、既存の Cursor アカウントを通じて請求されます。追加料金なしで、すべての Cursor ユーザーが利用できます。Notion Business または エンタープライズプランも必要です。
Cursor のアクティビティはどこで確認できますか？
結果は、エージェントを実行した Notion のページまたはタスクに表示されます。チャットセッションは、Notion のエージェントビューまたは Cursor でも確認できます。
Notion から開始した Cursor の実行は、ゼロデータ保持 (ZDR) に対応していますか？
はい。エージェントの実行には、Cursor で設定済みのプライバシー設定が適用されます。