Agentes de IA (Claude, ChatGPT, Gemini, Grok…)

Claude, ChatGPT, Gemini, Grok e outros agentes de IA buscam, mostram e organizam seus arquivos pelo Folia Files, cada alteração aprovada por você e reversível.

Somente a versão do site Desde o Folia Files 1.5

Nesta página

Agentes de IA como o Claude (o app para Mac), o ChatGPT, o Gemini, o Grok, o Claude Code, o Codex, o Cursor ou o VS Code podem usar o Folia Files por meio do MCP (o Model Context Protocol). O agente pensa; o Folia mostra e faz:

  • ele busca como o Folia: pelo nome, pelo texto dos documentos, pelo que as imagens mostram, com suas etiquetas, nas suas nuvens e nos seus servidores;
  • ele mostra o que encontrou em uma aba do Folia, na visualização que você prefere (uma lista exatamente com esses arquivos, ou a pasta deles com eles selecionados);
  • ele organiza suas janelas: salva cenas e espaços de trabalho que você pode abrir de novo quando quiser;
  • ele propõe alterações (criar pastas, mover, copiar, renomear, etiquetar, mover para o Lixo, comprimir, converter imagens…) em uma folha do Folia: nada acontece antes de você aprovar, e você pode desmarcar qualquer alteração ou arquivo;
  • tudo pode ser desfeito: nada é sobrescrito (um nome já usado recebe “2”), o que é removido vai para o Lixo, e cada alteração é uma operação de Operações assinada com o nome do agente, desfeita com ⌘Z;
  • arquivos que estão apenas on-line no iCloud Drive ou em outra nuvem nunca são baixados para um agente.

Fica desativado até você ativar, no tour de boas-vindas ou em Ajustes › Agente de IA / MCP.

Ativar

  1. Abra Ajustes › Agente de IA / MCP.
  2. Ative Permitir que agentes de IA usem o Folia Files.
  3. Escolha o que os agentes podem fazer:
NívelO que o agente pode fazer
Somente ajudaler a documentação do Folia; ele não vê nenhum dos seus arquivos
Ler e mostrarbuscar seus arquivos, ler as informações deles (nome, tamanho, datas, etiquetas; não o conteúdo), mostrá-los em uma aba, salvar cenas e espaços de trabalho
Propor alteraçõestudo isso, e propor alterações nos arquivos, que você aprova no Folia

Ler o conteúdo dos documentos é um interruptor à parte, desativado de início: com ele, um agente pode ler o texto de um PDF, de um documento ou de uma imagem (para resumi-lo, por exemplo). O que um agente lê é enviado ao provedor da IA dele.

Pastas permitidas: os agentes não veem nada além delas. De início, sua pasta de início (a Biblioteca dela fica oculta, exceto o iCloud Drive e as nuvens; assim como os arquivos ocultos no nível mais alto dela) e os outros discos e servidores. Adicione ou remova pastas como quiser.

Abrir o Folia Files quando um agente precisar: com o Folia fechado, o agente o abre em segundo plano.

Conectar um agente

Em Ajustes › Agente de IA / MCP › Conectar um agente, escolha seu agente na lista: o Folia explica como conectá-lo, passo a passo, com o botão que faz isso. Claude, ChatGPT, Gemini e Grok vêm primeiro (também nas boas-vindas).

AgenteComo
Claude (o app para Mac)Instalar…: o Claude pede para instalar a extensão “Folia Files”; aceite e abra uma nova conversa
ChatGPT (o app para Mac)Adicionar ao ChatGPT: o Folia se adiciona aos servidores MCP do ChatGPT com a própria ferramenta do ChatGPT; encerre o ChatGPT e abra-o de novo
Gemini (o app para Mac)Copiar o comando e, no Gemini: Personalizar › Conectores › Personalizado, aba MCP local: nome do servidor “Folia Files”, ID do servidor “folia”, cole o comando em Comando e Conectar. Se o Gemini não alcançar o Folia Files: Configurações avançadas › Configurações da sandbox › Acesso total. O Google está liberando aos poucos a aba MCP local: se o Gemini pedir só um link, sua conta ainda não pode abrir o Folia Files.
Groko app Grok só aceita conectores online: conecte o Grok Build, o agente da xAI para o Terminal. Copiar a linha, cole-a no Terminal e reinicie o Grok Build
Claude CodeCopiar a linha, cole-a no Terminal e reabra o Claude Code
CodexCopiar a linha, cole-a no Terminal e reabra o Codex
CursorAdicionar ao Cursor e confirme no Cursor
VS CodeAdicionar ao VS Code e confirme no VS Code
Outro agenteCopiar a configuração e cole-a nos ajustes MCP do agente (“mcpServers”)

