> ## 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.

# Аккаунт Linkly AI

> Аккаунт нужен только для облачных сервисов. Локальное индексирование, поиск и MCP работают без входа и интернета.

## Для чего нужен аккаунт

Linkly AI — local-first: документы, индекс и поиск остаются на компьютере. Аккаунт только связывает приложение с тремя облачными возможностями: официальными моделями без собственных ключей, облачными библиотеками и удалённым доступом из ChatGPT/Claude.ai. Он не участвует в локальной работе.

## Что работает без входа

| Возможность                     | Примечание                                                                          |
| ------------------------------- | ----------------------------------------------------------------------------------- |
| Индексирование                  | Сканирование и разбор PDF, изображений, Office и Markdown выполняются на устройстве |
| Локальный поиск                 | BM25, vector и outline с локальными моделями                                        |
| Launcher и локальные библиотеки | Полный интерфейс и поиск по библиотекам                                             |
| MCP на `127.0.0.1` и CLI local  | Всегда разрешены на этом компьютере                                                 |
| Chatbot со своей моделью        | Добавьте сторонний API key или локальную модель в **Settings → AI**                 |
| Notes и Linkly AI Space         | Полностью локальны                                                                  |

<Note>На шаге входа в onboarding нажмите ссылку **skip sign-in** внизу. Позже войти можно в **Settings → Account**. Без входа потребуется самостоятельно настроить модель для Chatbot.</Note>

## Что открывает вход

* **Linkly Official** автоматически появляется в **Settings → AI**: Free получает базовые модели, Pro — также frontier; ключи вручную не нужны
* Можно создавать cloud libraries, отправлять локальный контент, связывать чужие, приглашать читателей и публиковать
* Pro включает MCP tunnel между компьютером и `mcp.linkly.ai`
* Dashboard управляет API Keys, квотами, библиотеками и подпиской

### Страницы веб-панели

