# Notion: начните здесь (/ru/docs/notion)

Планы, заметки со встреч и базы данных проектов лежат в Notion, и ИИ-агент на вашем компьютере не видит их, пока вы
не вставите текст в чат. Инструмент командной строки `notion` копирует выбранные страницы на ваш компьютер. Агент
ищет по ним и берет из них контекст, даже без интернета.

Спросите агента, на какой странице записали решение, какие строки есть в базе проекта или что сказано о функции в
спецификации. Агент найдет страницу в локальной копии и даст ссылку на нее в Notion.

`notion` хранит копию в локальном хранилище. Это один файл на вашем компьютере, общий для всех инструментов
WireCat. Там же лежат ваши чаты, почта и встречи, поэтому [Memo](/llms.mdx/docs/ru/memo/content.md) найдет страницу Notion вместе с
перепиской о ней. Для начала нужен токен Notion: ключ, с которым инструмент читает ваше рабочее пространство.

**На этой странице:**

1. [Что вы получите](#что-вы-получите)
2. [Получите токен Notion](#получите-токен-notion)
3. [Подключите и скопируйте страницы](#подключите-и-скопируйте-страницы)
4. [Чего пока нет](#чего-пока-нет)
5. [Найдите инструкцию под свою задачу](#найдите-инструкцию-под-свою-задачу)

## Что вы получите [#что-вы-получите]

- **Поиск без интернета.** Найдете страницу по словам в любой их форме, а после индексации и по смыслу.
- **Только нужные страницы.** Если ничего не выбрать, инструмент копирует все, что видит токен. Можно сузить копию до
  нескольких страниц или баз данных вместе со всем, что в них вложено.
- **Строки баз данных как страницы.** Каждая строка базы копируется как страница, со своей ссылкой в Notion.
- **Свои заметки к странице.** Добавляйте к странице теги, заметки и факты. Они остаются на компьютере и в Notion не
  попадают.
- **Чтение напрямую, когда нужно.** Прочитайте одну страницу из Notion в виде Markdown или получите список баз
  данных, которые видит токен, ничего не копируя.
- **Подключенный агент.** Установите навык инструмента для агента в терминале, например Claude Code, или подключите
  инструмент по MCP к приложению, которое умеет работать с MCP-серверами.

Токен хранится в связке ключей системы, а там, где ее нет, в закрытом файле. `notion` обращается только к API
самого Notion. Подробнее в разделе [доступ и безопасность](/llms.mdx/docs/ru/notion/security/content.md).

## Получите токен Notion [#получите-токен-notion]

От токена зависит, что увидит инструмент. В Notion есть два вида токенов:

- [Личный токен доступа](https://developers.notion.com/guides/connections-and-tokens/personal-access-tokens)
  действует с вашими правами и видит то же, что и вы.
- Токен внутреннего подключения видит только страницы, которыми вы поделились с этим подключением в Notion.
  Выберите его, если хотите дать инструменту несколько страниц и больше ничего.

## Подключите и скопируйте страницы [#подключите-и-скопируйте-страницы]

1. [Установите `notion`](/llms.mdx/docs/ru/notion/installation/content.md) из npm.
2. Войдите. `personal` здесь профиль: имя, которое вы выбираете для одного аккаунта Notion. Инструмент спросит токен
   скрытым вводом.

```sh
notion personal session start
```

3. Выберите, что копировать, или пропустите этот шаг, чтобы скопировать все, что видит токен. `folders browse`
   показывает верхний уровень рабочего пространства, по одному уровню за раз.

```sh
notion personal folders browse
notion personal folders add https://www.notion.so/Team-plans-1a2b3c4d5e6f47a8b9c0d1e2f3a4b5c6
```

4. Скопируйте страницы и поищите по ним.

```sh
notion personal sync
notion personal search "квартальный план"
```

Одна синхронизация проходит примерно до 10 000 записей и запоминает, где остановилась. Запустите ее снова, чтобы
продолжить, а позже, чтобы забрать изменения. `notion personal status` показывает, сколько уже пройдено.

5. Подключите агента. Агент в терминале получает навык:

```sh
notion skill install
```

Приложение с MCP подключается к серверу, как описано в разделе [использование](/llms.mdx/docs/ru/notion/usage/content.md#agents).

## Чего пока нет [#чего-пока-нет]

- Поиска строк базы по свойствам, например по статусу или ответственному. Поиск находит строки по их тексту.
- Готовых команд для записи в Notion. Команды `api` уже умеют создавать и менять страницы, и по умолчанию они
  разрешены. Отключить их можно переменной `WCNOTION_READ_ONLY=1` или [настройкой `permissions`](/llms.mdx/docs/ru/notion/configuration/content.md#permissions).
- Папки с файлами Markdown, которая сама обновляется вслед за деревом страниц Notion.

## Найдите инструкцию под свою задачу [#найдите-инструкцию-под-свою-задачу]

| Задача | Инструкция |
|---|---|
| Установить или обновить инструмент | [Установка](/llms.mdx/docs/ru/notion/installation/content.md) |
| Узнать, как устроена команда, и подключить агента | [Использование](/llms.mdx/docs/ru/notion/usage/content.md) |
| Найти команду или параметр | [Команды](/llms.mdx/docs/ru/notion/commands/content.md) |
| Изменить настройку или разрешение | [Настройки](/llms.mdx/docs/ru/notion/configuration/content.md) |
| Исправить ошибку | [Если что-то пошло не так](/llms.mdx/docs/ru/notion/troubleshooting/content.md) |
| Узнать, что инструмент хранит и отправляет | [Доступ и безопасность](/llms.mdx/docs/ru/notion/security/content.md) |
| Сравнить с другими инструментами для Notion | [Сравнение](/llms.mdx/docs/ru/notion/compare/content.md) |
