AI エージェント(Claude、ChatGPT、Gemini、Grok…)
Claude、ChatGPT、Gemini、Grok などの AI エージェントに、Folia Files を通じてファイルを検索、表示、整理させます。どの変更もあなたが確認してから行われ、取り消せます。
このページの内容
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 でオンにします。
オンにする
- 設定 › AIエージェント / MCP を開きます。
- AIエージェントにFolia Filesの使用を許可 をオンにします。
- エージェントにできることを選びます:
| レベル | エージェントにできること |
|---|---|
| ヘルプのみ | 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 を起動できません。 |
| Grok | Grok App が受け付けるのはオンラインのコネクタだけです。xAI のターミナル用エージェント Grok Build を接続します。コマンドをコピー して、ターミナルにペーストし、Grok Build を再起動します |
| Claude Code | コマンドをコピー して、ターミナルにペーストし、Claude Code を再起動します |
| Codex | コマンドをコピー して、ターミナルにペーストし、Codex を再起動します |
| Cursor | Cursorに追加 を押し、Cursor で確認します |
| VS Code | VS 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」:そのフォルダを 許可するフォルダ に追加します。