概要
セルフホストの AnythingMCP にマウントした Windows ファイルサーバー、NAS、ネットワーク共有(SMB/CIFS または NFS)の中を Cursor で検索できます。PDF、Excel、Word、Outlook ファイルの全文インデックスをバックグラウンドで同期します。セルフホスト専用です。
こう聞いてみよう
Network folder (File Search) のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
Cursor でネットワークフォルダを使う
セルフホスト専用です。 ネットワークフォルダはセルフホストの AnythingMCP にのみ存在します。AnythingMCP Cloud では、代わりに SFTP または WebDAV で NAS に接続してください。
要点: セルフホストの AnythingMCP が動作するサーバーに共有を読み取り専用でマウントし、そのフォルダーを File Search コネクタとして追加します。AnythingMCP は対応するすべてのファイルの全文をインデックス化し、インデックスを同期した状態に保ちます。ファイルがネットワークの外に出ることはありません。その後、AnythingMCP を Cursor に接続します。Cursor はファイル名と内容でファイルを探し、必要なページを読み取り、ファイル自体を添付または一時ダウンロードリンクとして渡せます。共有に書き込まれることは一切ありません。
AI アシスタントは単独ではネットワークドライブを開けません。仮に開けたとしても、1 つの質問に答えるために全ファイルをダウンロードしなければならなくなります。インデックスがあるからこそ、「現在の価格表で品番 NT-601 はいくらですか?」といった質問に数秒で答えられます。
必要なもの
- 有償ライセンスまたは 30 日間トライアルが有効なセルフホストの AnythingMCP。AnythingMCP Cloud はネットワーク共有に到達できません。SMB(ポート 445)はインターネットに公開すべきではないためです。
- Docker ホストに読み取り専用でマウントした共有(例:
/mnt/knowledge)。SMB/CIFS または NFS、Windows ファイルサーバー、NAS ボリュームのいずれでも構いません。 .envとdocker-compose.ymlを編集するための Docker ホストへのシェルアクセス。
セットアップ
ステップ 1 — 共有をマウントして File Search を有効にする
- 共有を Docker ホストに読み取り専用でマウントします(例:
/mnt/knowledge)。 appコンテナとfiles-workerコンテナに読み取り専用でバインドし(docker-compose.ymlのコメントを参照)、.envにFILE_SOURCE_ROOTS=/mnt/knowledgeを設定します。ウィザードにはこのルート配下のフォルダーだけが表示されます。- File Search のサービスを有効にします。
.envにFILES_WORKER_URL=http://files-worker:8891、FILES_WORKER_TOKEN、FILE_EXTRACTOR_TOKEN(それぞれopenssl rand -hex 24)、COMPOSE_PROFILES=filesを追加します。 docker compose up -dを実行します。Connectors → New → File Search で、ワーカーと抽出サービスに到達できるかどうかを確認できます。
すべての設定項目は File Search のドキュメントに記載されています。
ステップ 2 — File Search コネクタを設定する
AnythingMCP で Connectors → New → File Search を開き、Network folder を選択します(Marketplace では Network folder (File Search))。
- フォルダー。
FILE_SOURCE_ROOTS配下のフォルダーを選びます(例:/mnt/knowledge/Purchasing)。 - テスト。 保存する前に AnythingMCP がフォルダーの一覧を取得し、読み取り可能かどうかを表示します。
- スキャン。 Scan folder をクリックします。AnythingMCP はインデックス化せずにフォルダーの一覧を取得し、各サブフォルダーのファイル数、ファイルタイプ、年を含むツリーを表示します。アーカイブのように見えるフォルダー(
Alt、Old、Archive、Backup)は最初からチェックが外れているため、Cursor が古いドキュメントを引用することはありません。フォルダー、ファイルタイプ、または経過期間の上限を選択している間、選択内容とプランを比較するバーが表示されます。選択がプランの上限を超える場合は、さらにチェックを外すかアップグレードしてください。 - 説明。 AnythingMCP はスキャン結果からコネクタの説明の下書きを作成します(例: 「Purchasing share: supplier price lists and conditions, PDF and Excel, German, 2019–2026」)。このテキストは、フォルダーに何が入っていて、いつ検索すべきかを Cursor に伝えます。サーバーに AI モデルが設定されている場合、ウィザードで AI による下書き作成ができ、送信される内容(フォルダー名、ファイル名、最大 20 件のサンプルファイルの先頭 2,000 文字、個人データはマスク済み)が正確に表示されます。設定されていない場合は、フォルダー構造から下書きが作成されます。必要に応じて自由に編集してください。
- 有効化。 ツールプレフィックス、同期間隔、コネクタを割り当てる MCP サーバーを選択して、Activate をクリックします。
最初の同期はすぐに始まり、独立したバックグラウンドサービスで実行されます。同期中も Cursor や他のコネクタは通常の速度で応答します。コネクタの Files タブには、見つかったファイル数、インデックス化済みおよびスキップしたファイル数、前回と次回の同期、Sync now ボタンといった進行状況が表示されます。
ステップ 3 — サーバー URL をコピーする
MCP Servers で、ウィザードで選択したサーバーを開き、その URL をコピーします。
ステップ 4 — Cursor にコネクタを追加する
サーバー URL: AnythingMCP で MCP Servers → このコネクタを割り当てたサーバーを開き、その URL をコピーします(
https://anythingmcp.example.com/mcp/…の部分はご自身のアドレスになります)。このガイドでYOUR_SERVER_IDと書かれている箇所に使用してください。
Cursor はあなたのコンピューター上で動作するため、自社ネットワーク内の AnythingMCP にも接続できます。このステップで https://anythingmcp.example.com と書かれている箇所には、ご自身のインスタンスのアドレスを使用してください。
Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加します。
{
"mcpServers": {
"anythingmcp": {
"url": "https://anythingmcp.example.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYの代わりに貼り付けます。 - ファイルを保存して Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧に表示され、接続されていることを確認します。 - チャットを始めます。エージェントがファイル検索ツールを呼び出せるようになります。
ステップ 5 — 質問する
新しいチャットを開き、ファイルの内容について質問します。Cursor はまずインデックスを検索し、一致したページを開いて、ファイル名、ページ、ファイルの日付とともに回答します。これにより、情報源を確認できます。
Cursor でファイルに対してできること
| ツール | 機能 |
|---|---|
<prefix>_guide | このフォルダーの検索方法 |
<prefix>_search | インデックス化されたすべてのページの全文検索: 最適なページ、スニペット、日付を含むファイル。フォルダー、ファイルタイプ、日付で絞り込め、指定すれば新しい順に表示 |
<prefix>_find | ファイル名(タイプミスを許容)またはパターンでファイルを検索 |
<prefix>_list | 1 つのフォルダーを表示: 件数付きのサブフォルダー、サイズと日付付きのファイル |
<prefix>_read | ファイルをテキストとして読み取り。ページ指定("1-3,7")または文字数のウィンドウ単位 |
<prefix>_grep | コードや数値の完全一致検索(前後 2 行のコンテキスト付き)。スプレッドシートの行は列名付きで返される |
<prefix>_status | 同期状態、件数、一時停止の理由、内容の概要 |
<prefix>_view_page | PDF の 1 ページまたは画像ファイルを画像として表示: 図面、スタンプ、写真、テキストでは捉えられない表 |
<prefix>_get_file | ワークスペースのメンバー向けの一時ダウンロードリンクとしてのファイル自体(画像は添付もされる) |
<prefix>_share_file | 一時リンク(社内向けまたは公開)。インストール時は無効 |
<prefix> は、ウィザードで選択したツールプレフィックスです(例: pricelists)。_share_file 以外のすべてのツールは読み取りのみを行います。
対応ファイル: 100 種類以上のファイルタイプからテキストを抽出します。PDF(ページ単位)、マクロ付きやテンプレート形式を含む Word、Excel、PowerPoint と .xlsb、OpenDocument、添付ファイルのテキストを含む Outlook の .msg、.eml、.mbox、.rtf、.epub、.xps、Apple の Pages、Numbers、Keynote(PDF プレビュー経由)、.svg と .dxf CAD 図面のテキスト、CSV、Markdown、HTML、XML、JSON、YAML、カレンダーと連絡先、ソースコードです。それ以外のファイルもファイル名で検索でき、PDF のページや画像は画像として AI に見せることができます。テキストレイヤーのないスキャン PDF は、Enterprise で OCR により読み取られます。
Cursor で試せるプロンプト
- 「Nordtor の最新の価格表を探して、NT-601 875 x 2000 の価格を教えてください。」
- 「共有内のどのドキュメントに、3 か月の予告期間が記載されていますか?」
- 「Purchasing フォルダーで品番 4711-200 を検索し、それが出てくるすべての行を表示してください。」
- 「30 日より前の返品について、社内手順にはどう書かれていますか? 該当する段落とファイルを引用してください。」
同期の仕組み
AnythingMCP は各ファイルのサイズと更新日時を前回の実行時と比較し、新規および変更されたファイルだけを読み取ります。内容がインデックス化済みのバージョンと同一のファイルはチェックサム(SHA-256)で判別され、再処理されません。削除されたファイルはインデックスから除外されます。読み取れないファイルは次回以降の同期で再試行され、3 回失敗すると(パスワード保護されたファイルは即時)ファイル名では検索できる状態のまま残り、理由は Files タブに表示されます。
同期は、Cursor に応答するサーバーとは別の専用バックグラウンドサービスで実行されます。大規模な初回同期でも質問への応答が遅くなることはなく、同期中も最新のインデックスで検索が動作し続けます。
フォルダーがプランの上限を超えた場合、一部だけをインデックス化するのではなく、何かをダウンロードする前に同期が一時停止します。Files タブには、フォルダー内のファイル数とプランの上限が表示され、Cursor はすでにインデックス化されたファイルの検索を続け、新しいファイルが含まれていない可能性があることを通知されます。この場合、フォルダーのチェックを外すかアップグレードできます。一時停止中のフォルダーは 1 日 1 回再チェックされ、上限内に収まれば自動的に再開します。
セキュリティ
- 読み取り専用。 コネクタは一覧表示と読み取りのみを行います。共有上で書き込み、名前変更、削除を行うツールはありません。
- ワークスペース内のみ。 インデックスはワークスペースごとに保存され、すべてのクエリはアプリケーションとデータベース(Row-Level Security)の両方でそのワークスペースに制限されます。
- テキスト抽出サービスは、外部への経路がなく、データベースもシークレットもない内部ネットワーク上で動作します。
- 誰が何を見られるかは MCP のロールに従います。ファイルツールを持たないロールには、それらは表示されません。Enterprise では、ロールごとにフォルダーを許可または拒否することもできます。
- ファイルの内容はデータです。 ツールは、ファイル内にある指示には決して従わないようモデルに伝えます。
- ファイルはネットワーク内に留まります。 質問に対してツールが返すもの(一致結果の一覧、ページのテキスト)だけが、使用している AI プロバイダーに送信されます。
- 二重の読み取り専用。 共有をホスト上で読み取り専用でマウントし、コンテナにも読み取り専用でバインドします。
プランごとの制限
| 30 日間トライアル | Starter | Team | Enterprise | |
|---|---|---|---|---|
| File Search コネクタ | 3 | 1 | 3 | 無制限 |
| インデックス化されたファイル(全コネクタ合計) | 2,000 | 500 | 2,000 | 無制限 |
| 自動同期 | 毎日 | 毎日 | 毎日 | 最短 5 分ごと |
| 1 日あたりの手動同期 | 3 | 1 | 3 | 無制限 |
| OCR、ロールごとのフォルダー権限、ワークスペースポリシー | – | – | – | ✓ |
最大ファイルサイズは FILES_MAX_FILE_BYTES で設定します(デフォルトは 100 MB)。File Search には有償ライセンス(Starter、Team、Enterprise)または 30 日間トライアルが必要です。無料の Community エディションでは、トライアル終了後は File Search を利用できません。すべてのプラン。
FAQ
Cursor は無料プランでカスタム MCP サーバーに対応していますか? はい。MCP は Hobby、Pro、Business プランで利用できます。
なぜ AnythingMCP Cloud では利用できないのですか? Cloud はインターネット経由でファイルにアクセスしますが、SMB(ポート 445)はインターネットに公開すべきではありません。Cloud では NAS 側の SFTP または WebDAV を使うか、共有の隣で AnythingMCP をセルフホストで運用してください。
セルフホストの Enterprise プランが必要ですか? いいえ。Starter には最大 500 ファイルの File Search コネクタが 1 つ、Team には 2,000 ファイルのコネクタが 3 つ含まれます。Enterprise では制限がなくなり、OCR、ロールごとのフォルダー権限、ワークスペースポリシーが追加されます。
AnythingMCP は共有のすべてをコピーしますか? いいえ。AnythingMCP が保持するのは抽出したテキストであり、ファイルではありません。ファイルが再度読み取られるのは、変更された場合、またはファイル自体を要求した場合のみです。
ベクトル検索は使われますか? いいえ。社内ドキュメントでは正確な名前、コード、数値を検索するため、ページ単位の結果を返すキーワード検索のほうがエンベディングよりも信頼できます。
関連記事
- AI で社内ファイルサーバーを検索する
- AI で仕入先価格表から価格を探す
- AI で Nextcloud と WebDAV のファイルを検索する
- AI チャットからファイルをダウンロードリンクとして共有する
- ネットワークフォルダまたは Windows ファイルサーバーを Claude に接続する
- ネットワークフォルダまたは Windows ファイルサーバーを ChatGPT に接続する
- ネットワークフォルダまたは Windows ファイルサーバーを Gemini に接続する
- ネットワークフォルダまたは Windows ファイルサーバーを Microsoft Copilot に接続する
- ネットワークフォルダまたは Windows ファイルサーバーを Muse に接続する
- Cursor のその他のファイルソース: SFTP サーバー、FTP / FTPS サーバー、WebDAV サーバー、S3 バケット、Nextcloud、ownCloud、Synology NAS、QNAP NAS、Fritz!Box ストレージ、Hetzner Storage Box
このガイドは役に立ちましたか?