AI エージェント(Claude、ChatGPT、Gemini、Grok…)

Claude、ChatGPT、Gemini、Grok などの AI エージェントに、Folia Files を通じてファイルを検索、表示、整理させます。どの変更もあなたが確認してから行われ、取り消せます。

Web サイト版のみ Folia Files 1.5 以降

このページの内容

Claude(Mac 用 App)、ChatGPT、Gemini、Grok、Claude Code、Codex、Cursor、VS Code などの AI エージェントは、MCP(Model Context Protocol)を通じて Folia Files を使えます。考えるのはエージェント、表示して実行するのは Folia です:

  • Folia と同じように検索します:名前、書類のテキスト、画像に写っているもの、タグで、クラウドやサーバの中も検索します。
  • 見つけたものを Folia のタブに表示します。表示方法はお好みのものを使います(そのファイルだけのリスト、またはそれらを選択した状態のフォルダ)。
  • ウインドウを整えます:いつでも開き直せる シーン とワークスペースを保存します。
  • Folia のシートで 変更を提案します(フォルダの作成、移動、コピー、名前の変更、タグ付け、ゴミ箱に入れる、圧縮、画像の変換…)。あなたが確認するまで何も行われません。どの変更やファイルもチェックを外せます。
  • すべて取り消せます:何も上書きされず(使われている名前には「2」が付きます)、削除したものはゴミ箱に入り、どの変更も 操作 の 1 つとしてエージェントの名前付きで記録され、⌘Z で取り消せます。
  • iCloud Drive やほかのクラウドで オンラインのみ のファイルは、エージェントのためにダウンロードされることはありません。

オンにするまではオフ です。ようこそツアー、または 設定 › AIエージェント / MCP でオンにします。

オンにする

  1. 設定 › AIエージェント / MCP を開きます。
  2. AIエージェントにFolia Filesの使用を許可 をオンにします。
  3. エージェントにできることを選びます:
レベルエージェントにできること
ヘルプのみFolia のドキュメントを読む。あなたのファイルは一切見えません
読み取りと表示ファイルの検索、情報(名前、サイズ、日付、タグ。内容は除く)の読み取り、タブでの表示、シーンとワークスペースの保存
変更を提案上記すべてに加え、ファイルへの変更を提案します。変更は Folia であなたが確認します

書類の内容を読む は別のスイッチで、最初はオフです。オンにすると、エージェントは PDF、書類、画像のテキストを読み取れます(たとえば要約のために)。エージェントが読み取ったものは、その AI の提供元に送られます。

許可するフォルダ:エージェントにはそれ以外の場所は見えません。最初はホームフォルダ(その中のライブラリは、iCloud Drive とクラウドを除いて隠されたままです。ホームフォルダの最上位にある隠しファイルも同様です)と、ほかのディスクやサーバです。フォルダは自由に追加、削除できます。

エージェントが必要とするときにFolia Filesを開く:Folia が閉じているとき、エージェントがバックグラウンドで開きます。

エージェントを接続する

設定 › AIエージェント / MCP › エージェントを接続 で、一覧からエージェントを選びます。Folia が接続の手順を順に説明し、それを行うボタンも表示します。Claude、ChatGPT、Gemini、Grok が先頭です(ようこそ画面でも)。

エージェント方法
Claude(Mac 用 App)インストール…:Claude が拡張機能「Folia Files」のインストールを求めます。承認してから、新しいチャットを始めます
ChatGPT(Mac 用 App)ChatGPTに追加:ChatGPT 自身のツールで、Folia が ChatGPT の MCP サーバに加わります。ChatGPT を終了して開き直します
Gemini(Mac 用 App)コマンドをコピー して、Gemini で [カスタマイズ] › [コネクタ] › [カスタム] の ローカル MCP タブを開きます。サーバー名「Folia Files」、サーバー ID「folia」、コマンド にペーストして 接続。Gemini が Folia Files につながらない場合:詳細設定 › サンドボックスの設定 › 完全アクセス権。Google は ローカル MCP タブを順次公開しています。Gemini がリンクしか求めない場合、お使いのアカウントではまだ Folia Files を起動できません。
GrokGrok App が受け付けるのはオンラインのコネクタだけです。xAI のターミナル用エージェント Grok Build を接続します。コマンドをコピー して、ターミナルにペーストし、Grok Build を再起動します
Claude Codeコマンドをコピー して、ターミナルにペーストし、Claude Code を再起動します
Codexコマンドをコピー して、ターミナルにペーストし、Codex を再起動します
CursorCursorに追加 を押し、Cursor で確認します
VS CodeVS Codeに追加 を押し、VS Code で確認します
その他のエージェント構成をコピー して、エージェントの MCP 設定(「mcpServers」)にペーストします

