Коннектор Notion — это интеграция, которая даёт ИИ-агенту СуперИнтеллекта доступ к вашему рабочему пространству Notion: он ищет по вики, читает страницы и базы данных, создаёт и обновляет записи, оставляет комментарии — всё обычными фразами в чате. Токен вы приносите свой, вставляете один раз в разделе «Интеграции» у ассистента, а платформа хранит его на своей стороне и подставляет при вызовах. В этом гайде разберём, где взять токен интеграции Notion, как подключить его к ИИ-агенту, как настроить права и что именно агент сможет делать.
Зачем подключать Notion к ИИ-агенту
Notion — это база знаний, документы и таблицы-базы данных в одном пространстве. Когда к нему подключён ИИ-агент, вам не нужно переключаться между вкладками и вручную искать нужную страницу: агент делает это сам внутри чата СуперИнтеллекта. Запрос «найди в вики регламент по возвратам и перескажи ключевое» или «добавь в базу задач новую строку со статусом В работе» выполняется прямо в диалоге.
- Поиск по всему рабочему пространству без ручного перелистывания страниц.
- Чтение страниц и содержимого баз данных с фильтрами — агент сам достаёт нужные записи.
- Создание и обновление страниц: заметки, карточки задач, черновики документов.
- Работа с комментариями и списком участников пространства.
- Единое окно: Notion, чат и остальные интеграции агента в одном интерфейсе.
Что ИИ-агент умеет с Notion: инструменты и права
У коннектора Notion 12 инструментов — от поиска и чтения до создания страниц и комментариев. Права выдаются по принципу «минимально необходимого»: по умолчанию включено только чтение (read), а запись (write) и архивирование владелец включает осознанно. В таблице ниже — что делает каждый инструмент и к какому уровню прав он относится.
| Инструмент | Что делает | Права |
|---|---|---|
| notion_search | Поиск страниц и баз по всему рабочему пространству | read |
| notion_get_page | Читает свойства страницы | read |
| notion_get_page_content | Читает контент страницы как Markdown | read |
| notion_get_database | Возвращает метаданные базы данных | read |
| notion_query_database | Запрос к базе с фильтрами и сортировкой | read |
| notion_get_comments | Читает комментарии к странице | read |
| notion_list_users | Список участников рабочего пространства | read |
| notion_create_page | Создаёт новую страницу | write |
| notion_update_page | Обновляет свойства страницы | write |
| notion_append_blocks | Дозаписывает блоки в конец страницы | write |
| notion_create_comment | Добавляет комментарий к странице | write |
| notion_archive_page | Архивирует страницу (вместо удаления) | delete |
Шаг 1. Где взять токен интеграции Notion
Notion работает через internal-интеграцию: вы создаёте её в своём аккаунте, получаете Internal Integration Token и расшариваете на интеграцию те страницы и базы, к которым хотите дать доступ агенту. Без явного расшаривания интеграция не видит ничего — это ключевой механизм безопасности Notion.
- Откройте notion.so/my-integrations и войдите в свой аккаунт Notion.
- Нажмите «New integration», задайте название (например, «СуперИнтеллект-агент») и выберите нужное рабочее пространство.
- Сохраните интеграцию и скопируйте её Internal Integration Token — это и есть токен, который вы вставите на платформе.
- Откройте нужную страницу или базу в Notion, нажмите ⋯ в правом верхнем углу → «Add connections» (Связи) и выберите свою интеграцию.
- Повторите расшаривание для всех страниц и баз, с которыми должен работать агент — доступ наследуется вложенными страницами.
Шаг 2. Подключение Notion в разделе «Интеграции»
Дальше токен вставляется в СуперИнтеллекте — один раз. Он хранится на стороне платформы, а коннектор привязывается к конкретному ассистенту.
- Откройте настройки нужного ИИ-ассистента и перейдите в раздел «Интеграции» — это каталог коннекторов.
- Найдите в каталоге Notion и выберите его.
- Вставьте Internal Integration Token из Шага 1 в поле токена и сохраните.
- Настройте права: по умолчанию включено только чтение (read). Если агент должен создавать и обновлять страницы — включите write; для архивирования — delete.
- Привяжите коннектор к нужному агенту.
- В чате с ассистентом включите кнопку «ИИ-агент» — именно она активирует работу с инструментами Notion.
Шаг 3. Примеры промптов для агента
После подключения агент работает с Notion естественным языком — не нужно называть инструменты, он сам подбирает нужный. Несколько рабочих примеров:
- «Найди в Notion страницу с онбордингом новых сотрудников и перескажи основные пункты.»
- «Выведи из базы Задачи все записи со статусом В работе и исполнителем Анна.»
- «Создай в Notion страницу Итоги встречи 17 июля и добавь туда список решений, которые я перечислю.»
- «Допиши в конец страницы Регламент поддержки новый раздел про эскалацию.»
- «Прочитай комментарии к странице Релиз 2.0 и собери из них список замечаний.»
Безопасность: не давайте лишних прав
Модель безопасности здесь двухуровневая. Первый уровень — на стороне Notion: интеграция видит только явно расшаренные страницы, поэтому не связывайте с ней пространства, доступ к которым агенту не нужен. Второй уровень — на стороне платформы: права read/write/delete у коннектора. Держите включённым минимум: если задача агента — только читать и сводить данные, оставьте read; write и delete включайте, когда действительно нужно изменять содержимое.
Частые вопросы
Какой токен нужен, чтобы подключить Notion к ИИ-агенту?
Internal Integration Token. Его выдаёт сам Notion: notion.so/my-integrations → создать интеграцию → скопировать Internal Integration Token. После этого расшарьте на интеграцию нужные страницы и базы через ⋯ → «Add connections».
Почему агент не видит мои страницы после подключения?
Скорее всего, страницы не расшарены на интеграцию. Токен создаёт интеграцию, но доступ к каждой странице или базе вы открываете отдельно — через «Add connections» на самой странице. Доступ наследуется вложенными страницами, поэтому проще расшарить корневую страницу раздела.
Может ли ИИ-агент удалять страницы в Notion?
Жёсткого удаления через API у Notion нет. Агент может архивировать страницу (notion_archive_page) — она уходит в архив, откуда восстанавливается. Это действие относится к правам уровня delete и по умолчанию выключено.
Безопасно ли хранить токен на платформе?
Токен вставляется один раз и хранится на стороне платформы, в чат он не попадает. Дополнительно ограничьте риски со стороны Notion: создайте отдельную интеграцию под агента и расшарьте на неё только нужные страницы — тогда токен открывает доступ строго к ним.
Нужно ли включать кнопку «ИИ-агент» в чате?
Да. Коннектор привязывается к ассистенту в разделе «Интеграции», но работа с инструментами Notion активируется кнопкой «ИИ-агент» в чате. Без неё ассистент отвечает как обычная модель, без доступа к вашим данным.
Можно ли начать только с чтения?
Да, и это рекомендуемый вариант. По умолчанию у коннектора включено только чтение (read). Убедитесь, что агент корректно ищет и читает данные, а потом при необходимости добавьте write для создания и обновления страниц.
Что дальше
Подключите Notion в разделе «Интеграции» у вашего ассистента, начните с прав на чтение и включите кнопку «ИИ-агент» в чате. Больше о самом коннекторе — на странице интеграции Notion (/partners/notion). Полный каталог интеграций собран в обзоре всех интеграций СуперИнтеллекта (/guides/vse-integracii-superintellekta), а что изменилось с появлением коннекторов баз данных и вики — в журнале обновлений (/changelog/ai-agent-data-connectors).
