Apidog

オールインワン協働API開発プラットフォーム

API設計

APIドキュメント

APIデバッグ

APIモック

API自動テスト

ローカルファイルをMCPサーバーとClaudeを使用して直接操作する方法

@apidog

@apidog

Updated on 3月 25, 2025

ローカルファイルを処理、分析、またはあなたのモデルコンテキストプロトコル(MCP)サーバーを通じて提供する必要がある場合、あなたは正しい場所にいます。このガイドでは、あなたのMCPサーバーの機能を活用しながら、ローカルファイルに安全にアクセスし、読み取り、操作する方法を示します—ドキュメント処理ツールを構築する場合や、ファイルベースのAPIを作成する場合、またはLLMとローカルデータを統合する場合でも。

💡
MCP開発を次のレベルに進める準備はできましたか? Apidogを無料でダウンロードして、あなたのワークフローをどのように変革できるかを発見しましょう!
ボタン

ファイルシステムの権限、効率的なファイル処理、およびセキュリティのベストプラクティスについて説明し、あなたのMCPサーバーがローカルストレージと安全かつ効果的にやり取りできることを保証します。それでは、始めましょう!

MCPとは何か、なぜ使うのか?

モデルコンテキストプロトコルは、ClaudeのようなAIアシスタントがさまざまなデータソースやツールとやり取りすることを可能にするオープンスタンダードです。いくつかの主要な利点があります:

ユニバーサルアクセス:AIアシスタントがさまざまなソースからデータを問い合わせ、取得するための単一のプロトコル。

安全で標準化された接続:認証、使用ポリシー、および標準化されたデータフォーマットを処理し、アドホックAPIコネクタの代わりとなります。

持続可能性:再利用可能なコネクタのエコシステムを促進し、開発者が一度構築して複数のLLMで再利用できるようにします。

なぜClaudeをローカルファイルに接続するのか?

Claudeをファイルシステムに接続することで、変革的な生産性の利点が開放されます:

