QNAP NASをGeminiに接続する方法

GeminiでQNAP NASを使う

結論: NASでSFTPを許可し、共有フォルダの読み取りだけができるユーザーを作成して、そのNASを File Search コネクタとしてAnythingMCPに追加します。AnythingMCPはそのフォルダの全文をインデックス化し、同期を保ちます。その後、AnythingMCPをGemini CLIに接続します。Geminiはファイル名と内容でファイルを探し、必要なページを読み取り、ファイル自体を添付または一時的なダウンロードリンクとして渡せます。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が接続、サインイン、フォルダの一覧取得を行い、チェックリスト（アドレス、到達性、暗号化、サーバーの識別、ログイン、フォルダ）を表示します。ステップが失敗した場合は、対処方法も表示されます。また、サーバーのSSHホストキーをフィンガープリントとして表示します。一度確認すると、以降は異なるキーをパスワード送信前に拒否するため、あなたのサーバーになりすました偽のサーバーから保護されます。
3. スキャン。 Scan folder をクリックします。AnythingMCPはインデックス化せずにフォルダの一覧を取得し、各サブフォルダのファイル数、ファイルの種類、年を示すツリーを表示します。アーカイブのように見えるフォルダ（Alt、Old、Archive、Backup）は最初からチェックが外れているため、Geminiが古い文書を引用することはありません。フォルダ、ファイルの種類、期間の上限を選択している間、選択内容とプランを比較するバーが表示されます。選択範囲がプランを超える場合は、さらにチェックを外すか、アップグレードしてください。
4. 説明。 AnythingMCPがスキャン結果からコネクタの説明文の下書きを作成します。例: 「共有フォルダ Engineering: 図面一覧、データシート、試験報告書、PDFとExcel、2019〜2026年」。このテキストは、フォルダの内容と検索すべきタイミングをGeminiに伝えます。サーバーにAIモデルが設定されている場合、ウィザードはAIで下書きを作成でき、送信される内容（フォルダ名、ファイル名、最大20個のサンプルファイルの先頭2,000文字、個人データはマスク済み）を正確に表示します。設定されていない場合は、フォルダ構造から下書きが作られます。自由に編集してください。
5. 有効化。 ツールのプレフィックス、同期間隔、このコネクタを利用するMCPサーバーを選び、Activate をクリックします。

最初の同期はすぐに始まり、別のバックグラウンドサービスで実行されます。そのため、同期中もGeminiや他のコネクタは通常どおりの速度で応答します。コネクタの Files タブで、見つかったファイル、インデックス化したファイル、スキップしたファイル、前回と次回の同期、Sync now ボタンなど、進行状況を確認できます。

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

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

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

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

Gemini CLIは ~/.gemini/settings.json（Windowsでは %USERPROFILE%\.gemini\settings.json）からMCPサーバーを読み込みます。次を追加します:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. ファイルを保存し、gemini を再起動します。
3. Gemini CLI内で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みと表示されるはずです。
4. プロンプトを入力します。Gemini CLIがファイル検索ツールを呼び出せるようになります。

ステップ4 — 質問する

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

Geminiがファイルで実行できること

<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により読み取られます。

Geminiで試すプロンプト

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

同期のしくみ

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

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

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

セキュリティ

• 読み取り専用。 コネクタは一覧取得と読み取りのみを行います。NASへの書き込み、名前変更、削除を行うツールはありません。
• ワークスペース限定。 インデックスはワークスペースごとに保存され、すべてのクエリはアプリケーションと、さらにデータベース（Row-Level Security）によってそのワークスペースに制限されます。
• 認証情報は暗号化して保存され、バックグラウンド同期サービスでのみ復号されます。Geminiや同僚が見ることはありません。
• 誰が何を見られるかは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には、有料ライセンスまたはTeamの上限が適用される30日間のトライアルが必要です。無料のCommunityエディションでは、トライアル終了後にFile Searchは使えません。すべてのプラン。

FAQ

Gemini CLIはどこでMCPサーバーを探しますか? ユーザー用の ~/.gemini/settings.json、またはプロジェクト内の .gemini/settings.json です。gemini mcp list で、各サーバーと接続できているかどうかを確認できます。

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をMicrosoft Copilotに接続する
• QNAP NASをCursorに接続する
• QNAP NASをMuseに接続する
• Geminiで使えるその他のファイルソース: SFTPサーバー、FTP / FTPSサーバー、WebDAVサーバー、S3バケット、Nextcloud、ownCloud、Synology NAS、Fritz!Boxストレージ、Hetzner Storage Box、ネットワークフォルダ（セルフホスト）