Как подключить Hetzner Storage Box к Gemini

Hetzner Storage Box в Gemini

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

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

Что понадобится

• Имя хоста Storage Box: uXXXXXX.your-storagebox.de.
• Включённая поддержка SSH в настройках Storage Box. SFTP работает на порту 23, а не 22.
• Основной пользователь или, что лучше, субаккаунт, ограниченный одной папкой (Robot → Storage Box → Sub-accounts).
• Рабочее пространство AnythingMCP: AnythingMCP Cloud (7 дней бесплатно) или собственная установка на своём сервере.

Субаккаунт видит только свою папку. Создай такой для AnythingMCP, и коннектор не сможет прочитать остальную часть Storage Box, что бы ты ни отметил в мастере.

Настройка

Шаг 1 — Настрой коннектор File Search

В AnythingMCP открой Marketplace и выбери Hetzner Storage Box (File Search): откроется мастер File Search с SFTP и настройками для Storage Box. (Или открой Connectors → New → File Search и воспользуйся быстрым вариантом Hetzner Storage Box.)

1. Подключение. Введи uXXXXXX.your-storagebox.de, порт 23, субаккаунт и его пароль, а также папку, которую нужно использовать.
2. Проверка. AnythingMCP подключается, входит в систему и выводит список папки до того, как что-либо сохранится, и показывает чек-лист (адрес, доступность, шифрование, идентичность сервера, вход, папка) с подсказками, что исправить, если шаг не прошёл. Также показывается SSH-ключ хоста сервера в виде отпечатка: подтверди его один раз, и дальше AnythingMCP будет отклонять другой ключ ещё до отправки пароля, что защищает тебя от сервера, выдающего себя за твой.
3. Сканирование. Нажми Scan folder. AnythingMCP выводит список папки, пока ничего не индексируя, и показывает дерево с количеством файлов в каждой подпапке, типами файлов и годами. Папки, похожие на архивы (Alt, Old, Archive, Backup), уже сняты с выбора, поэтому Gemini не процитирует устаревший документ. Индикатор сравнивает твой выбор с лимитом тарифа, пока ты отмечаешь папки, типы файлов или ограничение по возрасту; если выбор превышает лимит тарифа, сними отметки с лишнего или перейди на тариф выше.
4. Описание. AnythingMCP составляет черновик описания коннектора по результатам сканирования, например «Выгруженные отчёты и архив документов бухгалтерии, PDF и Excel, 2019–2026». Этот текст сообщает Gemini, что находится в папке и когда в ней нужно искать. Если на сервере настроена модель ИИ, мастер может составить черновик с её помощью и точно указывает, что отправляется (названия папок, имена файлов, первые 2 000 символов не более чем из 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

• «Найди в архиве годовой отчёт за 2024 год и кратко изложи показатели выручки.»
• «В каких выгруженных отчётах Nordtor упоминается как поставщик?»
• «Найди все строки Excel с центром затрат 4711.»
• «Дай мне самую свежую ежемесячную выгрузку в виде ссылки для скачивания.»

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

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

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

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

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

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

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

На собственном сервере: Starter включает один коннектор File Search до 500 файлов, Team — три коннектора до 2 000 файлов, в 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 показывает каждый сервер и то, подключается ли он.

Почему порт 23? Storage Box предоставляет SFTP на порту 23, как только в его настройках включена поддержка SSH.

Основной пользователь или субаккаунт? Субаккаунт, ограниченный одной папкой: его можно создать в Robot в разделе Storage Box → Sub-accounts, и он не даёт AnythingMCP доступа ко всему остальному на хранилище.

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

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

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

• Поиск по файловому серверу компании с помощью ИИ
• Поиск цен в прайс-листах поставщиков с помощью ИИ
• Поиск внутри файлов Nextcloud и WebDAV с помощью ИИ
• Отправка файлов из чата с ИИ в виде ссылок для скачивания
• Как подключить Hetzner Storage Box к Claude
• Как подключить Hetzner Storage Box к ChatGPT
• Как подключить Hetzner Storage Box к Microsoft Copilot
• Как подключить Hetzner Storage Box к Cursor
• Как подключить Hetzner Storage Box к Muse
• Другие источники файлов в Gemini: сервер SFTP, сервер FTP / FTPS, сервер WebDAV, бакет S3, Nextcloud, ownCloud, Synology NAS, QNAP NAS, хранилище Fritz!Box, сетевая папка (на собственном сервере)