Claude Code にファイルを圧縮・変換させる（MCP）

AI アシスタントに、その場ででっち上げるスクリプトではなく本物のツールでファイルを処理させましょう。1FileTool の AI Access は64の操作——圧縮、変換、抽出、墨消し——を MCP server として公開し、Claude Code や Gemini が呼び出せます。ファイルはすべてあなたのマシン上に留まります。

$ claude
Claude Code v2.x

> Compress every image in ~/Desktop/sample-photos and put the results in
  ~/Desktop/sample-photos/compressed

● I'll use the 1FileTool MCP bridge running on this Mac.

● filetool_compress_images(paths: ["~/Desktop/sample-photos"], quality: 82,
    output_dir: "~/Desktop/sample-photos/compressed")
  ⎿  Compressed 12 images
     38.2 MB → 6.9 MB (saved 81.9%)
     Results in ~/Desktop/sample-photos/compressed

● Done — 12 images compressed from 38.2 MB to 6.9 MB. The originals are
  untouched; the compressed copies are in the compressed/ subfolder.

Note: MCP runs count toward the daily total — 12 files exceeds the free
tier's 8 files/day, so a batch this size needs Pro.

上のキャプチャは実際の Claude Code セッションです：自然な言葉のプロンプト1つ、filetool_compress_images の呼び出し1回で、12枚の画像が 38.2 MB から 6.9 MB に縮みました。

必要なもの

• macOS（Apple Silicon または Intel）、Windows、Linux 上の 1FileTool 1.10.0 以降。
• 同じマシンにインストールされた Claude Code または Gemini CLI。ワンクリックのセットアップが対応するのはこの2つのクライアントのみです。
• アシスタント自体のためのインターネット接続——ファイルがマシンを離れることはありませんが、AI CLI は自身のクラウドモデルと通信します。

ZIP には5枚の合成 JPG 写真（hero-photo.jpg、team-photo.jpg、product-shot.jpg、banner.jpg、cover.jpg）が入っています——アシスタントに向けさせるのに安全な画像フォルダです。

この警告はアプリの UI 向けです——MCP 経由では、filetool_compress_images のような操作は *_compressed コピーを出力フォルダに書き出し、元ファイルには触れません。もう1つ覚えておいてください：エージェント経由の実行はファイルごとにカウントされ、無料プランの1日8ファイル枠を消費します。12ファイルのバッチには Pro が必要か、より小さなフォルダを使ってください。

手順

1. AI Access 設定を開く

1FileTool を起動し、Settings を開き、AI Access タブをクリックして MCP セクションを選びます。

2. AI アクセスをオンにする

Allow AI assistant access をオンにします。ステータスバッジが Listening に変わり、文言が境界を正確に伝えます：「Accepting local requests on 127.0.0.1:<port>. Nothing is exposed to the network.」ブリッジは起動ごとのトークン付き loopback 限定——開いているポートも、アカウントも、アップロードもありません。

3. CLI を接続する

Connect をクリックします。1FileTool は見つかった対応クライアントすべてに、自身を onefiletool MCP server として登録します：

• Claude Code — ~/.claude.json に書き込み
• Gemini CLI — ~/.gemini/settings.json にマージ

各クライアントにバッジが表示され（「Claude Code」「Gemini CLI」）、未インストールのものには "— not found" と付きます。確認メッセージは "Connected. Restart Claude Code to pick up the new tools." — サーバーを読み込むため CLI を再起動してください。

別のクライアントを使っていますか？ Set up another client manually を開くと、そのまま貼り付けられる設定ブロックが出ます。

4. 仕事を頼む

Claude Code または Gemini のセッションで、自然な言葉で頼みます——設定ページが提案しているフレーズ：

use 1filetool mcp to compress these images

フォルダを指定してください——サンプル ZIP を解凍して "use 1filetool mcp to compress the images in this folder" と試してみましょう。アシスタントが適切な filetool_* 操作を選び、ジョブは 1FileTool を通してローカルで実行され、結果は出力フォルダに入ります。

結果

サンプルフォルダの圧縮を頼むと、アシスタントは filetool_compress_images を実行し、*_compressed.jpg コピーが ~/Documents/1FileTool——または設定した出力フォルダ——に現れます。元のファイルはそのままです。

圧縮以外にも、アシスタントは 64の操作 にアクセスできます——filetool_list_operations が一覧します：画像（12）、PDF（20）、動画（9）、音声（7）、ファイルとデータ（6）、プライバシー（4）、オンデバイス AI（4）、さらに検査とステータス系。2つの操作は Pro が必要で、残りはアプリの無料デイリー枠を共有します。

うまくいかない場合

• CLI がツールを認識しない。 Connect をクリックした後に再起動してください——server は設定に登録されていますが、読み込まれるのは新しい起動時だけです。
• ツール出力に "PRO_REQUIRED"。 2つの操作——auto-redact と watch-folder 自動化——は Pro 限定です。アシスタントにはその旨が伝わり、あなたに伝えられます。
• "Daily free limit reached"。 エージェント実行はプロンプト単位ではなくファイル単位でカウントされるため、12枚のバッチは8ファイルの無料枠を一気に使い切ります。翌日リセットされます。Pro なら上限なしです。
• 1FileTool アプリが起動していない。 MCP server はアプリへのブリッジです——アプリが閉じていれば、アシスタントの呼び出しは行き場を失います。
• Codex のセットアップ。 UI には Codex の行がありますが、自動セットアップが書くファイルは Codex が読みません——設定ブロックから手動でセットアップするか、Claude Code か Gemini を使ってください。

次に試すこと

アシスタントが呼び出す圧縮操作を、ブラウザ上で試せます：

関連ページ

• AI Access と MCP リファレンス
• Free vs Pro
• 1FileTool のインストール
• Compress Images と Compress Video