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

> Безопасно подключайте ChatGPT, Claude.ai и другие облачные приложения к локальной базе через публичный туннель и OAuth. Функция доступна в Pro.

## Что такое удалённый доступ

Облачное приложение не видит `127.0.0.1` вашего компьютера. Linkly AI создаёт зашифрованный исходящий туннель: запрос к `https://mcp.linkly.ai/mcp` после авторизации направляется в Desktop, который выполняет поиск локально и возвращает только результат.

Это функция **Pro**. Free может нажать Connect, но server отклонит handshake и покажет **Upgrade Required** / `Remote access requires a Pro subscription.` Desktop должен быть запущен, tunnel — подключён.

`mcp.linkly.ai` — relay Linkly AI: данные проходят транзитом анонимно, сохраняются только счётчики usage для Dashboard; документы не хранятся.

## Какой способ выбрать

| Свойство          | Remote tunnel               | Cloud Library              |
| ----------------- | --------------------------- | -------------------------- |
| Что читает        | Все indexed docs компьютера | Только явно pushed library |
| Компьютер включён | Обязательно                 | Нет                        |
| Где контент       | Только локально             | Копия в cloud              |
| Sharing           | Нет                         | Invitation/Public          |
| Plan              | Pro                         | Free                       |

Локальный клиент на том же компьютере должен использовать бесплатный и быстрый `127.0.0.1`; оба облачных способа можно использовать одновременно.

## Настройка

<Steps>
  <Step title="Войдите и подключите Pro">В **Settings → Account** пройдите OAuth; ключ получается автоматически. При особой необходимости manual `lkai_` находится в optional section. Pro оформляется на [pricing](https://linkly.ai/pricing).</Step>
  <Step title="Подключите tunnel">В **Settings → MCP → Remote Access** раскройте toggle, нажмите **Connect Tunnel** и дождитесь <Badge stroke color="green">● Connected</Badge>. Без входа UI прямо предложит Open Account settings.</Step>
  <Step title="Добавьте endpoint">В ChatGPT/Claude.ai добавьте `https://mcp.linkly.ai/mcp`; первый раз автоматически запускается OAuth. Подробности по приложениям: [Integration](/docs/ru/integration).</Step>
</Steps>

## Состояния соединения

| Состояние                | Значение                                          |
| ------------------------ | ------------------------------------------------- |
| Disconnected             | Туннель выключен или не запущен                   |
| Connecting               | Выполняется подключение                           |
| Connected                | Удалённые запросы могут поступать в Desktop       |
| Reconnecting (attempt N) | Автоматический exponential backoff, до 10 попыток |
| Auth Error               | Нет входа либо key отозван                        |
| Upgrade Required         | Аккаунт не Pro; показана ссылка upgrade           |
| Error                    | Другая причина рядом со статусом                  |

## OAuth

Клиент обнаруживает требование authorization, переводит на linkly.ai, после входа и подтверждения получает access token и автоматически прикладывает его дальше. Повторный OAuth не нужен; активный browser sign-in ускоряет процесс.

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

* HTTPS/WSS шифрует передачу; router port открывать не нужно
* Credentials дают доступ к local knowledge base; при подозрении отзовите key и создайте новый
* Desktop Disconnect немедленно закрывает tunnel
* Revoking key запрещает новые connect/reconnect, но уже установленную tunnel session не завершает мгновенно — сначала Disconnect
* Документы остаются локально; relay пересылает tool requests и responses

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

<AccordionGroup>
  <Accordion title="Upgrade Required">Server вернул HTTP 402. Оформите Pro либо Push выбранный материал в бесплатную Cloud Library. Даже с Cloud Library явно передавайте `library="cloud://owner/slug"`, иначе запрос уйдёт в Pro tunnel.</Accordion>
  <Accordion title="Auth Error">Проверьте **Connected to Linkly AI Cloud**. Manual key должен быть полным и не отозванным. Создайте новый или sign out/sign in для автоматического получения.</Accordion>
  <Accordion title="Desktop offline, remote даёт error">Без Desktop и Connected tunnel relay возвращает 503. Проверьте app, MCP status Running и tunnel. Для работы при выключенном компьютере нужна Cloud Library.</Accordion>
  <Accordion title="Tunnel постоянно падает">Он делает до 10 retries с exponential backoff. Проверьте сеть/credentials; затем Disconnect и Connect вручную.</Accordion>
  <Accordion title="OAuth failed">Сначала убедитесь, что tunnel Connected и browser уже вошёл на linkly.ai, затем пере-добавьте MCP connector. При повторе удалите старую запись полностью.</Accordion>
</AccordionGroup>

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

* [Обзор интеграций](/docs/ru/integration)
* [Облачные библиотеки](/docs/ru/use-cloud-library)
* [Аккаунт Linkly AI](/docs/ru/linkly-account)