| Страница                                                 | Назначение                                                                      |
| -------------------------------------------------------- | ------------------------------------------------------------------------------- |
| [Home](https://linkly.ai/dashboard)                      | План, вызовы MCP за 30 дней, три окна квоты моделей: 5 часов / 7 дней / 30 дней |
| [My Libraries](https://linkly.ai/dashboard/libraries)    | Собственные, связанные, общие и избранные библиотеки; link slots                |
| [Integrations](https://linkly.ai/dashboard/integrations) | Cloud MCP endpoint, API Keys, загрузки клиентов и инструкции                    |
| [Invitations](https://linkly.ai/dashboard/invitations)   | Pending / accepted / declined / revoked приглашения                             |
| [New cloud library](https://linkly.ai/libraries/new)     | Title, slug, description, category и visibility                                 |

В меню аватара находятся Edit Profile, Invitations, My subscription/Upgrade, Help center и Sign Out.

## Как войти

### На сайте

Откройте [linkly.ai](https://linkly.ai) и выберите Google, GitHub, Notion или одноразовый код на email. Пароль Linkly AI не создаётся; первый вход одновременно регистрирует аккаунт.

### В Desktop

В **Settings → Account** нажмите **Sign In**. Браузер запускает OAuth 2.1 + PKCE только со scopes `openid email`; приложение показывает ожидание и позволяет Cancel. После успеха браузер возвращает фокус, карточка показывает email и **Connected to Linkly AI Cloud**, а список официальных моделей загружается автоматически.

<Tip>Без браузера раскройте **Optional: connect your account by setting an API key manually** и вставьте `lkai_` из Dashboard — результат равнозначен OAuth.</Tip>

### В расширении

Расширение вообще не требует входа для извлечения страницы, Markdown preview и export. Вход на toolbar — необязателен.

## Имя пользователя

При первом входе Dashboard требует Display Name и глобально уникальный Username. Его также можно задать через avatar → **Edit Profile**.

* 6–39 символов
* только строчные буквы, цифры и дефисы
* начало и конец — буква или цифра
* двойные дефисы и зарезервированные слова запрещены

<Warning>Username после сохранения изменить нельзя: он входит в `linkly.ai/<username>/<slug>` и `cloud://username/library`. Display name и avatar изменяются свободно.</Warning>

## Free и Pro

| Возможность                                   | Free                   | Pro                               |
| --------------------------------------------- | ---------------------- | --------------------------------- |
| Все локальные функции и offline               | ✅                      | ✅                                 |
| Parsing, full-text/vector search, outline     | ✅                      | ✅                                 |
| MCP, CLI, расширение                          | ✅                      | ✅                                 |
| Официальные модели                            | Базовые, меньшая квота | Базовые + frontier, большая квота |
| Cloud libraries                               | Создание/link/search   | Повышенные количество и ёмкость   |
| Visibility облака                             | Только Private         | Public / Showcase / Private       |
| Remote access (tunnel)                        | ❌                      | ✅                                 |
| Облачный high-precision parsing и оптимизация | ❌                      | Скоро                             |
| Облачная audio/video transcription            | ❌                      | Скоро                             |

Точные лимиты меняются и всегда показаны на [pricing](https://linkly.ai/pricing) и в quota panel.

* Cloud library search доступен Free; только tunnel строго Pro
* Приглашать читателей в Private-библиотеку можно без Pro; открытая Public/Showcase публикация требует Pro
* Чужая shared library занимает link slot, но не creation quota
* Официальные модели делят общий pool, модели имеют разные multipliers, а исчерпание любого окна ограничивает вызовы
* Превышение лимита не удаляет существующие библиотеки/документы, только блокирует новое до автоматического обновления окна

### Подписка и отмена

* На [pricing](https://linkly.ai/pricing) **Subscribe Now** открывает Stripe. Китайский интерфейс также предлагает разовый Alipay/WeChat Pay на год без auto-renewal
* Dashboard avatar → **My subscription** открывает отмену Stripe; Pro действует до конца оплаченного периода
* Доступен полный возврат в течение 7 дней без объяснения причин

## API Keys

Ключ — `lkai_` плюс 32 шестнадцатеричных символа, всего 37. Создавайте в **Dashboard → Integrations → API Keys → New Key**.

```text theme={null}
Authorization: Bearer lkai_...
```

| Сценарий        | Использование                                       |
| --------------- | --------------------------------------------------- |
| Cloud MCP       | Header `Authorization: Bearer lkai_...`             |
| Remote tunnel   | **Settings → MCP → Remote access**                  |
| CLI remote      | `linkly auth set-key lkai_...`                      |
| Official models | Desktop получает и хранит автоматически после OAuth |

* Одного ключа достаточно: Desktop создаёт или повторно использует его, а New Key отключается при существующем
* Он не одноразовый: eye icon раскрывает, copy icon копирует в любой момент
* По умолчанию не истекает; trash icon отзывает немедленно, после чего создайте новый

<Warning>Ключ равнозначен учётным данным: видит cloud libraries, а при включённом tunnel — документы компьютера. Не коммитьте, не вставляйте в чат/скриншот; при утечке немедленно отзовите.</Warning>

## Безопасность аккаунта

* Desktop Sign Out только удаляет credentials на этом устройстве; local index/libraries/chat и cloud copies остаются
* Sign Out не отзывает server key: потерянный ключ нужно отдельно удалить в Dashboard
* Desktop хранит credentials в `config.json` app data, CLI — `~/.linkly/credentials.json`; logs автоматически редактируют ключи
* Самообслуживаемого удаления аккаунта пока нет — обратитесь через [support](https://linkly.ai/support)

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

<AccordionGroup>
  <Accordion title="Можно полностью работать без аккаунта?">Да. Не будут доступны official models, cloud libraries и remote access. Со своей моделью и локальными AI tools регистрация действительно не нужна.</Accordion>
  <Accordion title="После входа мои файлы загружаются?">Нет. Только явный Push загружает выбранную cloud library; tunnel пересылает запросы/ответы, но не хранит документы.</Accordion>
  <Accordion title="Сколько компьютеров можно подключить?">Ограничения устройств нет; каждый проходит OAuth и делит один key. Link slots считаются на аккаунт, а не устройство.</Accordion>
  <Accordion title="Можно изменить Username?">Пока нет; при ошибке обратитесь в support. Display name и avatar меняются.</Accordion>
  <Accordion title="Что значит Needs setup / Sign in first?">На этом компьютере нет credentials. Войдите в Settings → Account. Если вход уже был, ключ мог быть отозван/истечь; повторный OAuth заменит его.</Accordion>
  <Accordion title="После выхода облачные библиотеки останутся?">Да. Они появятся снова после входа. Удаление cloud copy выполняется отдельно в library settings → Danger zone.</Accordion>
  <Accordion title="Что делать после исчерпания Free quota?">Окна обновятся автоматически. Можно добавить third-party/local model в Settings → AI: он не тратит квоту Linkly AI.</Accordion>
</AccordionGroup>

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

* [Сервис моделей](/docs/ru/model-service)
* [Облачные библиотеки](/docs/ru/use-cloud-library)
* [Удалённый доступ](/docs/ru/use-in-remote)