Collegamenti locali nell'app desktop
L'app desktop può avviare server MCP locali tramite stdio. In questo modo l'AI ha accesso a funzionalità più estese di Google e Microsoft, Nextcloud e altri strumenti che un browser non può eseguire. L'accesso ai file locali è integrato e non richiede un server MCP.
Onboarding
Durante la prima configurazione segui questi passaggi:
- Scegli una cartella predefinita locale per gli strumenti file integrati.
- Puoi eventualmente scegliere un collegamento locale per Nextcloud.
- Puoi eventualmente aggiungere altri server MCP dal negozio di strumenti.
Puoi posticipare l'intero onboarding. La cartella predefinita e i collegamenti aggiuntivi possono essere impostati in seguito. Tutte le scelte di cartelle vengono salvate solo localmente.
Il negozio di strumenti
Clicca su Aggiungi strumenti o Aggiungi server MCP. Vedrai prima preset sicuri adatti all'app desktop. Solo scegliendo Aggiungi un server MCP manualmente si apre il modulo manuale.
Preset molto usati sono ad esempio:
| Preset | Funzionalità | Autenticazione |
|---|---|---|
| Nextcloud | File, calendario e contatti | Indirizzo server, nome utente e password app |
| Memory | Conservare e ritrovare conoscenza | Archiviazione locale |
Il negozio può inoltre mostrare preset per servizi come GitHub, Canva, Notion, Supabase, Mailchimp e altri server MCP adatti. La disponibilità dipende da piattaforma, autenticazione e catalogo attuale.
Google e Microsoft
Google Workspace e Microsoft 365 sono collegamenti AI-School integrati. Funzionano su web, mobile e desktop e non dipendono da OpenAI o da un preset MCP locale. Dopo il consenso una tantum di Google o Microsoft, gli strumenti disponibili possono essere usati con OpenAI, Claude, Gemini e Mistral, nella misura in cui il modello scelto supporta l'uso di strumenti.
Selezione dinamica degli strumenti
Un server MCP può offrire decine di strumenti. Perciò il Desktop Deep Agent carica prima informazioni compatte sugli strumenti e seleziona durante il compito quelli rilevanti. Così più grandi server MCP possono essere attivi senza inserire tutti gli strumenti contemporaneamente nel contesto del modello.
Installazione sicura
L'installazione MCP locale ha un confine rigoroso tra l'interfaccia Angular ed Electron:
- il renderer non avvia comandi shell liberi;
- comando, argomenti, environment keys e accessi richiesti sono controllati;
- un dialog nativo mostra cosa viene avviato;
- configurazioni approvate ricevono una prova di integrità;
- i segreti sono criptati con l'archiviazione sicura del sistema operativo;
- i processi si fermano allo spegnimento, rimozione, logout e chiusura.
Se rimuovi un server, anche le credenziali salvate localmente vengono eliminate.
Stato e test
Sotto Su questo computer vedi tutti i server locali attivi in un unico posto. Nelle impostazioni chat i collegamenti locali e remoti sono insieme sotto Collegamenti.
Testa un server con una domanda concreta, ad esempio:
- “Quali cartelle ci sono nel mio Nextcloud?”
- “Cerca le ultime email sul progetto.”
- “Quali file ci sono in questa cartella locale?”
In caso di problemi controlla il log desktop. Una connessione riuscita indica il nome del server e il numero di strumenti caricati.
Risoluzione problemi
- Server attivo ma l'AI non vede strumenti: riavvia il runtime locale e verifica che l'ID server sia nella richiesta chat.
- Autenticazione mancante: apri il server in Preferenze → Strumenti e scegli riconnetti.
- Nextcloud non funziona: usa l'URL base dell'ambiente Nextcloud e una password app separata.
- File locali non accessibili: verifica che la cartella di lavoro attiva esista ancora e, se necessario, selezionala di nuovo dal dashboard.
- Troppi strumenti: lascia attiva la selezione dinamica degli strumenti e indica chiaramente nella domanda quale fonte serve.
Aggiungere un server stdio manualmente
Preferisci un preset. Aggiungi un server manualmente solo se conosci e ti fidi della provenienza e del comando. Controlla prima dell'approvazione:
- eseguibile e argomenti;
- environment keys;
- accesso al filesystem;
- capacità di lettura e scrittura.
Vedi anche
Accesso alle cartelle locali
Gli strumenti file integrati possono solo leggere o modificare file all'interno della cartella di lavoro che approvi esplicitamente tramite il selettore di cartelle nativo.
Ogni percorso viene risolto alla posizione canonica. Trucchi con prefissi simili di una cartella adiacente e link simbolici che escono da una cartella approvata vengono rifiutati. Dopo un riavvio del runtime locale i permessi vengono risincronizzati; senza cartella approvata l'accesso ai file è negato di default.
Se chiedi all'AI di eliminare un file o una sottocartella, l'app desktop sposta l'elemento nel cestino di sistema. Questo funziona su Windows, macOS e Linux. La cartella principale approvata non può essere spostata nel cestino tramite l'AI.
