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.

Version du site seulement Depuis Folia Files 1.5

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

  1. Ouvrez Réglages › Agent IA / MCP.
  2. Activez Permettre aux agents IA d'utiliser Folia Files.
  3. Choisissez ce que les agents peuvent faire :
NiveauCe que peut faire l'agent
Aide seulementlire la documentation de Folia ; il ne voit aucun de vos fichiers
Lire et montrerchercher 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 changementstout 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).

AgentComment
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.
Grokl'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 CodeCopier la ligne, collez-la dans le Terminal, puis relancez Claude Code
CodexCopier la ligne, collez-la dans le Terminal, puis relancez Codex
CursorAjouter à Cursor, puis confirmez dans Cursor
VS CodeAjouter à VS Code, puis confirmez dans VS Code
Autre agentCopier 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

OutilNiveau
search_docs, read_doc, list_docs : la documentationAide seulement
get_context (ce que vous regardez), list_folder, get_info, search_files, list_places, recent_items, recent_operations, get_shelfLire et montrer
show_files, open_folder, open_scene, open_workspace, create_scene, create_workspace, add_to_shelfLire et montrer
disk_usage, find_duplicates, compare_folders, mac_health, read_note, connect, open_toolLire et montrer
propose_changes, undo_operation, add_note, run_saved_jobProposer des changements
read_textLire 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.