Локальні підключення в десктоп-додатку
Десктоп-додаток може запускати локальні 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?»
- «Знайди останні листи про проєкт.»
- «Які файли є в цій локальній папці?»
При проблемах перевірте лог десктоп-додатку. Успішне підключення вказує ім’я сервера та кількість завантажених інструментів.
Вирішення проблем
- Сервер активний, але ШІ не бачить інструментів: перезапустіть локальний runtime і перевірте, чи є ID сервера в запиті чату.
- Відсутня авторизація: відкрийте сервер у Налаштування → Інструменти і виберіть повторне підключення.
- Nextcloud не працює: використовуйте базову URL-адресу середовища Nextcloud і окремий пароль додатку.
- Локальні файли недоступні: перевірте, чи існує активна робоча папка, і за потреби виберіть її заново через панель керування.
- Занадто багато інструментів: увімкніть динамічний вибір інструментів і чітко вказуйте у запиті потрібне джерело.
Додати stdio-сервер вручну
Краще використовувати пресет. Додавайте сервер вручну лише якщо довіряєте походженню та команді. Перед затвердженням перевірте:
- виконуваний файл і аргументи;
- ключі середовища;
- доступ до файлової системи;
- можливості читання і запису.
Див. також
Доступ до локальних папок
Вбудовані інструменти роботи з файлами можуть лише читати або змінювати файли в робочій папці, яку ви явно затвердили через нативний вибір папки.
Кожен шлях приводиться до канонічного розташування. Трюки з подібним префіксом сусідньої папки та символічні посилання, які виходять за межі затвердженої папки, відхиляються. Після перезапуску локального runtime права синхронізуються заново; без затвердженої папки доступ до файлів за замовчуванням заборонено.
Якщо ви попросите ШІ видалити файл або підпапку, десктоп-додаток перемістить елемент у системне сміття. Це працює на Windows, macOS і Linux. Затверджену головну папку через ШІ перемістити до сміття не можна.
