SFTPサーバーをGeminiに接続する方法

GeminiでSFTPを使う

結論: SFTPサーバーを File Search コネクタとして AnythingMCP に追加します。AnythingMCP はパスワードまたは秘密鍵で SSH ログインし、選択したフォルダの全文をインデックス化して、同期を保ちます。そのうえで AnythingMCP を Gemini CLI に接続します。Gemini はファイル名と内容の両方でファイルを見つけ、必要なページを読み取り、ファイル自体を添付または一時ダウンロードリンクとして渡せます。サーバーへの書き込みは一切行われません。

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

必要なもの

• フォルダを読み取れる SSH アカウント。できれば読み取り以外の権限がないものが理想です。パスワードでも秘密鍵でも使えます。
• ホスト名と SSH ポート（通常は 22）。
• AnythingMCP ワークスペース: AnythingMCP Cloud（7日間無料）または自己ホスト環境。

SFTP は SSH ファイル転送プロトコルであり、FTP over TLS ではありません。サーバーが FTP または FTPS の場合は、FTP / FTPS ガイドをご覧ください。Hetzner Storage Box、Synology NAS、QNAP NAS には、適切な設定を備えた専用の Marketplace エントリがあります。

セットアップ

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

AnythingMCP で Marketplace を開いて SFTP (File Search) を選ぶか、Connectors → New → File Search を開いて SFTP を選びます。短いウィザードが案内するので、長いフォームに入力する必要はありません。

1. 接続。 ホスト、ポート、ユーザー名、パスワードまたは秘密鍵、使用するフォルダ（例: /srv/documents）を入力します。
2. テスト。 保存する前に、AnythingMCP が接続し、サインインして、フォルダの一覧を取得します。チェックリスト（アドレス、到達性、暗号化、サーバーの身元、ログイン、フォルダ）が表示され、失敗した手順には対処方法も示されます。サーバーの SSH ホストキーもフィンガープリントとして表示されます。一度確認すれば、以降は異なるキーをパスワード送信前に AnythingMCP が拒否するため、サーバーになりすました相手から守られます。
3. スキャン。 Scan folder をクリックします。AnythingMCP はまだインデックス化せずにフォルダを一覧化し、各サブフォルダのファイル数、ファイルタイプ、年を示すツリーを表示します。アーカイブに見えるフォルダ（Alt、Old、Archive、Backup）は最初からチェックが外れているので、Gemini が古いドキュメントを引用することはありません。フォルダ、ファイルタイプ、期間の上限を選ぶあいだ、バーが選択内容とプランを比較して表示します。選択がプランを超える場合は、チェックをさらに外すか、プランをアップグレードしてください。
4. 説明。 AnythingMCP がスキャン結果からコネクタの説明文を下書きします（例: 「エンジニアリングチームのプロジェクト文書、PDF、Word、Excel、2021–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 と書かれている箇所には、この URL を使います。

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

{
  "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（ページ単位）、マクロ付き・テンプレート形式や .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 により読み取ります。

Gemini で試せるプロンプト

• 「プロジェクトフォルダでポンプシリーズ K-300 の仕様書を検索し、動作限界を要約してください。」
• 「Kessler の保守契約に触れているドキュメントはどれですか? 最終更新日はいつですか?」
• 「品番 NT-601 の Excel の行をすべて見つけて、それぞれのファイルとシートを一覧にしてください。」
• 「試運転チェックリストの最新版をダウンロードリンクで教えてください。」

同期の仕組み

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

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

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

セキュリティ

• 読み取り専用。 コネクタは一覧表示と読み取りのみを行います。サーバー上で書き込み、名前変更、削除を行うツールはありません。
• あなたのワークスペースのみ。 インデックスはワークスペースごとに保存され、すべてのクエリはアプリケーションとデータベース（Row-Level Security）の両方でそれに限定されます。
• 認証情報は暗号化して保存され、バックグラウンド同期サービスでのみ復号されます。Gemini や同僚が認証情報を見ることはありません。
• 誰が何を見られるかは MCP ロールに従います。ファイルツールのないロールには、それらは表示されません。Enterprise では、ロールごとにフォルダの許可・拒否も設定できます。
• ファイルの内容はデータとして扱われます。 ツールは、ファイル内に見つかった指示には決して従わないようモデルに伝えます。
• ホストキー固定。 確認した SSH ホストキーは接続のたびにチェックされ、異なるキーはパスワードや鍵が使われる前に拒否されます。
• 鍵ログイン。 秘密鍵を使えば、アカウントのパスワードを存在させる必要すらありません。
• 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

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

ウィザードに「サーバーが異なるホストキーを提示した」と表示されます。 サーバーが再インストールされたか、通信の途中に第三者がいる可能性があります。新しいフィンガープリントを確認する前に、サーバーの管理者に問い合わせてください（Files パネル → Edit selection → Test に戻る）。

パスワードと秘密鍵のどちらを使うべきですか? どちらも使えます。フォルダの読み取りしかできないアカウント用の秘密鍵が、最もクリーンな構成です。

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

ベクトル検索は使われますか? いいえ。社内文書では正確な名前、コード、数値を検索します。その用途では、ページ単位の結果を返すキーワード検索のほうが埋め込みより確実です。

関連

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