Подключаем Notion к AI-агенту

Один готовый промпт — и твой AI-агент сам создаёт страницы, заполняет проекты, читает и обновляет содержимое в Notion. Без копирования айди страниц, без программирования. Подходит любому AI-агенту, который умеет в Notion API.

Что получится

Агент сможет:

• Сам находить твои страницы по названию (никаких айди копировать не надо)
• Создавать страницы и проекты с любой структурой (заголовки, списки, чек-листы, цитаты, callouts, код)
• Заполнять и обновлять содержимое по мере дел
• Читать существующие страницы и работать с их содержимым
• Управлять базами данных (записи, статусы, фильтры)
• Запоминать твою структуру (куда что класть)

Пишешь в Telegram «закинь в Заметки идею про X с тремя пунктами» — агент создаёт страницу. Пишешь «обнови проект Y, добавь блок про дедлайн 20.06» — добавляет.

Установка за 3 шага

Шаг 1. Создай Internal Connection в Notion

Это «интеграция», через которую агент подключается к твоему воркспейсу.

1. Открой notion.so/profile/integrations/internal
2. Нажми карточку Create a new connection с плюсиком
3. Заполни форму:
   • Connection name — любое название, например Мой AI-агент
   • Icon — пропусти или загрузи картинку 512×512
   • Associated workspace — выбери тот воркспейс, в котором лежат твои страницы. Важно: после создания изменить нельзя
4. Нажми Create
5. В модалке Integration successfully created нажми Configure integration settings
6. На вкладке Configuration найди поле Installation access token, нажми Show → скопируй ключ (начинается с ntn_... или secret_...)

На той же вкладке Configuration проверь блок Capabilities — галочки на Read / Update / Insert content должны стоять (по умолчанию они включены).

Шаг 2. Поделись страницами с интеграцией

По умолчанию интеграция ничего не видит. Нужно дать ей доступ.

Лучший вариант для старта — создай одну общую корневую страницу (например AI-помощник или Проекты) и подключи интеграцию только к ней. Тогда агент будет создавать всё внутри неё, а ты не отдашь ему лишнего.

Два способа подключения:

Способ A — со страницы Notion (проще для 1-2 страниц):

• Открой нужную страницу
• Сверху справа: • • • → Connections → выбери свою интеграцию

Способ B — со страницы интеграции (удобно для нескольких страниц):

• На странице Edit connection открой вкладку Content access
• Нажми Edit access → откроется модалка Manage page access
• Выбери страницы → Save

Шаг 3. Дай агенту ключ + промпт ниже

Никакие айди страниц копировать не нужно. Просто отправь агенту ключ и промпт ниже целиком. Замени NOTION_KEY на свой ключ:

Подключи мой Notion и научись управлять страницами.
Мой ключ интеграции: NOTION_KEY

Базовое правило: ты НЕ просишь у меня айди страниц.
Ты находишь их сам через Notion API search и запоминаешь,
чтобы при следующих запросах не искать заново.

1. ПЕРВЫЙ ЗАПУСК — найди что мне доступно

Сделай запрос:
POST https://api.notion.com/v1/search
Headers:
  Authorization: Bearer NOTION_KEY
  Notion-Version: 2022-06-28
  Content-Type: application/json
Body: {"filter": {"property": "object", "value": "page"}}

В ответе будут все страницы которые интеграция видит. Покажи мне
список их названий, помеж какие корневые (могут быть родителями
для новых страниц), и спроси куда я хочу сохранять создаваемое
по умолчанию.

2. ЗАПОМНИ мой выбор

После моего ответа сохрани у себя в памяти:
- PARENT_PAGE_ID = айди страницы которую я выбрал родительской
- Карту "название → айди" для других моих страниц,
  чтобы при «обнови страницу X» сразу знать её айди.

3. СОЗДАНИЕ СТРАНИЦЫ — когда я говорю «создай страницу X»

Если я не указал куда — клади под PARENT_PAGE_ID.
Если я говорю «создай X в Y» — найди Y через search, используй
его айди как родителя, и запомни.

