База знаний растёт, а времени на работу с ней всё меньше. Создать документ, найти нужную заметку — каждая операция требует открыть браузер, найти нужное место, нажать нужную кнопку. Что если один разговор с ИИ-агентом заменит десятки кликов? С MCP Gateway и пресетом Yonote это реальность.
Для кого это
- Продакт-менеджер — ведёт десятки документов: PRD, протоколы встреч, решения. Через агента может создать документ, найти нужный и расшарить — не отрываясь от чата.
- Разработчик — хранит техническую документацию или быстрые идеи, записать которые почти нет времени. Агент сохранит ваши идеи, найдёт документацию и даст именно то, что вы хотели найти.
- Руководитель — хочет понимать, что происходит в базе знаний, не открывая каждый документ. Агент соберёт сводку, покажет последние изменения, найдёт нужную информацию за секунды.
Подключение за 4 шага
Шаг 1. Регистрация в MCP Gateway
Перейдите на страницу регистрации и создайте аккаунт.
Шаг 2. MCP-сервер из каталога
В Admin UI нажмите «Новый сервер». Выберите пресет Yonote из каталога — OpenAPI-спецификация уже встроена и содержит все операции с документами, коллекциями, комментариями и пользователями.
Шаг 3. Настройка авторизации
Yonote использует Bearer-токен для API. В настройках сервера выберите стратегию Bearer и вставьте ваш API-токен из Yonote (раздел «Настройки → API-токены»). MCP Gateway будет автоматически подставлять его в каждый запрос.
Шаг 4. Подключение ИИ-ассистента
Сгенерируйте PAT-токен в MCP Gateway и добавьте MCP-сервер в вашего ассистента (Claude, Cursor, Cline и др.). Теперь агент может выполнить любую операцию в Yonote.
Пять сценариев, которые экономят по часу в день
1. Создание документов и заметок на лету
Для сравнения: вручную нужно открыть Yonote → найти коллекцию → нажать «Новый документ» → ввести заголовок → написать текст → нажать «Опубликовать». Шесть действий вместо одной фразы.
2. Мгновенный поиск по всей базе знаний
Полнотекстовый поиск через documents.search пробегает по всем коллекциям и документам, к которым у вас есть доступ. Агент может сразу показать результаты, отфильтровать по дате или коллекции.
3. Управление коллекциями и структурой
Через API можно не только смотреть, но и создавать коллекции, перемещать документы между ними, архивировать устаревшие — всё через одну команду агенту.
4. Работа с комментариями и обсуждениями
Не нужно открывать документ, скроллить до нужного места и писать комментарий вручную. Агент может также читать существующие комментарии, резолвить обсуждения и выводить целые треды.
5. Экспорт и шеринг документов
Экспорт в Markdown полезен для переноса документации в GitHub, Notion или другой инструмент. А публичные ссылки через shares.create позволяют расшарить документ даже тем, у кого нет аккаунта в Yonote.
Ограничения
- Лимиты API — Yonote ограничивает частоту запросов. При массовых операциях (например, экспорт 100 документов) возможны задержки.
- Доступ только к разрешённым данным — агент видит только те коллекции и документы, к которым у вашего пользователя есть доступ. Если прав нет — API вернёт 403.
- Нет загрузки вложений — загрузка файлов через API требует multipart/form-data, что ограничено в текущей реализации MCP-инструментов. Но скачивание вложений работает.
- Форматирование — агент работает с Markdown. Сложное визуальное форматирование (таблицы с цветами, эмбеды) лучше делать вручную в UI.
- Приватность — API-токен даёт полный доступ от имени пользователя. Храните его в MCP Gateway с надёжной стратегией авторизации.
FAQ
Нужны ли навыки программирования для настройки? Нет. Весь процесс — выбор пресета, вставка API-токена, генерация PAT — делается через веб-интерфейс. Код не нужен.
Безопасно ли хранить API-токен Yonote в MCP Gateway? Да. MCP Gateway хранит кредиты в зашифрованном виде и передаёт их только в upstream-запросах. Токен не логируется и не возвращается в ответы агенту.
Можно ли ограничить доступ агента к определённым коллекциям? Напрямую — нет, API Yonote не поддерживает scoped-токены. Но MCP Gateway создаёт фильтрацию поверх спецификации и вы можете разрешить только определённые действия агенту.
Какие ИИ-ассистенты поддерживаются? Любые, поддерживающие протокол MCP: Claude (Anthropic), Cursor, Cline, Windsurf и другие. MCP Gateway работает как стандартный MCP-сервер — достаточно указать endpoint и токен.
Можно ли настроить агента так, чтобы он придерживался определённой структуры? Да, вы можете написать инструкцию для агента или навыков, чтобы ИИ-ассистент придерживался определённых правил работы с документами.