QNAP NAS を Cursor に接続する方法

Cursor で使う QNAP NAS

結論: NAS で SFTP を許可し、共有フォルダの読み取りだけができるユーザーを作成して、その NAS を AnythingMCP に File Search コネクタとして追加します。AnythingMCP はそのフォルダの全文をインデックス化し、インデックスを同期し続けます。その後、AnythingMCP を Cursor に接続します。Cursor はファイル名や内容でファイルを探し、必要なページを読み取り、ファイル自体を添付または一時ダウンロードリンクとして渡せます。NAS には一切書き込みません。

AI アシスタントは単独では NAS を開けません。仮に開けたとしても、1 つの質問に答えるために全ファイルをダウンロードしなければならなくなります。インデックスがあるからこそ、「現在の価格表で品番 NT-601 はいくらですか?」といった質問に数秒で答えられます。

必要なもの

• SFTP の許可(コントロールパネル → ネットワークとファイルサービス → Telnet/SSH → SFTP を許可)。WebDAV を使う場合は WebDAV の有効化。
• 共有フォルダへの 読み取り専用 アクセス権を持つ QNAP ユーザー。
• AnythingMCP Cloud の場合: インターネットから NAS に到達できること。ルーターでポートを転送します。セルフホストの AnythingMCP ならローカルネットワーク経由で到達できます。
• AnythingMCP のワークスペース: AnythingMCP Cloud(7 日間無料)または自分でセルフホストした環境。

QTS と QuTS hero のどちらでも動作します。SMB(ポート 445)には Cloud から接続しません。インターネットに公開すべきではないためです。SFTP または WebDAV を使うか、セルフホストの AnythingMCP を利用してください。

セットアップ

ステップ 1 — File Search コネクタを設定する

AnythingMCP でマーケットプレイスを開き、QNAP NAS (File Search) を選びます。SFTP と QNAP 向けの設定が入った File Search ウィザードが開きます。(または Connectors → New → File Search を開き、QNAP のショートカットを使います。)

1. 接続。 NAS のアドレス(外部からの場合はルーターが転送するアドレス)、ポート、読み取り専用ユーザーとそのパスワード、共有フォルダを入力します。
2. テスト。 何かを保存する前に、AnythingMCP が接続、サインインし、フォルダを一覧表示します。アドレス、到達性、暗号化、サーバーの ID、ログイン、フォルダのチェックリストが表示され、失敗した手順については対処方法も示されます。サーバーの SSH ホストキーも フィンガープリント として表示されます。一度確認すれば、以降は異なるキーをパスワード送信前に AnythingMCP が拒否するため、自分のサーバーになりすました偽のサーバーから守られます。
3. スキャン。 Scan folder をクリックします。AnythingMCP はまだインデックス化せずにフォルダを一覧化し、各サブフォルダのファイル数、ファイルタイプ、年をツリーで表示します。アーカイブに見えるフォルダ(Alt、Old、Archive、Backup)は最初からチェックが外れているので、Cursor が古いドキュメントを引用することはありません。フォルダ、ファイルタイプ、期間の上限を選択している間、選択内容とプランを比較するバーが表示されます。選択がプランの上限を超える場合は、さらにチェックを外すか、アップグレードしてください。
4. 説明。 AnythingMCP がスキャン結果からコネクタの説明文を下書きします。例: 「共有フォルダ Engineering: 図面リスト、データシート、試験報告書。PDF と Excel、2019〜2026」。このテキストは、フォルダの内容と検索すべきタイミングを Cursor に伝えます。サーバーに AI モデルが設定されていれば、ウィザードで AI による下書きができ、送信される内容(フォルダ名、ファイル名、最大 20 個のサンプルファイルの先頭 2,000 文字、個人データはマスク済み)が正確に表示されます。設定されていない場合は、フォルダ構造から下書きが作られます。自由に編集できます。
5. 有効化。 ツールプレフィックス、同期間隔、このコネクタを利用する MCP サーバーを選び、Activate をクリックします。

最初の同期はすぐに始まり、別のバックグラウンドサービスで実行されます。実行中も Cursor や他のコネクタは通常の速度で応答し続けます。コネクタの Files タブには、見つかったファイル、インデックス化したファイル、スキップしたファイル、前回と次回の同期、Sync now ボタンといった進捗が表示されます。

ステップ 2 — サーバー URL をコピーする

MCP Servers で、ウィザードで選んだサーバーを開き、その URL をコピーします。

ステップ 3 — Cursor にコネクタを追加する