どのエージェントも、Folia Files の中にある同じ小さなプログラム folia-mcp を実行します(Folia Files.app/Contents/Helpers/folia-mcp)。このプログラムはお使いの Mac 上の Folia とだけ通信します。ネットワークポートはなく、ほかのコンピュータからは何もアクセスできません。

エージェントの App が初めて Folia を使うとき、Folia は 許可 するか 拒否 するかを尋ねます。設定 › AIエージェント / MCP › 許可したエージェント で App の登録を解除すると、次回もう一度尋ねられます。

頼めること

  • 「ダウンロードフォルダを整理して。種類ごとにフォルダを作って、重複はゴミ箱へ。」
  • 「去年の請求書を見せて。」
  • 「写真のフォルダをモザイクで表示して、地図も並べたシーンを作って。」
  • 「外付けディスクの容量を使っているのは何?」
  • 「古いほうを削除する前に、この 2 つのフォルダを比較して。」
  • 「このスキャンの名前を、日付と店の名前に変えて。」

提案のシート

エージェントが変更を提案すると、Folia が前面に出てシートを表示します:エージェントの名前、その説明、続いて変更ごとにそのファイルが並びます。変更のチェックを外すか、変更を開いて一部のファイルのチェックを外します。ファイルを表示 を押すと、まずタブで開いて確認できます。適用 でチェックしたものが実行され、拒否 では何も行われません。何が行われたかは、ファイルごとにエージェントに伝えられます。

提案は 15 分間待ちます。それを過ぎると取り下げられます。

エージェントが行ったこと

設定 › AIエージェント / MCP › エージェントが行ったこと には、エージェントからの最近の依頼が一覧表示されます(メモリ上にあり、Folia を終了するまで残ります)。エージェントによる変更は、ほかの変更と同じく、エージェントの名前付きで 操作 にも表示されます。

エージェントが使えるツール

ツールレベル
search_docs、read_doc、list_docs:ドキュメントヘルプのみ
get_context(いま見ているもの)、list_folder、get_info、search_files、list_places、recent_items、recent_operations、get_shelf読み取りと表示
show_files、open_folder、open_scene、open_workspace、create_scene、create_workspace、add_to_shelf読み取りと表示
disk_usage、find_duplicates、compare_folders、mac_health、read_note、connect、open_tool読み取りと表示
propose_changes、undo_operation、add_note、run_saved_job変更を提案
read_text書類の内容を読む

open_tool は Folia のツール(写真とビデオの一括操作、PDF、名前の一括変更、重複ファイル、比較)の内容を用意し、あなたが確認して実行します。run_saved_job は、あなたの確認のあとで、バックアップ、同期、ルールのいずれかを実行します。

プライバシー

  • エージェントがあなたのファイルについて見たもの(名前、フォルダ、情報、許可した場合はテキスト)は、そのエージェントの AI の提供元に送られます。Folia 自体はどこにも何も送りません。
  • エージェントに見えるのは許可するフォルダだけです。ライブラリの個人データや、ホームフォルダの最上位にある隠しファイルは見えません。
  • オンラインのみのクラウドのファイルは、エージェントのためにダウンロードされることはありません。

App なしで:どのアシスタントでも使えるドキュメント

Folia のドキュメントは、アカウント不要の Web 上の MCP サーバでもあります。アシスタントに https://foliafiles.com/mcp を追加し(Claude の場合:設定 › コネクタ › カスタムコネクタを追加)、Folia Files での操作方法を尋ねてください。読み取るのはこのドキュメントだけです。

うまくいかないとき

エージェントが理由を伝えます:

  • 「Access for AI agents is off」:設定 › AIエージェント / MCP でオンにします。
  • 「Folia Files is not open」:Folia Files を開くか、エージェントが必要とするときにFolia Filesを開く をオンにします。
  • 「The user did not allow this app」:その App は拒否されています。許可したエージェント で登録を解除し、次回は許可してください。
  • 「… is outside the folders Folia Files lets agents use」:そのフォルダを 許可するフォルダ に追加します。