記事一覧

Filesystem MCPの実務で役立つ使い方を徹底的解説

Filesystem MCPを実務でどう使うか、具体的なユースケースを7つ解説。ドキュメント管理・コードレビュー・ログ解析・チーム共有ドライブ・AIエージェントの記憶としての活用まで、セキュリティ設計のポイントもあわせて紹介します。

Filesystem MCPはMCPサーバーの中でもっとも地味に見えて、実は日常業務への影響がもっとも大きいサーバーの一つです。「ファイルを読み書きできる」という機能はシンプルですが、使い方次第でAIが単なる会話相手からチームの作業パートナーへと変わります。この記事では、実際の業務で使える具体的なユースケースを体系的に解説します。

📌 はじめに:Nodeflare のご紹介

GitHubで公開されているMCPサーバーを、そのままデプロイしてリモート化できるサービス Nodeflare を提供しています。Filesystem MCPもすぐに使い始められます。

👉 Nodeflare を使ってみる

アジェンダ

  1. Filesystem MCPでできること・できないこと
  2. ドキュメント管理・作成業務での活用
  3. コードベースの読解・レビューへの活用
  4. データ処理・ログ解析への活用
  5. チームでの共有ドライブ運用への活用
  6. 自動化エージェントの「記憶」として使う
  7. セキュリティ設計と権限設定の考え方

1. Filesystem MCPでできること・できないこと

まず前提を整理しておきます。Filesystem MCPは思いのほかシンプルなサーバーで、できることは以下に限られます。

できること

  • ファイルの読み取り(テキスト・コード・CSV・Markdownなど)
  • ファイルの作成・上書き
  • ディレクトリの一覧取得・作成
  • ファイルの移動・コピー・削除
  • ファイルメタデータの取得(更新日時・サイズなど)
  • ファイル内のテキスト検索

できないこと

  • 画像・動画などのバイナリファイルの直接処理
  • クラウドストレージへの直接アクセス(Google Drive・S3など)
  • データベースへのクエリ(別のMCPが必要)
  • リアルタイムのファイル監視

この制約を理解した上で使うと、「使えない」と感じる場面が減り、適切な組み合わせを設計できるようになります。

2. ドキュメント管理・作成業務での活用

議事録の自動整形・保存

会議後にメモを貼り付け、「これを所定のフォルダに議事録として保存して」と指示するだけで、構造化されたMarkdownファイルとして保存されます。ファイル名に日付を含めるよう指示すれば、命名規則も自動で揃います。

プロンプト例

以下の会議メモを、/docs/minutes/2026-06/ に
YYYY-MM-DD_プロジェクト名.md という形式で保存してください。
見出し・参加者・決定事項・アクションアイテムの構成で整形してください。

[メモをここに貼り付け]

既存ドキュメントの一括レビュー

/docs/ 以下にある複数のMarkdownファイルを読み込み、「表記ゆれを見つけて一覧化して」「全ファイルのh1見出しを一覧にして」といった横断的な処理が自然言語で実行できます。

テンプレートからのドキュメント量産

テンプレートファイルを読み込み、変数を差し替えながら複数のファイルを生成するといった作業も、Claudeに指示するだけで完結します。たとえば顧客ごとの提案書、週次レポートの雛形生成など。

3. コードベースの読解・レビューへの活用

プロジェクト全体の構造把握

初めて触るリポジトリで、「このプロジェクトの構成を説明して」と頼むと、ディレクトリ構造を読んだ上で主要なファイルの役割まで説明してくれます。README がない・古いプロジェクトでも機能します。

特定の処理を横断的に検索

「このリポジトリ内でfetchを使っている箇所を全部見つけて、エラーハンドリングが抜けているものを教えて」のような指示に対し、ファイルをまたいで検索・レビューしてくれます。grep と違い、コードの文脈を理解した上で回答が返ってきます。

コードの自動修正・リファクタリング

/src/utils/ 以下のファイルを全部読んで、重複している処理を共通化した提案をして。承認したらファイルを書き換えて」という使い方ができます。人間がレビューしてOKを出したらそのまま書き換えまで完結します。

実務での注意点: 書き込み権限を持たせる場合は、必ずGitで管理されているディレクトリを指定すること。万が一意図しない変更が入っても git diff で確認・git checkout で戻せる状態にしておくのが鉄則です。

4. データ処理・ログ解析への活用

CSVファイルの集計・変換

Filesystem MCPでCSVを読み込み、Claudeが集計・フィルタリング・フォーマット変換を行い、別ファイルに書き出す。ExcelやPythonスクリプトを開かなくても、自然言語で「売上CSVから先月分だけ抜き出して、顧客ごとに合計してJSON形式で保存して」が通ります。