サーバー URL: AnythingMCP で MCP Servers → このコネクタが属するサーバーを開き、その URL(https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドで YOUR_SERVER_ID と書かれている箇所には、この URL を使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加します。

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象サーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY の代わりに貼り付けます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧に表示され、接続されていることを確認します。
4. チャットを始めます。エージェントがファイル検索ツールを呼び出せるようになります。

ステップ 4 — 質問する

新しいチャットを開き、ファイルの内容について質問します。Cursor はまずインデックスを検索し、一致したページを開いて、ファイル名、ページ、ファイルの日付とともに回答します。そのため、情報源を確認できます。

Cursor でファイルに対してできること

<prefix> はウィザードで選ぶツールプレフィックスです。例: pricelists。_share_file 以外のすべてのツールは読み取りのみを行います。

対応ファイル: 100 種類以上のファイルタイプからテキストを抽出します。PDF(ページ単位)、マクロやテンプレート形式および .xlsb を含む Word、Excel、PowerPoint、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 で試したいプロンプト

• 「Engineering フォルダで、ポンプシリーズ K-300 のデータシートを検索して。」
• 「Nordtor のドアモデル NT-601 に言及している試験報告書はどれ?」
• 「品番 4711-200 を含む Excel の行をすべて探して。」
• 「Orders フォルダの最新ファイルには何が書かれている?」

同期の仕組み

AnythingMCP は各ファイルのサイズと更新日時を前回の実行時と比較し、新規および変更されたファイルだけをダウンロードします。WebDAV では代わりに ETag を使います。内容がインデックス済みのバージョンと同一のファイルはチェックサム(SHA-256)で判別され、再処理されません。削除されたファイルはインデックスから消えます。読み取れないファイルは次回以降の同期で再試行され、3 回失敗すると(パスワード保護されたファイルは即座に)、名前では検索できる状態のまま残り、理由が Files タブに表示されます。

同期は、Cursor に応答するサーバーとは別の専用バックグラウンドサービスで実行されます。大規模な初回同期でも質問への応答は遅くならず、同期中も最新のインデックスで検索が動作し続けます。

フォルダがプランの上限を超えた場合、一部だけをインデックス化するのではなく、何かをダウンロードする前に同期が一時停止します。Files タブには、フォルダが現在保持するファイル数とプランの上限が表示されます。Cursor はすでにインデックス化されたファイルの検索を続け、新しいファイルが含まれていない可能性があることを伝えられます。フォルダのチェックを外すか、アップグレードできます。一時停止したフォルダは 1 日に 1 回再チェックされ、収まるようになれば自動的に再開します。

セキュリティ

• 読み取り専用。 コネクタは一覧表示と読み取りのみを行います。NAS への書き込み、名前変更、削除を行うツールはありません。
• 自分のワークスペースのみ。 インデックスはワークスペースごとに保存され、すべてのクエリはアプリケーションとデータベース(Row-Level Security)の両方でそのワークスペースに限定されます。
• 認証情報 は暗号化して保存され、バックグラウンドの同期サービスでのみ復号されます。Cursor や同僚の目に触れることはありません。
• 誰が何を見られるか は MCP のロールに従います。ファイルツールを持たないロールには、それらは表示されません。Enterprise では、ロールごとにフォルダの許可と拒否も設定できます。
• ファイルの内容はデータです。 ツールは、ファイル内にある指示には決して従わないようモデルに伝えます。
• 読み取り専用ユーザー。 QNAP ユーザーには、対象の 1 つの共有フォルダへの読み取り権限だけを付与し、それ以外は与えないでください。
• ホストキーの固定。 NAS の SSH ホストキーは接続のたびに検証されます。
• ポート転送。 使用するポートだけを転送し、それも AnythingMCP Cloud を使う場合に限ってください。
• AnythingMCP Cloud はパブリックインターネット上のサーバーにのみ接続します。プライベートネットワーク内のホストは、リダイレクト後も含めて拒否されます。オフィスのネットワーク内にあるサーバーは外部から到達可能にするか、その隣でセルフホストの AnythingMCP を実行する必要があります。

プラン別の制限

セルフホストの場合: Starter には最大 500 ファイルまでの File Search コネクタが 1 つ、Team には 2,000 ファイルまでのコネクタが 3 つ含まれます。Enterprise は無制限で、最短 5 分ごとに同期できます。最大ファイルサイズは FILES_MAX_FILE_BYTES(デフォルトは 100 MB)で設定します。セルフホストの File Search には、有料ライセンスまたは 30 日間のトライアル(Team の制限が適用されます)が必要です。無料の Community エディションでは、トライアル終了後は File Search を利用できません。すべてのプラン。

FAQ

Cursor の無料プランでもカスタム MCP サーバーは使えますか? はい、MCP は Hobby、Pro、Business の各プランで利用できます。

QNAP では SFTP と WebDAV のどちらを使うべきですか? どちらでも動作します。SFTP は コントロールパネル → ネットワークとファイルサービス → Telnet/SSH で許可します。マーケットプレイスのエントリは、SFTP を設定した状態でウィザードを開きます。

NAS をインターネットに公開する必要はありますか? AnythingMCP Cloud の場合は必要です。ポートを転送してください。同じネットワーク内のセルフホストの AnythingMCP なら、ポート転送なしで NAS に到達できます。

AnythingMCP は NAS の全データをコピーしますか? いいえ。AnythingMCP が保持するのは抽出したテキストであり、ファイルではありません。ファイルが再び読み取られるのは、変更されたとき、またはファイル自体を要求したときだけです。

ベクトル検索は使われますか? いいえ。社内ドキュメントでは正確な名前、コード、数値を検索するため、ページ単位の結果を返すキーワード検索のほうが埋め込みよりも信頼できます。

関連記事

• AI で社内ファイルサーバーを検索する
• AI で仕入先の価格表から価格を探す
• AI で Nextcloud と WebDAV のファイル内を検索する
• AI チャットからダウンロードリンクとしてファイルを共有する
• QNAP NAS を Claude に接続する
• QNAP NAS を ChatGPT に接続する
• QNAP NAS を Gemini に接続する
• QNAP NAS を Microsoft Copilot に接続する
• QNAP NAS を Muse に接続する
• Cursor のその他のファイルソース: SFTP サーバー、FTP / FTPS サーバー、WebDAV サーバー、S3 バケット、Nextcloud、ownCloud、Synology NAS、Fritz!Box ストレージ、Hetzner Storage Box、ネットワークフォルダ(セルフホスト)