POST https://api.notion.com/v1/pages
Body:
{
  "parent": {"page_id": "PARENT_OR_FOUND_ID"},
  "properties": {"title": {"title": [{"text": {"content": "X"}}]}},
  "children": [... блоки контента ...]
}

Базовые типы блоков (children):
- paragraph: {"type":"paragraph","paragraph":{"rich_text":[{"type":"text","text":{"content":"текст"}}]}}
- heading_1 / heading_2 / heading_3: аналогично
- bulleted_list_item, numbered_list_item, to_do, callout, quote, divider, code — по той же схеме

4. ОБНОВЛЕНИЕ — когда я говорю «обнови страницу X»

Если айди X у тебя уже есть в карте — используй сразу.
Если нет — найди через search (передай title в query), запомни, используй.

PATCH https://api.notion.com/v1/blocks/PAGE_ID/children
  — добавить новые блоки в конец страницы (body: {"children": [...]})
PATCH https://api.notion.com/v1/blocks/BLOCK_ID
  — обновить отдельный блок
DELETE https://api.notion.com/v1/blocks/BLOCK_ID
  — удалить (архивировать) отдельный блок
PATCH https://api.notion.com/v1/pages/PAGE_ID
  body: {"archived": true}
  — архивировать страницу целиком

5. ЧТЕНИЕ — когда я говорю «прочитай страницу X»

GET https://api.notion.com/v1/blocks/PAGE_ID/children?page_size=100

6. ОБРАБОТКА ОШИБОК

- "object_not_found" → страница не подключена к интеграции.
  Скажи мне какую страницу подключить через Connections.
- "unauthorized" → ключ неверный или отозван. Скажи мне
  перепроверить ключ.

7. ПОДТВЕРЖДЕНИЯ

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

ТЕСТ ГОТОВНОСТИ
Сделай search прямо сейчас, покажи мне список доступных страниц
и спроси какую использовать как корневую для новых страниц.

Ожидаемый ответ агента: список доступных страниц + вопрос «какую сделать корневой». После твоего выбора агент запомнит и больше айди у тебя не спросит.

Что попробовать после подключения

Создай страницу «Идеи для контента» с тремя разделами:
Reels, посты в Telegram, видео. Под каждым разделом сделай
чек-лист на 5 пустых пунктов.

Создай мне CRM-таблицу для лидов с колонками: имя, источник,
статус (новый / встреча / сделка / отказ), заметки.

Обнови страницу «Проект X», добавь раздел «Дедлайны»
с тремя пунктами: PRD до 25 мая, MVP до 10 июня, релиз до 30 июня.

Прочитай страницу «Заметки встречи 2026-05-20» и сделай
краткую выжимку.

Если что-то пошло не так

Агент просит айди страницы

Игнорирует промпт. Напомни: «найди через search и запомни сам, я айди не передаю». Если упрямится — поменяй на агента который умеет в search API (Claude и ChatGPT умеют).

Ошибка object_not_found

Страница не расшарена с интеграцией. Открой страницу → • • • → Connections → подключи интеграцию. Или сделай способом B из шага 2.

Ошибка unauthorized

Ключ неверный. Проверь что скопировал полностью без пробелов. На вкладке Configuration нажми Refresh для нового ключа если старый утёк или забыл.

Search возвращает пустой список

Интеграция ни с одной страницей не связана. Вернись к шагу 2.

Лимиты Notion API — около 3 запросов в секунду. Для личных задач никогда не упрёшься.

Один совет на сейчас

Не отдавай агенту ключ от ВСЕГО воркспейса сразу. Создай отдельную страницу «Песочница агента», подключи интеграцию только к ней. Когда поймёшь что доверяешь — расширишь доступ. Принцип минимальных привилегий.

Что дальше

Когда базовая работа со страницами устаканится, можно подключить базы данных Notion (taskboards, CRM, контент-планы) — это уже более насыщенный сценарий, агент будет создавать записи и менять статусы. Об этом — отдельным гайдом, или попроси агента: «расскажи как работать с моими databases в Notion, покажи на одной из них».

Соседние гайды:

• AGENTS.md и Memory Bank — фундамент памяти, без которого любая интеграция работает в холостую
• Экономия токенов — как не сжечь подписку, когда агент часто ходит в Notion