1. インテリジェントドキュメント処理:

  • レポートを要約する("Q2_Financials.docxから重要な洞察を抽出する"
  • 構造化データを分析する("このCSVを箇条書きの要約に変換する"
  • 情報を交差参照する("draft_v1.txtとdraft_v2.txtの変更を比較する"

2. 自動ファイル管理:

  • ファイルを整理する("ダウンロードからドキュメント/請求書にすべてのPDFを移動する"
  • 一括リネームする("すべてのスクリーンショットに'2024-'というプレフィックスを付けて時系列通りにする"
  • ストレージをクリーンアップする("30日以上古い一時ファイルを削除する"

3. 開発ワークフローの向上:

  • コードのリファクタリング("このPythonスクリプトをより良いメモリ使用のために最適化する"
  • ドキュメントの生成("このプロジェクトフォルダのREADME.mdを作成する"
  • 構成管理("これらの新しいAPIキーですべての.envファイルを更新する"

前提条件

ファイルシステムMCPサーバーを始める前に、以下のものを確認してください:

Claudeデスクトップアプリ: あなたのオペレーティングシステムに対応したClaudeデスクトップアプリをダウンロードしてインストールします(macOSとWindowsで利用可能)。

Node.js: あなたのシステムにNode.jsがインストールされていることを確認します。コマンドラインを開き、node --versionを実行します。Node.jsがインストールされていない場合は、nodejs.orgからダウンロードしてください。

基本的なコーディング知識: 基本的なコマンドライン操作および構成ファイルの編集に慣れていること。

ファイルシステムの権限: 現在ログインしているユーザーが、作業したい対象のファイルやディレクトリにアクセスできる読み書き権限を持っていることを確認します。

ステップ1: ファイルシステムMCPサーバーのインストールと構成

Claudeがあなたのコンピュータ上でファイルを読み書き、移動し、検索できるようにするために、事前に構築されたファイルシステムMCPサーバーを使用します。

ファイルclaude_desktop_config.jsonを見つける:

1. Claudeデスクトップアプリを開き、設定に移動します。

2. 設定ペインで、「開発者」タブに移動します。そこに「設定を編集」ボタンがあります。

3. 「設定を編集」をクリックすると、claude_desktop_config.jsonファイルの場所に移動します:

>> macOS: 
~/Library/Application Support/Claude/claude_desktop_config.json

>> Windows: 
%APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.jsonファイルを修正する:

テキストエディタでclaude_desktop_config.jsonファイルを開き、ファイルの内容全体を以下のコードに置き換えます。"username"を実際のコンピュータのユーザー名に置き換えることを確認してください:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Work", // 最小限の特権ディレクトリ
        "/Users/username/Projects" // 明示的な許可リストのみ
      ],
      "restrictions": {
        "maxFileSizeMB": 10,
        "allowedExtensions": [".txt", ".md", ".csv"]
      }
    }
  }
}

重要: "args"配列で指定されたパスは、Claudeがアクセスできるディレクトリを決定します。これらのパスが有効であり、Claudeがアクセスして変更できるディレクトリを指していることを確認してください。必要に応じて、さらにパスを追加できます。

重要な考慮事項:

  • 最小特権の原則: 必要なディレクトリのみを含めます。
  • 拡張子のホワイトリスト化: 偶発的なバイナリファイルの変更を防ぎます。
  • サイズ制限: 大きなファイルによるメモリ問題を避けます。

ステップ2: 構成ファイルの理解

claude_desktop_config.jsonファイルは、アプリケーションの起動時にClaudeが起動しなければならないMCPサーバーを指示します。この場合、"filesystem"というサーバーを追加しており、これはnpxコマンドを使用して@modelcontextprotocol/server-filesystemをインストールして実行します。このサーバーは、Claudeにファイルシステムへのアクセスを提供します。過去にClaudeデスクトップアプリに他のMCPサーバーを構成した場合、その設定もこのファイルに見つかるはずです。

コマンド権限

Claudeは構成ファイル内のコマンドをユーザーアカウントの権限で実行するため、ローカルファイルにアクセスできることを理解することが重要です。完全に理解し、信頼できるソースからのコマンドのみを追加してください。

💡
より多くのMCPサーバーをClaude、Cursor、またはWindsurfに追加したい場合は、HiMCPをチェックして、1682以上の素晴らしいMCPサーバーとクライアントを発見し、AIコーディングワークフローを簡単に強化しましょう!

ステップ3: Claudeを再起動する

claude_desktop_config.jsonファイルを更新した後、変更を反映させるためにClaudeデスクトップアプリを必ず再起動する必要があります。

ステップ4: インストールの確認

Claudeを再起動すると、入力ボックスの右下隅にハンマーアイコンが表示されるはずです。このアイコンをクリックすると、ファイルシステムMCPサーバーが提供するツールが表示されます:

ハンマーツール

アイコンをクリックすると、ファイルシステムMCPサーバーの利用可能なツールが確認できます。

ファイルシステムMCPサーバーの利用可能なツール

サーバーがClaudeに認識されない場合は、トラブルシューティングセクションに進んでください。

トラブルシューティング

問題が発生した場合、以下をお試しください:

Claudeを再起動する: Claudeデスクトップアプリを完全に再起動したことを確認してください。

claude_desktop_config.jsonの構文を確認する: 構成ファイルのJSON構文が正しいことを確認します。JSONバリデーターを使用してエラーをチェックしてください。

ファイルパスを検証する: claude_desktop_config.json内のファイルパスが有効で、絶対パスであり、相対パスではないことを確認してください。

ログを確認する: 接続失敗の原因を特定するためにログを確認します:

macOS: ~/Library/Logs/Claude

Windows: %APPDATA%\Claude\logs

mcp.logは、MCP接続および接続失敗に関する一般的なログを含んでいます。

mcp-server-SERVERNAME.logファイルは、指定したサーバーからのエラーログを含んでいます。

サーバーを手動で実行する: コマンドラインでサーバーを手動で実行して、エラーが発生するか確認してみてください:

npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /Users/username/Downloads

ファイルシステムMCPサーバーの使用

ファイルシステムMCPサーバーの設定が完了したので、Claudeを通じてローカルファイルとやり取りを始めることができます。

1. プロンプトを入力します: "デスクトップ/test/hello_world.txtを作成し、テキストとして'Hello, World'を入力する"

サンプルプロンプト

2. 応答を確認します: Claudeがその課題を達成する様子を確認します。

Claudeの応答

3. 結果を確認します: Claudeは、「Hello, World」というテキストを含む.txtファイルを正常に作成したはずです。

Claudeの結果を確認

Claudeデスクトップアプリを使用してローカルマシン上でファイルに直接アクセスし作成できるようになったら、さまざまなプロンプトを試して、ファイルシステムMCPサーバーの力を体験してみてください!以下にいくつかの例を挙げます:

i. "私のダウンロードフォルダにはいくつのファイルがありますか。"

2番目のサンプル質問

ii. "report.txtファイルの内容を私のデスクトップフォルダから要約する。"

iii. "ダウンロードフォルダにtodo.txtという新しいファイルを作成し、次のタスクを追加する:[タスクリスト]。"

iv. "image.pngファイルを私のデスクトップフォルダからダウンロードフォルダに移動する。"

Claudeはファイルシステム上でのアクションを実行する前に、あなたの許可を求めることを忘れないでください。

ファイルシステムMCPサーバーのための許可を許可する

結論

MCPサーバーをClaudeと統合することで、あなたのローカルファイルとのインタラクションの新しいレベルが解放され、生産性が向上し、ワークフローが合理化されます。この設定により、ドキュメント分析からコード編集までのタスクにAIの力を活用できると同時に、データと環境を制御することができます。このモデルコンテキストプロトコルClaudeの使用を開始するための素晴らしいチュートリアルです。

ボタン