Подключение ассистента
Добавьте MCP-сервер в свой ИИ-клиент, выберите, до чего ему можно дотянуться среди пяти групп разрешений, и отзовите доступ, когда закончите.
Откройте страницу MCP в веб-приложении Read Frog. Там показаны адрес сервера, шаги настройки для каждого клиента и все клиенты, которым вы уже выдали доступ.
Адрес сервера для всех одинаков:
https://api.readfrog.app/api/mcpМежду клиентами различается только то, куда вы вставляете этот адрес и что клиент требует, прежде чем вас пустить.
Добавьте сервер
Добавьте удалённый MCP-сервер по адресу выше, транспорт — Streamable HTTP. В ChatGPT это живёт в Настройки → Плагины при включённом режиме разработчика; в Claude — в Настройки → Коннекторы → Добавить пользовательский коннектор. Codex и Claude Code принимают по одной команде, показанной на странице MCP.
Выберите авторизацию OAuth 2.1. Динамическая регистрация клиента и документы с метаданными
client ID поддерживаются оба, поэтому ни client ID, ни секрет вводить не нужно. Клиенты, которым
обязательно нужен документ обнаружения, могут прочитать его по адресу
https://api.readfrog.app/.well-known/oauth-protected-resource/api/mcp.
Клиент отправляет вас на страницу согласия Read Frog. Войдите, проверьте показанные там название и идентификатор приложения, выберите уровень для каждой запрошенной группы разрешений и нажмите Разрешить.
Некоторые клиенты закрывают пользовательские коннекторы своим собственным тарифом. ChatGPT нужен платный тариф; личному аккаунту Claude нужен Pro или Max, а в Team или Enterprise коннектор добавляет владелец в настройках организации. У Codex и Claude Code таких ограничений нет.
Собственное требование Read Frog — тариф Ultra. Подключение с аккаунта без него завершает авторизацию, а затем отказывает каждому вызову инструмента с пояснением: повторный вход этого не меняет, потому что никакая выдача разрешений не меняет подписку.
Пять групп разрешений
Групп ровно пять. account — только для чтения; остальные четыре можно выставить в «нет доступа», «чтение» или «чтение и запись». Вы выбираете по группе и только среди тех групп, которые клиент действительно запросил.
| Группа | Чтение позволяет ассистенту видеть | Запись дополнительно позволяет |
|---|---|---|
account | Ваше имя, адрес электронной почты и аватар. Содержимое заметок — никогда. | Ничего — у этой группы нет уровня записи. |
notebases | Ваши notebase и определения их полей, включая идентификаторы полей. | Создавать, переименовывать и удалять notebase; добавлять, менять и удалять поля. |
notes | Значения полей каждой заметки и поиск по ним. | Создавать, изменять и удалять заметки. |
card_templates | Заготовки лицевой и оборотной сторон, по которым создаются карточки. | Создавать, изменять и удалять шаблоны. |
study | Историю повторений, состояние расписания, счётчики очереди и дневные лимиты. | Записывать и отменять повторения, менять дневные лимиты, приостанавливать и откладывать карточки. |
Два инструмента стоят на стыке групп. Чтобы прочитать отрисованную карточку — её лицевую сторону, оборотную, состояние изучения — нужны notes:read и study:read вместе, потому что карточка — это содержимое заметки плюс состояние расписания. Выдача только одного из них оставляет list_cards и get_card недоступными.
Что может уничтожить разрешение на запись
Запись — это не только «можно добавлять». Уровень записи в каждой группе включает удаление, а удаление в notebase каскадно.
| Выдавая | В худшем случае |
|---|---|
notes:write | Заметка удалена навсегда вместе со всеми порождёнными из неё карточками и записями повторений этих карточек. |
notebases:write | Целая notebase удалена навсегда — её поля, все заметки, шаблоны, карточки и вся история повторений. |
card_templates:write | Шаблон удалён, а вместе с ним все порождённые им карточки и их записи повторений. Исходные заметки уцелевают. |
study:write | Записано повторение, которого вы не делали. FSRS принимает его за настоящее, поэтому стабильность, сложность и срок карточки сдвигаются. |
Ничего из этого Read Frog отменить не может. undo_review откатывает последнее повторение одной карточки, но отмены для удалённой заметки, поля, шаблона или notebase не существует.
Сначала выдавайте чтение. Доступа только для чтения уже хватает, чтобы искать нужное, планировать, что повторять, и отчитываться о вашем прогрессе, — и потерять им ничего нельзя. Поднимайте группу до записи только тогда, когда у вас есть конкретный рецепт, которому это нужно, и читайте, что предлагает ваш ассистент, прежде чем одобрять удаление.
Добавление разрешений позже
Выданный доступ всегда содержит ровно то, что запросила конкретная авторизация, и на том уровне, который вы для неё выбрали. Если инструмент падает из-за того, что подключению не хватает разрешения, клиенту сообщают, какое именно нужно; многие клиенты после этого сами отправляют вас обратно на страницу согласия, а некоторые надо переподключать вручную, прежде чем они спросят снова.
В обратную сторону это тоже работает: авторизуйтесь ещё раз и понизьте группу. Страница согласия может понизить только те группы, которые упомянуты в новом запросе, поэтому доступ к группе, о которой клиент перестал спрашивать, остаётся как был. Чтобы стереть всё разом, отзовите подключение.
Управление и отзыв
Страница MCP перечисляет каждый подключённый клиент с зарегистрированным им названием, идентификатором приложения, датой подключения, датой последней авторизации и разрешениями, которыми он владеет сейчас.
Отозвать удаляет разрешения этого клиента и немедленно прекращает его доступ. Его refresh token уходит вместе с выданным доступом, поэтому при следующей попытке переподключиться он оказывается снова на странице согласия, где вы решаете заново. Тот же клиент можно подключить позже; новый доступ начинается с нуля.
Отзыв не действует назад. Содержимое, которое сервис уже получил, остаётся у этого сервиса — как Read Frog обращается с данными, см. в политике конфиденциальности. Убрать коннектор внутри самого ассистента тоже стоит, но само по себе это не отзывает доступ на стороне Read Frog.
Когда что-то не работает
- Инструмент говорит, что ему нужно больше разрешений. Выдайте эту группу либо оставьте её закрытой и держитесь тех операций, которые вы разрешили. Переподключите клиент, если он не переспрашивает сам.
- Всё подключается, но каждый инструмент отказывает с сообщением про тариф. Аккаунт не на Ultra.
- Новые инструменты не появляются. Обновите или переподключите коннектор; клиенты кэшируют список инструментов.
- Запись падает с сообщением о том, что заметка изменилась. Правки защищены от устаревших данных. Попросите ассистента перечитать заметку и повторить.
- Повторение падает с запросом часового пояса. Записывая повторение, система решает, какому учебному дню оно принадлежит, и угадывать не станет. Назовите ассистенту ваш часовой пояс в формате IANA или один раз откройте веб-приложение Read Frog под своим аккаунтом, чтобы он сохранился.
Если вы застряли — напишите нам.