Локальные подключения в десктопном приложении
Десктопное приложение может запускать локальные MCP-серверы через stdio. Это даёт ИИ доступ к расширенным функциям Google и Microsoft, Nextcloud и другим инструментам, которые браузер выполнить не может. Локальный доступ к файлам встроен и не требует MCP-сервера.
Введение
При первой настройке вы проходите следующие шаги:
- Вы выбираете локальную папку по умолчанию для встроенных файловых инструментов.
- При необходимости можно выбрать локальное подключение к Nextcloud.
- При необходимости можно добавить другие MCP-серверы из магазина инструментов.
Вы можете отложить весь процесс введения. Папку по умолчанию и дополнительные подключения можно настроить позже. Все выборы папок сохраняются только локально.
Магазин инструментов
Нажмите Добавить инструменты или Добавить MCP-сервер. Сначала вы увидите безопасные пресеты, подходящие для десктопного приложения. Только при выборе Добавить MCP-сервер вручную откроется форма для ручного ввода.
Часто используемые пресеты включают:
| Пресет | Возможности | Авторизация |
|---|---|---|
| Nextcloud | Файлы, календарь и контакты | Адрес сервера, имя пользователя и пароль приложения |
| Memory | Сохранение и последующий поиск знаний | Локальное хранилище |
Магазин также может показывать пресеты для сервисов, таких как GitHub, Canva, Notion, Supabase, Mailchimp и других подходящих MCP-серверов. Доступность зависит от платформы, аутентификации и актуального каталога.
Google и Microsoft
Google Workspace и Microsoft 365 — встроенные подключения AI-School. Они работают в вебе, на мобильных устройствах и в десктопе и не зависят от OpenAI или локального MCP-пресета. После однократного разрешения Google или Microsoft доступные инструменты можно использовать с OpenAI, Claude, Gemini и Mistral, если выбранная модель поддерживает использование инструментов.
Динамический выбор инструментов
MCP-сервер может предлагать десятки инструментов. Поэтому Desktop Deep Agent сначала загружает компактную информацию об инструментах и выбирает релевантные инструменты во время выполнения задачи. Так несколько крупных MCP-серверов могут работать одновременно, не помещая все инструменты сразу в контекст модели.
Безопасная установка
Локальная установка MCP строго разделяет интерфейс Angular и Electron:
- рендерер не запускает произвольные shell-команды;
- команды, аргументы, ключи окружения и запрашиваемый доступ проверяются;
- нативный диалог показывает, что запускается;
- одобренные конфигурации получают доказательство целостности;
- секреты шифруются с помощью защищённого хранилища ОС;
- процессы останавливаются при выключении, удалении, выходе из системы и закрытии.
При удалении сервера также удаляются локально сохранённые учётные данные.
Статус и тестирование
В разделе На этом компьютере отображаются все активные локальные серверы в одном месте. В настройках чата локальные и удалённые подключения собраны вместе в разделе Подключения.
Проверьте сервер с конкретным запросом, например:
- «Какие папки есть в моём Nextcloud?»
- «Найдите последние письма по проекту.»
- «Какие файлы находятся в этой локальной папке?»
При проблемах проверьте лог десктопа. Успешное соединение указывает имя сервера и количество загруженных инструментов.
Устранение проблем
- Сервер активен, но ИИ не видит инструменты: перезапустите локальное окружение и проверьте, есть ли ID сервера в запросе чата.
- Отсутствует авторизация: откройте сервер в Настройки → Инструменты и выберите повторное подключение.
- Nextcloud не работает: используйте базовый URL окружения Nextcloud и отдельный пароль приложения.
- Локальные файлы недоступны: проверьте, существует ли активная рабочая папка, и при необходимости выберите её заново через панель управления.
- Слишком много инструментов: оставьте включённым динамический выбор инструментов и чётко указывайте в запросе, какой источник нужен.
Добавление stdio-сервера вручную
Предпочтительно использовать пресет. Добавляйте сервер вручную только если доверяете источнику и команде. Перед одобрением проверьте:
- исполняемый файл и аргументы;
- ключи окружения;
- доступ к файловой системе;
- права на чтение и запись.
См. также
Доступ к локальным папкам
Встроенные файловые инструменты могут читать или изменять файлы только внутри рабочей папки, которую вы явно одобрили через нативный выбор папки.
Каждый путь приводится к каноническому расположению. Хитрости с похожим префиксом соседней папки и символические ссылки, выходящие за пределы одобренной папки, отклоняются. После перезапуска локального окружения права синхронизируются заново; без одобренной папки доступ к файлам по умолчанию запрещён.
Если вы просите ИИ удалить файл или подпапку, десктопное приложение перемещает элемент в системную корзину. Это работает на Windows, macOS и Linux. Одобренную главную папку нельзя переместить в корзину через ИИ.