向いているケース

  • 定型のCSV変換・クレンジング
  • 複数ファイルのマージ
  • フォーマット変換(CSV → JSON / Markdown tableなど)

ログファイルの解析

アプリケーションのログファイルを読み込み、「過去1時間でERRORが出た件数と、頻出するエラーメッセージのランキングを教えて」といった解析が自然言語でできます。ログ解析ツールを立ち上げるよりも素早く、かつ文脈を理解した回答が返ってきます。

レポートの自動生成

データファイルを読み込んで分析し、その結果をMarkdownレポートとして保存する、という一連のフローをClaudeが一気に実行できます。定型レポートの下書き生成に特に有効です。

5. チームでの共有ドライブ運用への活用

Filesystem MCPをチームの共有ストレージ(NASやクラウドドライブのマウント先)に向けると、チーム全体でのナレッジベース検索・更新が自然言語で可能になります。

ナレッジベースの横断検索

「先月のインシデント対応手順が書いてあるファイルを探して要約して」「Aプロジェクトの仕様書と設計書を読んで、実装との差分を教えて」といった指示が通ります。社内Wikiの検索より文脈を理解した回答が得られます。

ドキュメントの鮮度チェック

/docs/ 以下のファイルのうち、6ヶ月以上更新されていないものを一覧にして」という指示で、更新が滞っているドキュメントを洗い出せます。メタデータ(更新日時)をもとにした管理業務も自然言語で完結します。

オンボーディング資料の活用

新メンバーが「このプロジェクトを理解するために最初に読むべきドキュメントはどれ?」と聞くと、ドキュメント群を読んだ上で優先順位をつけて案内してくれます。

6. 自動化エージェントの「記憶」として使う

Filesystem MCPの見落とされがちな使い方が、AIエージェントの永続的な記憶領域としての活用です。

ClaudeはセッションをまたいでコンテキストをRetenしません。しかしFilesystem MCPと組み合わせると、「前回の作業内容をファイルに書き出しておく → 次のセッションで読み込む」という疑似的な記憶が実現できます。

具体的なパターン

[セッション終了時]
「今日の作業内容・未完了タスク・次回やること を
/workspace/context/session_log.md に追記して」

[次のセッション開始時]
「/workspace/context/session_log.md を読んで、
前回の続きから始めよう」

タスク管理・進行中のプロジェクト管理・調査ログの蓄積など、長期にわたる作業との相性が特に良いパターンです。

7. セキュリティ設計と権限設定の考え方

Filesystem MCPは強力なツールである反面、設定を間違えると意図しないファイルへのアクセスや書き込みが起きるリスクがあります。実務で使うには以下の点を押さえてください。

allowed_directories を必ず絞る

Filesystem MCPはサーバー起動時に allowed_directories を指定します。ここで許可するディレクトリを必要最小限に絞ることが基本です。ホームディレクトリ全体を指定するのは避け、用途ごとに専用ディレクトリを切るのがベストプラクティスです。

{
  "args": [
    "/workspace/project-a",
    "/workspace/shared-docs"
  ]
}

読み取り専用と読み書きを分ける

参照だけで十分なディレクトリには ro(read-only)フラグを立てましょう。Dockerでマウントする場合は以下のように指定できます。

--mount type=bind,src=/docs,dst=/projects/docs,ro

Gitで管理されたディレクトリを書き込み先にする

書き込み権限を与えるディレクトリは必ずGit管理下に置くこと。変更の追跡・ロールバックが簡単にできる状態が、書き込み権限の前提条件です。

機密ファイルを混在させない

APIキー・パスワード・個人情報が含まれるファイルは、allowed_directories の外に置くか、専用の .env ファイルはディレクトリを分けて管理します。

まとめ

ユースケース主な効果
ドキュメント作成・整形命名規則・構成の統一、作業時間の削減
コードレビュー・リファクタリング横断的な検索と文脈を理解した提案
データ処理・ログ解析自然言語でのCSV変換・ログ集計
共有ドライブ運用ナレッジベースの横断検索・鮮度管理
エージェントの記憶セッションをまたいだ継続作業

Filesystem MCPは単体で使うより、他のMCPサーバー(GitHub MCP・Slack MCPなど)と組み合わせることで真価を発揮します。まず読み取り専用で試し、使い方に慣れてから書き込みを許可する、という段階的な導入が現場では安全です。

Nodeflare でMCPをリモート化して使う

Filesystem MCPをはじめ、GitHubで公開されているMCPサーバーを数分でリモートデプロイできます。チームで共有するなら、ローカルではなくリモートMCPとして立ち上げるのがおすすめです。

👉 Nodeflare を使ってみる

nodeflareNodeFlare

MCP専用ホスティングサービス

GitHubにあるMCPを簡単デプロイ・簡単運用で最適化
無料で始める