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 откройте локальную библиотеку → Cloud Library → Already created one? Paste the library URL → Bind.
3

Push content

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

Включите Auto sync

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

​
Отвязка

Unbind только прекращает 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 с API Key для консольных клиентов
  • CLI в удалённом режиме
Cloud gateway всегда https://mcp.linkly.ai/mcp; имя сервера — linkly-ai-cloud, чтобы не перезаписать локальный linkly-ai.
API Keys создаются в Dashboard → Integrations и начинаются с lkai_. Онлайн-приложения получают token через OAuth. На странице библиотеки Use in AI выдаёт prompt для автоматической настройки.

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

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

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

Settings → Libraries → Connected cloud libraries показывает linked libraries и toggle доступности в Chat. В Chatbot используйте @. Раздел read-only: Link/Unlink выполняются на web. Оригиналы на диск не загружаются и в локальный Launcher как обычные файлы не входят.

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

Invitation отправляется email через Settings → Sharing. Ужесточение visibility немедленно удаляет links/stars всех, кто не является accepted reader, и необратимо; readers сохраняются. Публикуйте только законно распространяемые материалы.

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

Достигнутый quota не удаляет существующее, только запрещает новое. 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.

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