> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Облачные библиотеки

> Отправьте локальную библиотеку в облако, чтобы ИИ мог искать в ней круглосуточно без вашего компьютера, и делитесь ею с другими.

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

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

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

|                           | Облачная библиотека                 | Удалённый туннель                   |
| ------------------------- | ----------------------------------- | ----------------------------------- |
| Объём                     | Только отправленная библиотека      | Все разрешённые локальные документы |
| Компьютер должен работать | Нет                                 | Да                                  |
| Общий доступ              | Да                                  | Нет                                 |
| План                      | Доступно бесплатно в пределах квоты | Pro                                 |

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

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

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

<Steps>
  <Step title="Создайте shell на сайте">Войдите, откройте Dashboard → My Libraries → New. Первый раз задайте username. Укажите title, slug (6–60, lowercase/digits/hyphens), optional description, category и visibility.</Step>
  <Step title="Свяжите с Desktop">Нажмите **Bind in Linkly Desktop**. Если deep link не открылся, Copy library URL; в Desktop откройте локальную библиотеку → Cloud Library → **Already created one? Paste the library URL** → Bind.</Step>
  <Step title="Push content">Панель показывает pending documents. Push можно pause/resume; повтор после interruption продолжает с места остановки. Финал — **Synced to cloud** и count; локальные изменения дают **Local has changes**.</Step>
  <Step title="Включите Auto sync">Приложение каждые 5 минут проверяет изменения и Push автоматически.</Step>
</Steps>

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.

```text theme={null}
cloud://username/library-slug
```

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

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

* OAuth в ChatGPT, Claude.ai и других веб-приложениях
* MCP с API Key для консольных клиентов
* CLI в удалённом режиме

Cloud gateway всегда `https://mcp.linkly.ai/mcp`; имя сервера — `linkly-ai-cloud`, чтобы не перезаписать локальный `linkly-ai`.

```bash theme={null}
claude mcp add --transport http linkly-ai-cloud https://mcp.linkly.ai/mcp \
  --header "Authorization: Bearer <your API Key>"
```

API Keys создаются в Dashboard → Integrations и начинаются с `lkai_`. Онлайн-приложения получают token через OAuth. На странице библиотеки **Use in AI** выдаёт prompt для автоматической настройки.

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

Назовите её в запросе или передайте полный идентификатор:

```text theme={null}
Найди в cloud://blueeon/linkly-init-example сведения о начале работы.
```

Для CLI:

```bash theme={null}
linkly search "your query" --remote --library "cloud://blueeon/linkly-init-example"
```

Web URL преобразуется заменой `https://linkly.ai/` на `cloud://`; `list_libraries` возвращает точное значение.

<Warning>Каждый search явно передаёт полный `cloud://<owner>/<slug>`. Без library gateway пытается обратиться к Desktop через Pro tunnel; Free сразу получает ошибку. Две библиотеки требуют двух вызовов.</Warning>

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

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

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

| Visibility | Кто видит детали/файлы | Кто Link/Search        | Explore/Search engines |
| ---------- | ---------------------- | ---------------------- | ---------------------- |
| Public     | Все                    | Любой signed-in        | Да                     |
| Showcase   | Все                    | Только invited readers | Да                     |
| Private    | Owner и invited        | Owner и invited        | Нет                    |

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

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

|                       | Free    | Pro                         |
| --------------------- | ------- | --------------------------- |
| Создаваемые libraries | 1       | 30                          |
| Documents per library | 500     | 2000                        |
| Linked libraries      | 1       | 99                          |
| Visibility            | Private | Public / Showcase / Private |
| Cloud search          | Да      | Да                          |
| Remote tunnel         | Нет     | Да                          |

Достигнутый quota не удаляет существующее, только запрещает новое. Shared library занимает link slot, но не creation quota.

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

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

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

* [Библиотеки](/docs/ru/use-libraries)
* [Настройка облачной библиотеки для агентов](/docs/ru/library-setup)
* [Удалённый доступ](/docs/ru/use-in-remote)