Lokalne powiązania w aplikacji desktopowej
Aplikacja desktopowa może uruchamiać lokalne serwery MCP przez stdio. Dzięki temu AI ma dostęp do rozszerzonych funkcji Google i Microsoft, Nextcloud oraz innych narzędzi, których przeglądarka nie może wykonać. Wbudowany jest dostęp do lokalnych plików i nie wymaga serwera MCP.
Onboarding
Podczas pierwszej konfiguracji przejdziesz przez następujące kroki:
- Wybierasz lokalny folder domyślny dla wbudowanych narzędzi plikowych.
- Opcjonalnie możesz wybrać lokalne powiązanie dla Nextcloud.
- Opcjonalnie możesz dodać inne serwery MCP z sklepu z narzędziami.
Możesz odłożyć cały onboarding na później. Folder domyślny i ewentualne dodatkowe powiązania możesz ustawić później. Wszystkie wybory folderów są przechowywane wyłącznie lokalnie.
Sklep z narzędziami
Kliknij Dodaj narzędzia lub Dodaj serwer MCP. Najpierw zobaczysz bezpieczne presety dopasowane do aplikacji desktopowej. Dopiero po wybraniu Dodaj własny serwer MCP otworzy się formularz ręczny.
Popularne presety to między innymi:
| Preset | Możliwości | Logowanie |
|---|---|---|
| Nextcloud | Pliki, kalendarz i kontakty | Adres serwera, nazwa użytkownika i hasło aplikacji |
| Memory | Zachowywanie i późniejsze odnajdywanie wiedzy | Lokalna pamięć |
Sklep może również wyświetlać presety dla usług takich jak GitHub, Canva, Notion, Supabase, Mailchimp i innych odpowiednich serwerów MCP. Dostępność zależy od platformy, uwierzytelniania i aktualnego katalogu.
Google i Microsoft
Google Workspace i Microsoft 365 to wbudowane powiązania AI-School. Działają na webie, urządzeniach mobilnych i desktopie i nie zależą od OpenAI ani lokalnego presetu MCP. Po jednokrotnej zgodzie Google lub Microsoft dostępne narzędzia mogą być używane z OpenAI, Claude, Gemini i Mistral, o ile wybrany model wspiera użycie narzędzi.
Dynamiczny wybór narzędzi
Serwer MCP może oferować dziesiątki narzędzi. Desktop Deep Agent najpierw ładuje kompaktowe informacje o narzędziach i wybiera podczas zadania odpowiednie narzędzia. Dzięki temu wiele dużych serwerów MCP może działać jednocześnie bez umieszczania wszystkich narzędzi w kontekście modelu.
Bezpieczna instalacja
Lokalna instalacja MCP ma ścisłą granicę między interfejsem Angular a Electronem:
- renderer nie uruchamia dowolnych poleceń powłoki;
- polecenia, argumenty, klucze środowiskowe i żądany dostęp są kontrolowane;
- natywny dialog pokazuje, co jest uruchamiane;
- zatwierdzone konfiguracje otrzymują dowód integralności;
- sekrety są szyfrowane za pomocą bezpiecznego magazynu systemu operacyjnego;
- procesy zatrzymują się przy wyłączaniu, usuwaniu, wylogowaniu i zamykaniu.
Po usunięciu serwera usuwane są również lokalnie zapisane dane uwierzytelniające.
Status i testowanie
Pod Na tym komputerze zobaczysz wszystkie aktywne lokalne serwery w jednym miejscu. W ustawieniach czatu lokalne i zdalne powiązania są razem pod Powiązania.
Przetestuj serwer konkretnym pytaniem, na przykład:
- „Jakie foldery są w moim Nextcloud?”
- „Znajdź ostatnie e-maile dotyczące projektu.”
- „Jakie pliki są w tym lokalnym folderze?”
W przypadku problemów sprawdź logi desktopowe. Udane połączenie wyświetla nazwę serwera i liczbę załadowanych narzędzi.
Rozwiązywanie problemów
- Serwer jest aktywny, ale AI nie widzi narzędzi: zrestartuj lokalne środowisko uruchomieniowe i sprawdź, czy ID serwera jest w żądaniu czatu.
- Brak logowania: otwórz serwer w Preferencje → Narzędzia i wybierz ponownie połącz.
- Nextcloud nie działa: użyj podstawowego URL środowiska Nextcloud i osobnego hasła aplikacji.
- Lokalne pliki są niedostępne: sprawdź, czy aktywny folder roboczy nadal istnieje i w razie potrzeby wybierz go ponownie przez dashboard.
- Za dużo narzędzi: pozostaw dynamiczny wybór narzędzi włączony i jasno określ w pytaniu, które źródło jest potrzebne.
Dodawanie własnego serwera stdio
Preferuj preset. Dodawaj serwer ręcznie tylko jeśli ufasz pochodzeniu i poleceniu. Przed zatwierdzeniem sprawdź:
- plik wykonywalny i argumenty;
- klucze środowiskowe;
- dostęp do systemu plików;
- możliwości odczytu i zapisu.
Zobacz także
Dostęp do lokalnych folderów
Wbudowane narzędzia plikowe mogą czytać lub modyfikować pliki tylko w folderze roboczym, który wyraźnie zatwierdzisz przez natywny wybór folderu.
Każda ścieżka jest sprowadzana do lokalizacji kanonicznej. Sztuczki z podobnym prefiksem sąsiedniego folderu oraz dowiązania symboliczne wychodzące poza zatwierdzony folder są odrzucane. Po restarcie lokalnego środowiska uruchomieniowego prawa są synchronizowane ponownie; bez zatwierdzonego folderu dostęp do plików jest domyślnie odmawiany.
Jeśli poprosisz AI o usunięcie pliku lub podfolderu, aplikacja desktopowa przeniesie element do systemowego kosza. Działa to na Windows, macOS i Linux. Sam zatwierdzony folder główny nie może być przeniesiony do kosza przez AI.
