Skip to main content

Command Palette

Search for a command to run...

Интеграции

Notion

Подключите Cursor к Notion, чтобы поручать Agent-ам работу со спецификациями, задачами и комментариями. Поскольку интеграция построена на Cursor SDK, каждый Agent использует те же среду выполнения, обвязку и модели, что и Cursor.

Настройка, чат, @упоминания и назначение задач выполняются в Notion. Cursor запускает Agent-а в защищённой изолированной VM Cloud Agent, поэтому он продолжает работать в фоновом режиме, пока вы занимаетесь другими задачами.

Полная документация Notion доступна здесь.

Быстрый старт

Требования

Пре��де чем подключать Cursor к Notion, убедитесь, что у вас есть:

  • GitHub, подключённый к аккаунту Cursor, для доступа к репозиториям и работы с pull request
  • Пользовательский API-ключ Cursor, созданный при настройке

Установка

  1. В Notion перейдите в раздел Agents на боковой панели → New Agent → Cursor.
  2. Выберите отправную точку для Agent-а:
  • Начните со стандартного шаблона: шаблоны для распространённых задач (например, Code Q&A и Bug Triage) помогут настроить Cursor под конкретные рабочие процессы.
    • Начните с нуля: настройте собственные инструкции, триггеры и подключения с помощью стандартной обвязки Cursor.
  1. Создайте или скопируйте свой API-ключ Cursor на дашборде и введите его в Notion.
  2. Добавьте нужные Agent-у страницы, базы данных и пространства Notion, например базу данных инженерных задач и страницы спецификаций.
  3. Сохраните Agent-а и приступайте к работе.

Cursor подключён, и ваш Agent может писать код и открывать pull request из задач или чата с Agent-ом.

Права доступа

  1. Подключение привязано к вашему личному API-ключу. Это означает, что доступ к Cursor и действия в нём связаны с вашим аккаунтом Cursor, а не со всей рабочей областью. Подробнее →
  2. Репозитории, инфраструктура и подключения берутся из настроек Cursor Agent. Настройте их в дашборде Cursor.
  3. Каждый Cursor Agent может получать доступ только к контенту, которым вы поделились в Notion. Права доступа задаются для каждого агента в Notion и не наследуются от пользователя, запускающего выполнение.

Как использовать

Подключите Cursor к доскам задач, спецификациям и другому контексту, который уже есть в Notion.

Упомяните Agent-а

Начните со спецификации или страницы. Оставьте комментарий и упомяните Cursor через @. Попросите его реализовать спецификацию, доработать план или ответить на вопрос.

Cursor ответит в комментариях. Нажмите Просмотреть чат, чтобы открыть полный диалог.

При первом упоминании Agent-а на странице подтвердите доступ к странице по запросу.

Примеры промптов:

  • "Составь план для этой спецификации. Дождись одобрения."
  • "Проведи ревью этого документа и отметь всё неясное."
  • "Преврати это в чек-лист конкретных задач, а затем открой PR для каждой."

Назначьте задачу

В базе задач или на доске назначьте задачу Cursor. Agent будет:

  • Обновлять статус задачи по ходу работы
  • Публиковать комментарии о ходе выполнения
  • Добавлять ссылки на созданные страницы или PR

Устранение неполадок

Agent не может получить доступ к странице или базе данных

  • Убедитесь, что страница или база данных указана в разделе Инструменты и доступ, а не только в инструкциях.
  • Убедитесь, что доступ к странице не ограничен группой, в которую Agent не входит.
  • Если страница приватная, предоставьте Agent доступ к ней напрямую.

Не удаётся подключиться к GitHub или Agent не может выполнить push

  • Убедитесь, что у токена есть области Contents: read/write и Pull requests: read/write.
  • Проверьте, требуется ли SSO или одобрение организации в вашей организации GitHub.
  • Убедитесь, что репозиторий по умолчанию в настройках указан верно.
  • Если срок действия токена истёк, создайте новый токен и подключитесь повторно.

Agent не сработал, когда я упомянул его через @

  • Убедитесь, что триггер упоминание Agent включён.
  • Упомяните Agent в комментарии, а не в основном тексте страницы. Комментарии надёжнее.
  • Убедитесь, что у Agent есть доступ к странице, на которой вы его упомянули.

Часто задаваемые вопросы

Как работает оплата?

Использование Cursor в Notion оплачивается через ваш аккаунт Cursor — так же, как использование Cloud Agent. Эта функция доступна всем пользователям Cursor без дополнительной платы. Вам также потребуется тариф Notion Business или Enterprise.

Где посмотреть активность Cursor?

Результаты отображаются в Notion на странице или в задаче, где работал Agent. Сессии чата также можно найти в представлении Agent в Notion или в Cursor.

Соблюдается ли нулевое хранение данных (ZDR) при запусках Cursor из Notion?

Да. Запуски Agent учитывают ваши текущие настройки конфиденциальности в Cursor.