Accesso locale ai file

L'applicazione desktop ha accesso diretto ai file sul tuo computer, permettendoti di utilizzare documenti locali nelle tue AI-workflow.

Configurare una cartella

Per lavorare con i file locali, devi prima scegliere una cartella:

1. Apri la Dashboard
2. Cerca sul lato destro la sezione File locali
3. Clicca per scegliere una cartella sul tuo computer
4. La cartella scelta rimane disponibile sulla dashboard

Più cartelle

Puoi aggiungere più cartelle. Le cartelle scelte precedentemente rimangono disponibili per essere selezionate dalla dashboard.

Funzioni disponibili

L'accesso ai file utilizza @modelcontextprotocol/server-filesystem e offre le seguenti possibilità:

Lettura dei file

Funzione	Descrizione
read_text_file	Legge l'intero contenuto di un file di testo. Opzionale: solo le prime o ultime N righe.
read_media_file	Legge un'immagine o un file audio (ritornato come base64).
read_multiple_files	Legge più file contemporaneamente. Letture fallite non interrompono l'operazione.

Scrittura e modifica dei file

Funzione	Descrizione
write_file	Crea un nuovo file o sovrascrive un file esistente.
edit_file	Esegue modifiche selettive con riconoscimento avanzato dei pattern. Supporta dry-run per anteprime delle modifiche.

Gestione delle cartelle

Funzione	Descrizione
create_directory	Crea una nuova cartella (inclusi eventuali genitori se necessario).
list_directory	Mostra il contenuto di una cartella con prefissi [FILE] o [DIR].
list_directory_with_sizes	Mostra il contenuto della cartella inclusi dimensioni dei file e statistiche.
directory_tree	Ottieni una struttura ad albero JSON ricorsiva del contenuto della cartella.

Ricerca e spostamento dei file

Funzione	Descrizione
search_files	Cerca ricorsivamente file/cartelle che corrispondono o non corrispondono a modelli.
move_file	Sposta o rinomina file e cartelle.
get_file_info	Ottieni metadati dettagliati (dimensione, data di creazione, permessi, ecc.).

Altro

Funzione	Descrizione
list_allowed_directories	Mostra tutte le cartelle a cui l'applicazione ha accesso.

Tipi di file supportati

Puoi creare e modificare file di testo. I formati più utili sono:

Testo semplice (.txt)

File di testo senza formattazione.

Le mie note di oggi:
- Riunione alle 14:00
- Scadenza progetto venerdì
- Idea per presentazione da sviluppare

Pratico per:

• Note rapide
• Elenchi semplici
• Annotazioni temporanee

Markdown (.md)

File di testo con formattazione leggera, facilmente leggibile ovunque.

# Appunti della riunione

## Argomenti
- **Budget** discussione
- Pianificazione Q2
- Nuovi membri del team

## Azioni
1. Completare il rapporto
2. Inviare email al cliente
3. Preparare la presentazione

Pratico per:

• Documenti strutturati
• Documentazione
• Appunti con intestazioni e formattazione
• README dei progetti

Esempi di utilizzo

Prendere appunti

"Crea un nuovo file notes-riunione.md con i seguenti punti discussi..."

L'IA crea il file nella cartella scelta con una formattazione ordinata.

Gestione delle liste

"Aggiungi 'fare la spesa' al mio file todo.txt"

L'IA può leggere e ampliare le liste esistenti.

Analisi dei documenti

"Leggi tutti i file Markdown nella cartella docs e crea un riassunto"

L'IA legge più file e combina le informazioni.

Organizzazione dei file

"Trova tutti i file .txt in questa cartella e spostali in una sottocartella 'archivio'"

L'IA può cercare file, creare cartelle e spostare file.

Sicurezza e privacy

• Cartelle selezionate solo - L'applicazione ha accesso solo alle cartelle che hai esplicitamente selezionato
• Elaborazione locale - I file vengono letti localmente, non caricati su server esterni
• Controllo completo - Decidi quali cartelle sono accessibili