Agenti IA (Claude, ChatGPT, Gemini, Grok…)
Claude, ChatGPT, Gemini, Grok e gli altri agenti IA cercano, mostrano e riordinano i tuoi file con Folia Files, ogni modifica approvata da te e annullabile.
In questa pagina
Gli agenti IA come Claude (l'app per Mac), ChatGPT, Gemini, Grok, Claude Code, Codex, Cursor o VS Code possono usare Folia Files tramite MCP (il Model Context Protocol). L'agente ragiona; Folia mostra e agisce:
- cerca come Folia: per nome, nel testo dei documenti, in ciò che mostrano le immagini, con i tuoi tag, nei tuoi cloud e server;
- ti mostra ciò che ha trovato in un pannello di Folia, nella vista che preferisci (l'elenco esatto di questi file, o la loro cartella con loro selezionati);
- riordina le tue finestre: salva scene e spazi di lavoro che puoi riaprire quando vuoi;
- propone modifiche (creare cartelle, spostare, copiare, rinominare, assegnare tag, spostare nel Cestino, comprimere, convertire immagini…) in un foglio di Folia: non succede nulla prima che tu approvi, e puoi deselezionare qualsiasi modifica o file;
- tutto si può annullare: niente viene mai sovrascritto (un nome già usato riceve «2»), ciò che viene rimosso va nel Cestino, e ogni modifica è un'operazione di Operazioni firmata con il nome dell'agente, che si annulla con ⌘Z;
- i file solo online in iCloud Drive o in un altro cloud non vengono mai scaricati per un agente.
È disattivato finché non lo attivi, nel tour di benvenuto o in Impostazioni › Agente IA / MCP.
Attivarlo
- Apri Impostazioni › Agente IA / MCP.
- Attiva Consenti agli agenti IA di usare Folia Files.
- Scegli cosa possono fare gli agenti:
| Livello | Cosa può fare l'agente |
|---|---|
| Solo aiuto | leggere la documentazione di Folia; non vede nessuno dei tuoi file |
| Leggere e mostrare | cercare i tuoi file, leggerne le informazioni (nome, dimensione, date, tag; non il contenuto), mostrarli in un pannello, salvare scene e spazi di lavoro |
| Proporre modifiche | tutto questo, e proporre modifiche ai file, che approvi in Folia |
Leggi il contenuto dei documenti è un interruttore a parte, disattivato all'inizio: con questo, un agente può leggere il testo di un PDF, di un documento o di un'immagine (per riassumerlo, per esempio). Ciò che un agente legge viene inviato al fornitore della sua IA.
Cartelle consentite: gli agenti non vedono nient'altro. All'inizio, la tua cartella Inizio (la sua Libreria resta nascosta, tranne iCloud Drive e i cloud; così come i file nascosti al suo livello principale) e gli altri dischi e server. Aggiungi o rimuovi cartelle come preferisci.
Apri Folia Files quando un agente ne ha bisogno: se Folia è chiuso, l'agente lo apre in background.
Connettere un agente
In Impostazioni › Agente IA / MCP › Connetti un agente, scegli il tuo agente nell'elenco: Folia spiega come collegarlo, passo dopo passo, con il pulsante che lo fa. Claude, ChatGPT, Gemini e Grok vengono per primi (anche nel benvenuto).
| Agente | Come |
|---|---|
| Claude (l'app per Mac) | Installa…: Claude chiede di installare l'estensione «Folia Files»; accetta, poi avvia una nuova conversazione |
| ChatGPT (l'app per Mac) | Aggiungi a ChatGPT: Folia si aggiunge ai server MCP di ChatGPT con lo strumento di ChatGPT stesso; esci da ChatGPT e riaprilo |
| Gemini (l'app per Mac) | Copia il comando, poi in Gemini: Personalizza › Connettori › Personalizzata, pannello MCP locale: nome server «Folia Files», ID server «folia», incolla il comando in Comando, poi Connetti. Se Gemini non raggiunge Folia Files: Impostazioni avanzate › Impostazioni sandbox › Accesso completo. Google sta aprendo a poco a poco il pannello MCP locale: se Gemini chiede solo un link, il tuo account non può ancora avviare Folia Files. |
| Grok | l'app Grok accetta solo connettori online: collega Grok Build, l'agente di xAI per il Terminale. Copia la riga, incollala nel Terminale, poi riavvia Grok Build |
| Claude Code | Copia la riga, incollala nel Terminale, poi riavvia Claude Code |
| Codex | Copia la riga, incollala nel Terminale, poi riavvia Codex |
| Cursor | Aggiungi a Cursor, poi conferma in Cursor |
| VS Code | Aggiungi a VS Code, poi conferma in VS Code |
| Altro agente | Copia la configurazione e incollala nelle impostazioni MCP dell'agente («mcpServers») |
Tutti gli agenti avviano lo stesso piccolo programma, folia-mcp, che si trova dentro Folia Files (Folia Files.app/Contents/Helpers/folia-mcp). Parla con Folia solo sul tuo Mac: nessuna porta di rete, niente di raggiungibile da un altro computer.
La prima volta che un'app di un agente usa Folia, Folia ti chiede: Consenti o Rifiuta. Puoi dimenticare un'app in Impostazioni › Agente IA / MCP › Agenti autorizzati: lo chiederà di nuovo.
Cosa puoi chiedere
- «Riordina la mia cartella Download: una cartella per tipo, e i duplicati nel Cestino.»
- «Mostrami le fatture dell'anno scorso.»
- «Crea una scena con le mie cartelle di foto in Mosaico e la Mappa.»
- «Cosa occupa lo spazio sul mio disco esterno?»
- «Confronta queste due cartelle prima che elimini quella vecchia.»
- «Rinomina queste scansioni con la loro data e il nome del negozio.»
Il foglio delle proposte
Quando un agente propone delle modifiche, Folia passa in primo piano con un foglio: il nome dell'agente, la sua spiegazione, poi ogni modifica con i suoi file. Deseleziona una modifica, oppure aprila e deseleziona alcuni file; Mostra i file li apre prima in un pannello. Applica esegue ciò che è selezionato; Rifiuta non esegue nulla. L'agente viene a sapere cosa è stato fatto, file per file.
Una proposta ti aspetta 15 minuti; dopo, viene abbandonata.
Cosa hanno fatto gli agenti
Impostazioni › Agente IA / MCP › Cosa hanno fatto elenca le ultime richieste degli agenti (in memoria, finché Folia non viene chiuso). Le loro modifiche sono anche in Operazioni, con il nome dell'agente, come tutte le altre.
Gli strumenti degli agenti
| Strumento | Livello |
|---|---|
search_docs, read_doc, list_docs: la documentazione | Solo aiuto |
get_context (ciò che stai guardando), list_folder, get_info, search_files, list_places, recent_items, recent_operations, get_shelf | Leggere e mostrare |
show_files, open_folder, open_scene, open_workspace, create_scene, create_workspace, add_to_shelf | Leggere e mostrare |
disk_usage, find_duplicates, compare_folders, mac_health, read_note, connect, open_tool | Leggere e mostrare |
propose_changes, undo_operation, add_note, run_saved_job | Proporre modifiche |
read_text | Leggi il contenuto dei documenti |
open_tool prepara uno degli strumenti di Folia (azioni in blocco su immagini e video, PDF, rinomina in blocco, duplicati, confronto) che controlli e avvii tu. run_saved_job esegue uno dei tuoi backup, delle tue sincronizzazioni o delle tue regole, dopo la tua conferma.
Privacy
- Ciò che un agente vede dei tuoi file (nomi, cartelle, informazioni, e il testo se l'hai consentito) viene inviato al fornitore di IA di quell'agente. Folia, invece, non invia nulla da nessuna parte.
- Gli agenti vedono solo le cartelle consentite, mai i dati privati della tua Libreria, mai i file nascosti al livello principale della tua cartella Inizio.
- I file del cloud solo online non vengono mai scaricati per un agente.
Senza l'app: la documentazione per qualsiasi assistente
La documentazione di Folia è anche un server MCP sul web, senza account: aggiungi https://foliafiles.com/mcp al tuo assistente (Claude: Impostazioni › Connettori › Aggiungi connettore personalizzato) e chiedigli come fare qualcosa in Folia Files. Legge solo questa documentazione.
Se non funziona
L'agente dice perché:
- «Access for AI agents is off»: attivalo in Impostazioni › Agente IA / MCP.
- «Folia Files is not open»: aprilo, oppure attiva Apri Folia Files quando un agente ne ha bisogno.
- «The user did not allow this app»: l'app è stata rifiutata; dimenticala in Agenti autorizzati e accetta la prossima volta.
- «… is outside the folders Folia Files lets agents use»: aggiungi la cartella in Cartelle consentite.