Todos os agentes executam o mesmo pequeno programa, folia-mcp, que fica dentro do Folia Files (Folia Files.app/Contents/Helpers/folia-mcp). Ele conversa com o Folia somente no seu Mac: nenhuma porta de rede, nada acessível a partir de outro computador.

Na primeira vez que um app de agente usa o Folia, o Folia pergunta: Permitir ou Recusar. Você pode esquecer um app em Ajustes › Agente de IA / MCP › Agentes permitidos: ele perguntará de novo.

O que você pode pedir

  • “Organize minha pasta Downloads: uma pasta por tipo, e as duplicatas para o Lixo.”
  • “Mostre as notas fiscais do ano passado.”
  • “Crie uma cena com minhas pastas de fotos em Mosaico e o Mapa.”
  • “O que está ocupando espaço no meu disco externo?”
  • “Compare estas duas pastas antes que eu apague a antiga.”
  • “Renomeie estas digitalizações com a data delas e o nome da loja.”

A folha de propostas

Quando um agente propõe alterações, o Folia vem para a frente com uma folha: o nome do agente, a explicação dele e, em seguida, cada alteração com seus arquivos. Desmarque uma alteração, ou abra-a e desmarque alguns arquivos; Mostrar os arquivos os abre primeiro em uma aba. Aplicar faz o que está marcado; Recusar não faz nada. O agente fica sabendo o que foi feito, arquivo por arquivo.

Uma proposta espera por você 15 minutos; depois disso, ela é descartada.

O que os agentes fizeram

Ajustes › Agente de IA / MCP › O que eles fizeram lista os últimos pedidos dos agentes (na memória, até o Folia ser encerrado). As alterações deles também estão em Operações, com o nome do agente, como as outras.

As ferramentas dos agentes

FerramentaNível
search_docs, read_doc, list_docs: a documentaçãoSomente ajuda
get_context (o que você está vendo), list_folder, get_info, search_files, list_places, recent_items, recent_operations, get_shelfLer e mostrar
show_files, open_folder, open_scene, open_workspace, create_scene, create_workspace, add_to_shelfLer e mostrar
disk_usage, find_duplicates, compare_folders, mac_health, read_note, connect, open_toolLer e mostrar
propose_changes, undo_operation, add_note, run_saved_jobPropor alterações
read_textLer o conteúdo dos documentos

open_tool prepara uma das ferramentas do Folia (ações em lote em imagens e vídeos, PDF, renomear em lote, duplicatas, comparar) para você conferir e executar. run_saved_job executa um dos seus backups, sincronizações ou regras, depois que você confirma.

Privacidade

  • O que um agente vê dos seus arquivos (nomes, pastas, informações, e o texto se você permitiu) é enviado ao provedor de IA desse agente. O Folia, por sua vez, não envia nada para lugar nenhum.
  • Os agentes só veem as pastas permitidas, nunca os dados privados da sua Biblioteca, nunca os arquivos ocultos no nível mais alto da sua pasta de início.
  • Arquivos da nuvem que estão apenas on-line nunca são baixados para um agente.

Sem o app: a documentação para qualquer assistente

A documentação do Folia também é um servidor MCP na web, sem conta: adicione https://foliafiles.com/mcp ao seu assistente (Claude: Ajustes › Conectores › Adicionar conector personalizado) e pergunte a ele como fazer algo no Folia Files. Ele só lê esta documentação.

Se não funcionar

O agente diz por quê:

  • “Access for AI agents is off”: ative-o em Ajustes › Agente de IA / MCP.
  • “Folia Files is not open”: abra-o, ou ative Abrir o Folia Files quando um agente precisar.
  • “The user did not allow this app”: o app foi recusado; esqueça-o em Agentes permitidos e aceite na próxima vez.
  • “… is outside the folders Folia Files lets agents use”: adicione a pasta em Pastas permitidas.