Skip to main content

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

Облачное приложение не видит 127.0.0.1 вашего компьютера. Linkly AI создаёт зашифрованный исходящий туннель: запрос к https://mcp.linkly.ai/mcp после авторизации направляется в Desktop, который выполняет поиск локально и возвращает только результат. Это функция Pro. Free тоже может включить Allow remote access (internet), но server отклонит подключение: переключатель автоматически выключится, а статус покажет Pro required. Desktop должен быть запущен, tunnel — подключён. mcp.linkly.ai — relay Linkly AI: данные проходят транзитом анонимно, сохраняются только счётчики usage для Dashboard; документы не хранятся.

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

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

​
Настройка

1

Войдите и подключите Pro

В Settings → Account пройдите OAuth; ключ получается автоматически. При особой необходимости manual lkai_ находится в optional section. Pro оформляется на pricing.
2

Включите удалённый доступ в Desktop

Нажмите значок Agent внизу левой боковой панели главного окна, чтобы открыть страницу Agent usage. В разделе Management включите Allow remote access (internet); Allow local access тоже должен оставаться включённым, иначе этот переключатель не включится. Дождитесь ● Connected. Если показано Not signed in и переключатель выключился, сначала выполните вход (предыдущий шаг). Публичный адрес находится в разделе Integration → View MCP connection settings: в разделе Remote (internet) окна есть адрес и готовая конфигурация для копирования.
3

Добавьте endpoint

В ChatGPT/Claude.ai добавьте https://mcp.linkly.ai/mcp; первый раз автоматически запускается OAuth. Подробности по приложениям: Integration. Для Linkly AI CLI (например, на сервере или в контейнере) выполните там linkly auth login — CLI выведет ссылку, которую можно открыть на любом устройстве, и после авторизации сохранит новый API key; затем добавляйте --remote к командам. Готовый ключ можно сохранить через linkly auth set-key lkai_… — выполняйте эту команду сами, в своём терминале, а не через ИИ-помощника. См. CLI → Удалённый.

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

Статус туннеля показан в строке Allow remote access (internet) и в разделе Remote (internet) окна настроек подключения:

​
OAuth

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

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

  • HTTPS/WSS шифрует передачу; router port открывать не нужно
  • Credentials дают доступ к local knowledge base; не вставляйте ключ ни в какой диалог с ИИ (ChatGPT, Claude, Cursor, Codex, Doubao, Kimi и т. п.) — содержимое диалога отправляется поставщику модели и сохраняется в истории чата. Онлайн-приложения подключаются через OAuth, а ИИ-помощники с CLI — через linkly auth login, копировать ключ не нужно. Если ключ попал в диалог или есть подозрение на утечку, отзовите key и создайте новый
  • Выключение Allow remote access (internet) в Desktop немедленно закрывает tunnel
  • Revoking key запрещает новые connect/reconnect, но уже установленную tunnel session не завершает мгновенно — сначала выключите переключатель
  • Документы остаются локально; relay пересылает tool requests и responses

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

Server вернул HTTP 402. Оформите Pro на pricing и снова включите Allow remote access (internet) либо Push выбранный материал в бесплатную Cloud Library. Даже с Cloud Library явно передавайте library="cloud://owner/slug", иначе запрос уйдёт в Pro tunnel.
Проверьте, что Settings → Account показывает Connected to Linkly AI Cloud; если нет, войдите. Manual key должен быть полным и не отозванным. Создайте новый или sign out/sign in для автоматического получения.
Без Desktop и Connected tunnel relay возвращает 503. Проверьте app, работу службы MCP (на странице Agent usage в строке Allow local access отображается Running) и tunnel. Для работы при выключенном компьютере нужна Cloud Library.
После обрыва он переподключается автоматически без ограничения числа попыток: интервал начинается с 1 секунды и удваивается до максимума 120 секунд, а статус в это время — Connecting. Проверьте сеть/credentials; если не помогает, выключите и снова включите Allow remote access (internet).
Сначала убедитесь, что tunnel Connected и browser уже вошёл на linkly.ai, затем пере-добавьте MCP connector. При повторе удалите старую запись полностью.

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