Как подключить SFTP-сервер к Gemini

SFTP в Gemini

Коротко: добавь SFTP-сервер в AnythingMCP как коннектор File Search. AnythingMCP входит по SSH с паролем или приватным ключом, индексирует полный текст выбранной тобой папки и поддерживает индекс в актуальном состоянии. Затем подключи AnythingMCP к Gemini CLI. Gemini сможет находить файлы по имени и по содержимому, читать нужные страницы и отдавать тебе сам файл: вложением или временной ссылкой для скачивания. На сервер ничего не записывается.

ИИ-ассистент не может сам открыть SFTP-сервер, а если бы мог, ему пришлось бы скачивать каждый файл, чтобы ответить на один вопрос. Именно индекс позволяет получить ответ за секунды на вопрос вроде «сколько стоит артикул NT-601 в актуальном прайс-листе?».

Что потребуется

• SSH-учётная запись на сервере с правом чтения нужной папки, в идеале такая, которая больше ни на что не способна. Подойдут и пароль, и приватный ключ.
• Имя хоста и порт SSH, обычно 22.
• Рабочее пространство AnythingMCP: AnythingMCP Cloud (7 дней бесплатно) или собственная установка на своём сервере.

SFTP — это протокол передачи файлов по SSH, а не FTP поверх 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, что находится в папке и когда в ней стоит искать. Если на сервере настроена ИИ-модель, мастер может составить черновик с её помощью и точно сообщает, что при этом отправляется (названия папок, имена файлов, первые 2000 символов до 20 примеров файлов, персональные данные замаскированы); иначе черновик строится по структуре папок. Отредактируй его как захочешь.
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 читает 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. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp внутри Gemini CLI (или 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 и текст CAD-чертежей .dxf; CSV, Markdown, HTML, XML, JSON, YAML, календари и контакты; а также исходный код. Любой другой файл всё равно находится по имени, а страницы PDF и изображения можно показать ИИ как картинки. Отсканированные PDF без текстового слоя читаются с помощью OCR в тарифе Enterprise.

Запросы для Gemini

• «Найди в папке проекта спецификацию насосной серии K-300 и кратко опиши рабочие ограничения.»
• «Какие документы упоминают договор на обслуживание Kessler и когда они менялись в последний раз?»
• «Найди все строки Excel с артикулом NT-601 и перечисли для каждой файл и лист.»
• «Дай мне самую новую версию чек-листа пусконаладки в виде ссылки для скачивания.»

Как работает синхронизация

AnythingMCP сравнивает размер и время изменения каждого файла с последним запуском и скачивает только новые и изменённые файлы. Файлы, содержимое которых идентично проиндексированной версии, распознаются по контрольной сумме (SHA-256) и повторно не обрабатываются. Удалённые файлы исчезают из индекса. Файл, который не удаётся прочитать, повторно обрабатывается при следующих синхронизациях и после трёх неудач (сразу для файлов, защищённых паролем) остаётся доступным для поиска по имени, а причина указана на вкладке Files.

Синхронизация выполняется в собственной фоновой службе, отдельной от сервера, который отвечает Gemini: большая первая синхронизация не замедляет твои вопросы, а поиск продолжает работать по последнему индексу, пока идёт синхронизация.

Когда папка перерастает твой тариф, синхронизация приостанавливается до скачивания чего-либо, а не индексирует только часть: вкладка Files показывает, сколько файлов теперь в папке по сравнению с лимитом тарифа, Gemini продолжает искать по уже проиндексированным файлам и получает уведомление, что более новых файлов может не хватать, а ты можешь снять отметки с папок или перейти на другой тариф. Приостановленная папка проверяется раз в сутки и возобновляется сама, когда укладывается в лимит.

Безопасность

• Только чтение. Коннектор только перечисляет и читает. В нём нет инструмента, который записывает, переименовывает или удаляет что-либо на сервере.
• Только твоё рабочее пространство. Индекс хранится отдельно для каждого рабочего пространства, и каждый запрос ограничен им: сначала приложением, затем ещё раз базой данных (Row-Level Security).
• Учётные данные хранятся в зашифрованном виде и расшифровываются только в фоновой службе синхронизации. Gemini и твои коллеги никогда их не видят.
• Кто что видит определяется твоими MCP-ролями: роль без файловых инструментов их не видит. В Enterprise можно также разрешать или запрещать папки для каждой роли.
• Содержимое файла — это данные. Инструменты указывают модели никогда не выполнять инструкции, найденные внутри файла.
• Ключ хоста закреплён. SSH-ключ хоста, который ты подтвердил, проверяется при каждом подключении; другой ключ отклоняется до использования пароля или ключа.
• Вход по ключу. При использовании приватного ключа пароль для учётной записи вообще не должен существовать.
• AnythingMCP Cloud подключается только к серверам в публичном интернете: хост в частной сети отклоняется, в том числе после перенаправления. Сервер в твоей офисной сети должен быть доступен снаружи, либо ты запускаешь AnythingMCP на своём сервере рядом с ним.

Лимиты по тарифам

Self-hosted: Starter включает один коннектор File Search до 500 файлов, Team — три коннектора с 2000 файлов, Enterprise без ограничений и синхронизирует вплоть до каждых 5 минут; максимальный размер файла задаётся FILES_MAX_FILE_BYTES (по умолчанию 100 МБ). Для File Search в self-hosted нужна платная лицензия или 30-дневный пробный период с лимитами Team; в бесплатной редакции Community после пробного периода File Search недоступен. Все тарифы.

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и то, подключается ли он.

Мастер сообщает, что сервер предъявил другой ключ хоста. Сервер был переустановлен, либо между вами кто-то находится. Прежде чем подтверждать новый отпечаток, уточни у администратора сервера (панель Files → Edit selection → обратно к Test).

Пароль или приватный ключ? Подходят оба варианта. Приватный ключ для учётной записи, которая может только читать папку, — самая чистая настройка.

AnythingMCP копирует весь сервер? Нет. AnythingMCP хранит извлечённый текст, а не файлы. Файл читается повторно, только если он изменился или если ты запросил сам файл.

Используется ли векторный поиск? Нет. В корпоративных документах ищут точные имена, коды и числа, и здесь поиск по ключевым словам с результатами на уровне страниц надёжнее, чем эмбеддинги.

Связанные материалы

• Поиск по файловому серверу компании с помощью ИИ
• Поиск цен в прайс-листах поставщиков с помощью ИИ
• Поиск внутри файлов Nextcloud и WebDAV с помощью ИИ
• Передача файлов из чата с ИИ в виде ссылок для скачивания
• Как подключить 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, Сетевая папка (self-hosted)