Agents IA (Claude, ChatGPT, Gemini, Grok…)
Laissez Claude, ChatGPT, Gemini, Grok et les autres agents IA chercher, montrer et ranger vos fichiers par Folia Files, chaque changement validé par vous et annulable.
Sur cette page
Les agents IA comme Claude (l'app pour Mac), ChatGPT, Gemini, Grok, Claude Code, Codex, Cursor ou VS Code peuvent utiliser Folia Files par MCP (le Model Context Protocol). L'agent réfléchit, Folia montre et fait :
- il cherche comme Folia : par le nom, par le texte des documents, par ce que montrent les images, avec vos étiquettes, dans vos clouds et vos serveurs ;
- il vous montre ce qu'il a trouvé dans un onglet de Folia, dans la vue que vous aimez (la liste de ces fichiers exactement, ou leur dossier avec eux choisis) ;
- il range vos fenêtres : il enregistre des scènes et des espaces de travail que vous rouvrez quand vous voulez ;
- il propose des changements (créer des dossiers, déplacer, copier, renommer, étiqueter, mettre à la corbeille, compresser, convertir des images…) dans une feuille de Folia : rien n'est fait avant que vous validiez, et vous décochez ce que vous voulez ;
- tout s'annule : rien n'est jamais écrasé (un nom pris reçoit « 2 »), ce qui part va à la corbeille, et chaque changement est une opération d'Opérations signée du nom de l'agent, annulée avec ⌘Z ;
- un fichier resté en ligne dans iCloud Drive ou un autre cloud n'est jamais téléchargé pour un agent.
C'est coupé tant que vous ne l'activez pas, dans l'accueil ou dans Réglages › Agent IA / MCP.
L'activer
- Ouvrez Réglages › Agent IA / MCP.
- Activez Permettre aux agents IA d'utiliser Folia Files.
- Choisissez ce que les agents peuvent faire :
| Niveau | Ce que peut faire l'agent |
|---|---|
| Aide seulement | lire la documentation de Folia ; il ne voit aucun de vos fichiers |
| Lire et montrer | chercher vos fichiers, lire leurs informations (nom, taille, dates, étiquettes ; pas leur contenu), les montrer dans un onglet, enregistrer des scènes et des espaces de travail |
| Proposer des changements | tout cela, et proposer des changements que vous validez dans Folia |
Lire le contenu des documents est un interrupteur à part, coupé au départ : avec lui, un agent peut lire le texte d'un PDF, d'un document ou d'une image (pour le résumer, par exemple). Ce qu'un agent lit part chez le fournisseur de son IA.
Dossiers permis : les agents ne voient rien ailleurs. Au départ votre dossier personnel (sa Bibliothèque reste cachée, sauf iCloud Drive et les clouds, comme les fichiers cachés à sa racine) et les autres disques et serveurs. Ajoutez ou retirez des dossiers comme vous voulez.
Ouvrir Folia Files quand un agent en a besoin : Folia fermé, l'agent l'ouvre en arrière-plan.
Connecter un agent
Dans Réglages › Agent IA / MCP › Connecter un agent, choisissez votre agent dans la liste : Folia explique comment le connecter, étape par étape, avec le bouton qui le fait. Claude, ChatGPT, Gemini et Grok viennent en premier (dans l'accueil aussi).
| Agent | Comment |
|---|---|
| Claude (l'app pour Mac) | Installer… : Claude demande d'installer l'extension « Folia Files » ; acceptez, puis ouvrez une nouvelle conversation |
| ChatGPT (l'app pour Mac) | Ajouter à ChatGPT : Folia s'ajoute aux serveurs MCP de ChatGPT par l'outil de ChatGPT lui-même ; quittez ChatGPT et rouvrez-le |
| Gemini (l'app pour Mac) | Copier la commande, puis dans Gemini : Personnaliser › Connecteurs › Personnalisée, onglet MCP local : nom du serveur « Folia Files », ID du serveur « folia », collez la commande dans Commande, puis Connecter. Si Gemini ne joint pas Folia Files : Paramètres avancés › Paramètres du bac à sable › Accès total. Google ouvre peu à peu l'onglet MCP local : si Gemini ne demande qu'un lien, votre compte ne peut pas encore lancer Folia Files. |
| Grok | l'app Grok n'accepte que des connecteurs en ligne : connectez Grok Build, l'agent de xAI pour le Terminal. Copier la ligne, collez-la dans le Terminal, puis relancez Grok Build |
| Claude Code | Copier la ligne, collez-la dans le Terminal, puis relancez Claude Code |
| Codex | Copier la ligne, collez-la dans le Terminal, puis relancez Codex |
| Cursor | Ajouter à Cursor, puis confirmez dans Cursor |
| VS Code | Ajouter à VS Code, puis confirmez dans VS Code |
| Autre agent | Copier la configuration et collez-la dans ses réglages MCP (« mcpServers ») |
Tous les agents lancent le même petit programme, folia-mcp, rangé dans Folia Files (Folia Files.app/Contents/Helpers/folia-mcp). Il parle à Folia sur votre Mac seulement : aucun port réseau, rien de joignable depuis un autre ordinateur.
La première fois qu'une app d'agent utilise Folia, Folia vous demande : Autoriser ou Refuser. Vous oubliez une app dans Réglages › Agent IA / MCP › Agents autorisés : elle redemandera.
Ce que vous pouvez demander
- « Range mon dossier Téléchargements : un dossier par type, et les doublons à la corbeille. »
- « Montre-moi les factures de l'an dernier. »
- « Fais une scène avec mes dossiers de photos en Mosaïque et la Carte. »
- « Qu'est-ce qui prend la place sur mon disque externe ? »
- « Compare ces deux dossiers avant que je supprime l'ancien. »
- « Renomme ces scans avec leur date et le nom du magasin. »
La feuille des propositions
Quand un agent propose des changements, Folia passe devant avec une feuille : le nom de l'agent, son explication, puis chaque changement avec ses fichiers. Décochez un changement, ou ouvrez-le et décochez des fichiers ; Montrer les fichiers les ouvre d'abord dans un onglet. Appliquer fait ce qui est coché ; Refuser ne fait rien. L'agent apprend ce qui a été fait, fichier par fichier.
Une proposition vous attend 15 minutes ; au-delà, elle est abandonnée.
Ce qu'ils ont fait
Réglages › Agent IA / MCP › Ce qu'ils ont fait liste les dernières demandes des agents (en mémoire, jusqu'à ce que Folia quitte). Leurs changements sont aussi dans Opérations, avec le nom de l'agent, comme les autres.
Les outils des agents
| Outil | Niveau |
|---|---|
search_docs, read_doc, list_docs : la documentation | Aide seulement |
get_context (ce que vous regardez), list_folder, get_info, search_files, list_places, recent_items, recent_operations, get_shelf | Lire et montrer |
show_files, open_folder, open_scene, open_workspace, create_scene, create_workspace, add_to_shelf | Lire et montrer |
disk_usage, find_duplicates, compare_folders, mac_health, read_note, connect, open_tool | Lire et montrer |
propose_changes, undo_operation, add_note, run_saved_job | Proposer des changements |
read_text | Lire le contenu des documents |
open_tool prépare un outil de Folia (actions groupées sur les images et les vidéos, PDF, renommage par lot, doublons, comparaison) que vous vérifiez et lancez vous-même. run_saved_job lance une de vos sauvegardes, synchronisations ou règles, après votre accord.
Vie privée
- Ce qu'un agent voit de vos fichiers (noms, dossiers, informations, et le texte si vous l'avez permis) part chez le fournisseur de son IA. Folia, lui, n'envoie rien nulle part.
- Les agents ne voient que les dossiers permis, jamais les données privées de votre Bibliothèque, jamais les fichiers cachés à la racine de votre dossier personnel.
- Un fichier resté en ligne dans un cloud n'est jamais téléchargé pour un agent.
Sans l'app : la documentation pour n'importe quel assistant
La documentation de Folia est aussi un serveur MCP sur le web, sans compte : ajoutez https://foliafiles.com/mcp à votre assistant (Claude : Réglages › Connecteurs › Ajouter un connecteur personnalisé) et demandez-lui comment faire quelque chose dans Folia Files. Il ne lit que cette documentation.
Si ça ne marche pas
L'agent dit pourquoi :
- « Access for AI agents is off » : activez-le dans Réglages › Agent IA / MCP.
- « Folia Files is not open » : ouvrez-le, ou activez Ouvrir Folia Files quand un agent en a besoin.
- « The user did not allow this app » : l'app a été refusée ; oubliez-la dans Agents autorisés et acceptez la prochaine fois.
- « … is outside the folders Folia Files lets agents use » : ajoutez le dossier dans Dossiers permis.