# Коннектор для ассистентов

Подключите ChatGPT, Claude или Meta Muse к своей библиотеке Reading Journey и просите ассистента добавлять книги, отмечать их прочитанными, ставить оценки или планировать список «На очереди». Настройка занимает около двух минут, коннектор бесплатный.

Адрес сервера: `https://mcp.readingjourney.app`

## Прежде чем начать

- Аккаунт Reading Journey. Войти можно через Apple, Google или по адресу эл. почты и паролю, а создать аккаунт можно прямо во время настройки.
- Входите тем же способом, что и в приложении, чтобы ассистент подключился к вашей существующей библиотеке.
- **Claude** (веб, приложения для компьютера и телефона), ChatGPT или **Meta Muse**.
- RJ+ не нужен, и для подключения даже не обязательно устанавливать приложение.

## Подключение Claude

Reading Journey есть в каталоге коннекторов Claude, поэтому ничего вставлять не нужно.

1. Откройте [Reading Journey в каталоге Claude](https://claude.ai/directory/reading-journey) и нажмите **Connect to Claude**.
2. На странице Reading Journey выберите **Продолжить с Apple** или **Продолжить с Google** либо войдите с адресом эл. почты и паролем.
3. Проверьте, что Claude сможет делать, и нажмите **Разрешить**. Вы вернётесь в Claude.
4. В чате откройте меню **+**, выберите **Connectors** и убедитесь, что Reading Journey включён. Теперь можно спрашивать.

В тарифах Team и Enterprise сначала владелец включает коннектор в разделе **Organization settings > Connectors**, после чего каждый участник подключается со своим аккаунтом Reading Journey. Если коннектор подключён в веб-версии, он работает и в мобильных приложениях Claude.

## Подключение Meta Muse

1. В Muse откройте **Settings > Connectors**.
2. Выберите **Add custom connector** и вставьте `https://mcp.readingjourney.app`.
3. На странице Reading Journey войдите тем же способом, что и в приложении, проверьте разрешения и выберите **Разрешить**.

Меню Muse может меняться от версии к версии; если не находите Connectors, загляните в справку Meta о пользовательских коннекторах.

## Попробуйте

Откройте новый чат и попросите, например:

- «Добавь „Пиранези“ Сюзанны Кларк в мой Reading Journey как „Хочу прочитать“ и поставь в „На очереди“».
- «Что у меня в „На очереди“? Замени третью книгу на „Левую руку тьмы“».
- «Tomorrow, and Tomorrow, and Tomorrow дочитана вчера. Отметь её прочитанной и поставь 4,5 звезды».
- «Создай коллекцию „Книжный клуб 2026“ и добавь в неё все книги японских авторов из „Хочу прочитать“».
- «Какие книги я сейчас читаю, а какие отложены?»
- «Бросаю „Бесконечную шутку“. Отметь её как недочитанную».
- «Посоветуй три уютных фэнтези-романа, которых у меня ещё нет, и добавь тот, который я выберу».

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

## Что ассистент может и чего не может

| Может | Не может |
| --- | --- |
| Видеть и менять ваши книги, статусы, оценки, коллекции, «На очереди», заметки, рецензии и записи дневника | Видеть ваши фото или точную геопозицию |
| Добавлять книги, менять их статус, ставить оценки, записывать прогресс и ставить цели | Удалять коллекцию, цель, прочтение или книгу с историей чтения, не спросив вас |
| Вести «На очереди» и Топ-4, создавать и наполнять коллекции, добавлять фото по вашей просьбе | Менять ваш аккаунт, подписку или настройки |

Страница разрешений, которую вы видите при подключении, говорит то же самое: ассистент может читать и менять ваши заметки, рецензии и записи дневника, а также добавлять, заменять или удалять фото по вашей просьбе, но никогда их не видит. Подключили коннектор до 1 ноября 2026 года? Подключитесь заново, чтобы дать ему этот доступ.

## Справочник инструментов

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

| Инструмент | Тип | Что делает |
| --- | --- | --- |
| `list_books` | Чтение | Показывает ваши книги со статусом, оценкой, местом в «На очереди» и коллекциями; умеет фильтровать по статусу, коллекции или словам |
| `get_book` | Чтение | Одна книга с датами каждого прочтения, вашей оценкой, коллекциями и местом в «На очереди» |
| `list_collections` | Чтение | Ваши коллекции и сколько книг в каждой |
| `get_next_up` | Чтение | Книги из «На очереди» по порядку |
| `add_book` | Запись | Добавляет книгу (по умолчанию в «Хочу прочитать»); никогда не дублирует уже имеющуюся |
| `set_status` | Запись | Начинает, ставит на паузу, завершает или бросает книгу либо отмечает её как «Хочу прочитать» |
| `rate_book` | Запись | Ставит текущему прочтению оценку от 0,25 до 5 звёзд или сбрасывает её |
| `set_next_up` | Запись | Ставит ещё не начатую книгу в «На очереди» |
| `remove_from_next_up` | Запись | Убирает книгу из «На очереди» |
| `create_collection` | Запись | Создаёт коллекцию |
| `add_to_collection` | Запись | Добавляет книгу в коллекцию |
| `remove_from_collection` | Запись, сначала спрашивает | Убирает книгу из коллекции; сама книга остаётся |
| `remove_book` | Запись, сначала спрашивает | Удаляет книгу, которую вы лишь добавили и больше ничего с ней не делали; никогда не удаляет книгу с историей чтения, оценкой, записью в дневнике, прогрессом, местом в Топ-4, заметкой или фото обложки |

Для разработчиков: области доступа OAuth – `mcp` (чтение и изменение; именно это даёт «Разрешить»), `library:read` и `library:write`. Пока вы пользуетесь подключением, вход сохраняется; после 60 дней без использования подключитесь снова.

## Ограничения и безопасность

- Ассистенту дано указание спрашивать вас, прежде чем удалить книгу или убрать её из коллекции.
- Если вы что-то изменили на телефоне, приоритет у вашего изменения, а не у изменения ассистента.
- Ассистентам дано указание никогда не выполнять инструкции, написанные в названиях книг, именах авторов или названиях коллекций.
- Каждое подключение может читать вашу библиотеку 60 раз в минуту и менять её 30 раз в минуту.
- Коннектор не считается устройством, поэтому не влияет на синхронизацию в бесплатном тарифе.

## Отключение

Удалите коннектор в самом ассистенте: в Claude откройте **Customize > Connectors**, выберите Reading Journey и нажмите **Remove**; в Muse откройте **Settings > Connectors**. Удаление аккаунта Reading Journey отключает всех ассистентов. Выход из приложения их не отключает.

## Решение проблем

| Что вы видите | Что делать |
| --- | --- |
| «Этот адрес и пароль не подходят ни к одному аккаунту.» | Проверьте, нет ли опечаток, или сбросьте пароль в приложении через **Забыли пароль?**. Если в приложении вы входите через Apple или Google, выберите вместо этого **Продолжить с Apple** или **Продолжить с Google**. |
| Ассистент видит пустую библиотеку | Вы вошли не тем способом, что в приложении. Отключите коннектор, подключите его снова и войдите тем же способом. |
| «Сначала подтвердите адрес эл. почты, затем войдите.» | Откройте письмо с подтверждением, которое мы отправили, и войдите снова. |
| «Срок действия страницы истёк.» | Вернитесь в ассистента и снова подключите Reading Journey. |
| Провайдер отклонил регистрацию приложения | Этот ассистент пока не поддерживается. Поддерживаются Claude, ChatGPT и Meta Muse. |
| Изменения не появляются в приложении | Убедитесь, что в приложении выполнен вход в тот же аккаунт, затем переключитесь на другое приложение и вернитесь. В бесплатном аккаунте изменения приходят на то устройство, которое синхронизируется. |
| «…можно удалить только в приложении Reading Journey.» | У книги есть история чтения; удалите её со страницы книги в приложении. |
