Skip to main content

​
Что такое облачная библиотека

Это копия локальной библиотеки, размещённая в Linkly AI. Она доступна через MCP, Desktop и веб-страницу, даже когда ваш компьютер выключен. Облачная копия включает подготовленное для поиска содержимое, а не заменяет оригинальные файлы.

​
Отличие от удалённого доступа

​
Когда использовать

  • Нужен круглосуточный доступ к выбранным материалам
  • Библиотекой нужно поделиться
  • Не хотите держать Desktop запущенным
  • Облачному агенту не нужен весь локальный индекс

​
Создание и отправка

1

Создайте shell на сайте

Войдите, откройте Dashboard → My Libraries → New. Первый раз задайте username. Укажите title, slug (6–60, lowercase/digits/hyphens), optional description, category и visibility.
2

Свяжите с Desktop

Нажмите Bind in Linkly Desktop. Если deep link не открылся, Copy library URL и свяжите вручную в Desktop: в Library главного окна выберите локальную библиотеку в разделе My libraries левой колонки; значок шестерёнки в правом верхнем углу откроет Library settings; в разделе Cloud Library нажмите Initialize cloud library и вставьте адрес в Already created one? Paste the library URL; нажмите Next, затем Bind.
3

Push content

Раздел Cloud Library показывает pending documents. Push можно pause/resume; повтор после interruption продолжает с места остановки. Финал — Synced to cloud и count; локальные изменения дают Local has changes.
4

Включите Auto sync

После включения Auto sync в разделе Cloud Library приложение каждые 5 минут проверяет изменения и Push автоматически.
Bind — one-to-one: cloud copy отражает одну local library, local side остаётся source of truth. Облачный контент редактировать нельзя.

​
Отвязка

Unbind this cloud library в меню раздела Cloud Library только прекращает Push; облачный контент сохраняется и позже может быть связан снова. Полное удаление: web library settings → Danger zone — удаляет файлы, invitations, stars и links без undo, не затрагивая local originals.

​
Подключение чужой библиотеки

Откройте страницу и нажмите Link; кнопка станет Linked. Даже владелец обязан связать собственную библиотеку один раз: MCP access определяется link relationship. Owner видит linked users, пользователь может unlink без изменения библиотеки. Free имеет 1 link slot, Pro — 99. Для закрытой библиотеки сначала нужно invitation.

​
Использование с ИИ

​
Три способа подключения

  • OAuth в ChatGPT, Claude.ai и других веб-приложениях
  • MCP в консольных клиентах: добавить URL и авторизоваться в браузере; если клиент этого не умеет — API Key, который вы настраиваете сами
  • CLI в удалённом режиме после linkly auth login
Cloud gateway всегда https://mcp.linkly.ai/mcp; имя сервера — linkly-ai-cloud, чтобы не перезаписать локальный linkly-ai.
Затем введите в Claude Code /mcp, выберите linkly-ai-cloud и подтвердите доступ на открывшейся странице в браузере. Если клиент может только отправлять заголовок Authorization: Bearer lkai_… из конфигурации, создайте API Key в Dashboard → Integrations (начинается с lkai_) и впишите его в файл конфигурации сами. Онлайн-приложения получают token через OAuth. На странице библиотеки Use in AI выдаёт prompt для автоматической настройки.
API Key читает ваши облачные библиотеки, а при включённом удалённом доступе — и файлы на вашем компьютере. Не вставляйте его ни в какой диалог с ИИ (ChatGPT, Claude, Cursor, Codex, Doubao, Kimi и т. п.) и не позволяйте ИИ-помощнику выполнять за вас linkly auth set-key или править конфигурацию с ключом: содержимое диалога отправляется поставщику модели и сохраняется в истории чата, а в некоторых приложениях ещё и синхронизируется в облако. Если ключ уже попал в диалог, отзовите его в Dashboard и создайте новый.

​
Как указать библиотеку

Назовите её в запросе или передайте полный идентификатор:
Для CLI:
Web URL преобразуется заменой https://linkly.ai/ на cloud://; list_libraries возвращает точное значение. Ещё не подключённую библиотеку помощник может подключить сам: library_search, затем library_link — без захода на сайт.
Каждый search явно передаёт полный cloud://<owner>/<slug>. Без library gateway пытается обратиться к Desktop через Pro tunnel; Free сразу получает ошибку. Две библиотеки требуют двух вызовов.

​
Использование в Desktop

В Library главного окна раздел Connected cloud libraries левой колонки показывает все linked libraries (кроме bound к локальной — для них используйте локальную). Выберите библиотеку и нажмите Chat with this library, чтобы начать диалог; в Chatbot также можно использовать @. Список read-only: Link/Unlink выполняются на web. Оригиналы на диск не загружаются и в локальный Launcher как обычные файлы не входят.

​
Общий доступ

Invitation отправляется email через Settings → Sharing. Request access: открыв вашу библиотеку Showcase, другой пользователь нажимает Link, в окне Request access может добавить пояснение и нажимает Request now. Вы одобряете или отклоняете запрос в Dashboard: avatar → Access requests. После одобрения пользователь становится reader — как после принятия invitation. Ужесточение visibility (например, Public → Private) немедленно удаляет links/stars всех, кто не является accepted reader, и необратимо; readers сохраняются. Публикуйте только законно распространяемые материалы.

​
Квоты и ограничения

Достигнутый quota не удаляет существующее, только запрещает новое. Лимит документов проверяется на каждый Push: если Push сделает общее число документов больше лимита, он не выполняется целиком — не загружается ни один документ. Push, который только обновляет или удаляет существующие документы, не ограничивается. Shared library занимает link slot, но не creation quota.

​
Частые вопросы

Загружаются только явно pushed libraries; text, vectors и metadata шифруются in transit/at rest, default Private. Delete cloud library удаляет всё облачное содержимое.
Нет. Manual Push либо Auto sync каждые 5 минут. Направление только local → cloud.
Вероятно, owner не нажал Link. Ownership не заменяет link relationship.
Скорее всего подключён local linkly-ai/127.0.0.1. Добавьте отдельный linkly-ai-cloud на public endpoint.
Нет. Unbind прекращает Push, cloud остаётся. Удаление облака выполняется только на web в Danger zone.
Нет, только в link slots.

​
Дополнительные материалы