Подключение ИИ-клиента

Откройте ИИ-клиенту, например чат-ассистенту или инструменту для программирования, доступ к вашей библиотеке Nectar и этим руководствам по личному токену.

Перед началом

Доступ для ИИ включается на стороне сервиса. Если в Настройках нет раздела «Доступ для ИИ», значит, он пока недоступен. Клиент должен уметь подключаться к MCP-серверу по HTTPS напрямую или через небольшой локальный мост.

Создать токен

Откройте Настройки и найдите Доступ для ИИ.
Нажмите «Создать токен». Для этого нужно было войти в аккаунт не более 10 минут назад, иначе Nectar попросит войти ещё раз.
Назовите токен так, чтобы было понятно, для какого клиента и устройства он нужен, и выберите срок действия: от 1 до 90 дней, по умолчанию 30.
Выберите разрешения. Сейчас инструментам нужно только чтение; остальные разрешения пригодятся будущим инструментам, которые смогут менять ваши данные, а пока ни на что не влияют.
Скопируйте токен. Он показывается только один раз, а Nectar хранит лишь его отпечаток.

Подключить клиент

В Настройках указан адрес для подключения (он заканчивается на /mcp/me) и готовая конфигурация.

Клиенты, которые позволяют задать свой заголовок, подключаются к этому адресу с заголовком Authorization: Bearer ВАШ_ТОКЕН.
Клиенты, которые запускают локальную команду, используют мост из конфигурации, с адресом и вашим токеном в его настройках.

Храните токен в настройках клиента и никогда не вставляйте его в чат или в файлы, которые кому-то отправляете.

Что может клиент

Клиент видит то же, что вы в приложении, и не больше:

me: ваш аккаунт, уровень, серию, цель на день и задания, а также сколько у вас свитков и коллекций;
scrolls_list и scroll_inspect: вашу библиотеку, ваши свитки и публичный каталог, а также один свиток с главами, идеями и примерами;
collections_list и collection_inspect: ваши коллекции и те, что вам понравились;
saved_list, review_list и revisit_due: понравившиеся идеи, сохранённые свитки, «Повторить позже» и идеи, которые ждут в Повторе;
friends_list: ваших друзей и заявки в друзья;
docs_search и docs_read: эти руководства, чтобы клиент мог объяснить, как устроен Nectar.

Клиент не может получать за вас XP или прогресс чтения, менять почту или пароль и удалять аккаунт. Чтобы точно узнать, что разрешает ваш токен, попросите клиента показать список инструментов.

Берегите токены

Можно иметь до 10 активных токенов. Если токен больше не нужен или мог попасть в чужие руки, сразу отзовите его в Настройках: он тут же перестанет работать. Токен также перестаёт работать по истечении срока.