Agentes de IA (Claude, ChatGPT, Gemini, Grok…)
Deja que Claude, ChatGPT, Gemini, Grok y otros agentes de IA busquen, muestren y ordenen tus archivos con Folia Files, con cada cambio validado por ti y reversible.
En esta página
Los agentes de IA como Claude (la app para Mac), ChatGPT, Gemini, Grok, Claude Code, Codex, Cursor o VS Code pueden usar Folia Files mediante MCP (el Model Context Protocol). El agente piensa; Folia muestra y actúa:
- busca como Folia: por el nombre, por el texto de los documentos, por lo que muestran las imágenes, con tus etiquetas, en tus nubes y servidores;
- te muestra lo que ha encontrado en una pestaña de Folia, en la vista que prefieras (una lista con exactamente esos archivos, o su carpeta con ellos seleccionados);
- ordena tus ventanas: guarda escenas y espacios de trabajo que puedes volver a abrir cuando quieras;
- propone cambios (crear carpetas, mover, copiar, renombrar, etiquetar, trasladar a la Papelera, comprimir, convertir imágenes…) en una hoja de Folia: no se hace nada antes de que lo valides, y puedes desmarcar cualquier cambio o archivo;
- todo se puede deshacer: nunca se sobrescribe nada (un nombre ya usado recibe «2»), lo que se quita va a la Papelera, y cada cambio es una operación de Operaciones firmada con el nombre del agente, que se deshace con ⌘Z;
- los archivos que están solo en línea en iCloud Drive u otra nube nunca se descargan para un agente.
Está desactivado hasta que lo actives, en el recorrido de bienvenida o en Ajustes › Agente de IA / MCP.
Activarlo
- Abre Ajustes › Agente de IA / MCP.
- Activa Permitir que los agentes de IA usen Folia Files.
- Elige lo que pueden hacer los agentes:
| Nivel | Lo que puede hacer el agente |
|---|---|
| Solo ayuda | leer la documentación de Folia; no ve ninguno de tus archivos |
| Leer y mostrar | buscar tus archivos, leer su información (nombre, tamaño, fechas, etiquetas; no su contenido), mostrarlos en una pestaña, guardar escenas y espacios de trabajo |
| Proponer cambios | todo eso, y proponer cambios en los archivos, que tú validas en Folia |
Leer el contenido de los documentos es un interruptor aparte, desactivado al principio: con él, un agente puede leer el texto de un PDF, un documento o una imagen (para resumirlo, por ejemplo). Lo que lee un agente se envía al proveedor de su IA.
Carpetas permitidas: los agentes no ven nada fuera de ellas. Al principio, tu carpeta de inicio (su Biblioteca queda oculta, salvo iCloud Drive y las nubes; también los archivos ocultos de su nivel superior) y los demás discos y servidores. Añade o quita carpetas como quieras.
Abrir Folia Files cuando un agente lo necesite: si Folia está cerrado, el agente lo abre en segundo plano.
Conectar un agente
En Ajustes › Agente de IA / MCP › Conectar un agente, elige tu agente en la lista: Folia explica cómo conectarlo, paso a paso, con el botón que lo hace. Claude, ChatGPT, Gemini y Grok van primero (también en la bienvenida).
| Agente | Cómo |
|---|---|
| Claude (la app para Mac) | Instalar…: Claude pide instalar la extensión «Folia Files»; acepta y abre una conversación nueva |
| ChatGPT (la app para Mac) | Añadir a ChatGPT: Folia se añade a los servidores MCP de ChatGPT con la propia herramienta de ChatGPT; sal de ChatGPT y vuelve a abrirlo |
| Gemini (la app para Mac) | Copiar el comando y, en Gemini: Personalizar › Conectores › Personalizado, pestaña MCP local: nombre del servidor «Folia Files», ID de servidor «folia», pega el comando en Comando y Conectar. Si Gemini no llega a Folia Files: Configuración avanzada › Configuración del entorno aislado › Acceso completo. Google está abriendo poco a poco la pestaña MCP local: si Gemini solo pide un enlace, tu cuenta aún no puede abrir Folia Files. |
| Grok | la app Grok solo acepta conectores en línea: conecta Grok Build, el agente de xAI para Terminal. Copiar la línea, pégala en Terminal y reinicia Grok Build |
| Claude Code | Copiar la línea, pégala en Terminal y vuelve a abrir Claude Code |
| Codex | Copiar la línea, pégala en Terminal y vuelve a abrir Codex |
| Cursor | Añadir a Cursor y confirma en Cursor |
| VS Code | Añadir a VS Code y confirma en VS Code |
| Otro agente | Copiar la configuración y pégala en los ajustes MCP del agente («mcpServers») |
Todos los agentes ejecutan el mismo pequeño programa, folia-mcp, que está dentro de Folia Files (Folia Files.app/Contents/Helpers/folia-mcp). Solo habla con Folia en tu Mac: ningún puerto de red, nada accesible desde otro ordenador.
La primera vez que una app de agente usa Folia, Folia te pregunta: Permitir o Rechazar. Puedes olvidar una app en Ajustes › Agente de IA / MCP › Agentes permitidos: volverá a preguntar.
Lo que puedes pedir
- «Ordena mi carpeta Descargas: una carpeta por tipo, y los duplicados a la Papelera.»
- «Muéstrame las facturas del año pasado.»
- «Haz una escena con mis carpetas de fotos en Mosaico y el Mapa.»
- «¿Qué ocupa el espacio en mi disco externo?»
- «Compara estas dos carpetas antes de que elimine la antigua.»
- «Renombra estos escaneos con su fecha y el nombre de la tienda.»
La hoja de propuestas
Cuando un agente propone cambios, Folia pasa al frente con una hoja: el nombre del agente, su explicación y luego cada cambio con sus archivos. Desmarca un cambio, o ábrelo y desmarca algunos archivos; Mostrar los archivos los abre antes en una pestaña. Aplicar hace lo que está marcado; Rechazar no hace nada. El agente sabe lo que se ha hecho, archivo por archivo.
Una propuesta te espera 15 minutos; pasado ese tiempo, se descarta.
Lo que han hecho los agentes
Ajustes › Agente de IA / MCP › Lo que han hecho muestra las últimas solicitudes de los agentes (en memoria, hasta que Folia se cierra). Sus cambios también están en Operaciones, con el nombre del agente, como los demás.
Las herramientas de los agentes
| Herramienta | Nivel |
|---|---|
search_docs, read_doc, list_docs: la documentación | Solo ayuda |
get_context (lo que estás mirando), list_folder, get_info, search_files, list_places, recent_items, recent_operations, get_shelf | Leer y mostrar |
show_files, open_folder, open_scene, open_workspace, create_scene, create_workspace, add_to_shelf | Leer y mostrar |
disk_usage, find_duplicates, compare_folders, mac_health, read_note, connect, open_tool | Leer y mostrar |
propose_changes, undo_operation, add_note, run_saved_job | Proponer cambios |
read_text | Leer el contenido de los documentos |
open_tool prepara una de las herramientas de Folia (acciones por lotes en imágenes y vídeos, PDF, renombrado por lotes, duplicados, comparar) para que la revises y la ejecutes tú. run_saved_job ejecuta una de tus copias de seguridad, sincronizaciones o reglas, después de que lo confirmes.
Privacidad
- Lo que un agente ve de tus archivos (nombres, carpetas, información y el texto si lo has permitido) se envía al proveedor de IA de ese agente. Folia, por su parte, no envía nada a ningún sitio.
- Los agentes solo ven las carpetas permitidas, nunca los datos privados de tu Biblioteca, nunca los archivos ocultos del nivel superior de tu carpeta de inicio.
- Los archivos de la nube que están solo en línea nunca se descargan para un agente.
Sin la app: la documentación para cualquier asistente
La documentación de Folia también es un servidor MCP en la web, sin cuenta: añade https://foliafiles.com/mcp a tu asistente (Claude: Ajustes › Conectores › Añadir conector personalizado) y pregúntale cómo hacer algo en Folia Files. Solo lee esta documentación.
Si no funciona
El agente dice por qué:
- «Access for AI agents is off»: actívalo en Ajustes › Agente de IA / MCP.
- «Folia Files is not open»: ábrelo, o activa Abrir Folia Files cuando un agente lo necesite.
- «The user did not allow this app»: la app se rechazó; olvídala en Agentes permitidos y acéptala la próxima vez.
- «… is outside the folders Folia Files lets agents use»: añade la carpeta en Carpetas permitidas.