Как подключить S3-бакет к Gemini

S3-бакет в Gemini

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

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

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

• Endpoint: пустой для Amazon S3, например https://fra1.digitaloceanspaces.com для DigitalOcean Spaces или URL твоего MinIO.
• Регион и название бакета.
• Ключ доступа, который может только просматривать список файлов и читать этот бакет.
• Рабочее пространство AnythingMCP: AnythingMCP Cloud (7 дней бесплатно) или собственная установка на своём сервере.

В S3 нет настоящих папок: «папки», которые ты видишь в мастере, — это префиксы ключей, а выбранный тобой префикс ограничивает то, что индексируется. Подходят Amazon S3, DigitalOcean Spaces, MinIO, Wasabi, Hetzner Object Storage и Backblaze B2.

Настройка

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

В AnythingMCP открой Marketplace и выбери S3 bucket (File Search) либо открой Connectors → New → File Search и выбери S3. Тебя проведёт короткий мастер, длинную форму заполнять не нужно.

1. Подключение. Укажи endpoint (пустой для Amazon S3), регион, бакет, ключ доступа и его секрет, а также префикс, который нужно использовать, например invoices/.
2. Проверка. AnythingMCP подключается, выполняет вход и получает список папки до того, как что-либо сохранится, и показывает чек-лист (адрес, доступность, шифрование, идентичность сервера, вход, папка) с подсказками, что исправить, если какой-то шаг не пройден.
3. Сканирование. Нажми Scan folder. AnythingMCP получает список папки, ещё не индексируя её, и показывает дерево с количеством файлов в каждой подпапке, типами файлов и годами. Папки, похожие на архивные (Alt, Old, Archive, Backup), уже сняты с выбора, поэтому Gemini никогда не процитирует устаревший документ. Пока ты отмечаешь папки, типы файлов или ограничение по возрасту, индикатор сравнивает твой выбор с лимитами тарифа; если выбор превышает тариф, сними отметки с части папок или перейди на более высокий тариф.
4. Описание. AnythingMCP составляет черновик описания коннектора по результатам сканирования, например «Архив счетов поставщиков и накладных, PDF, 2023–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. Создай API-ключ MCP в 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

• «Найди в префиксе invoices все счета от Nordtor за 2025 год и сложи итоговые суммы.»
• «Найди накладную по заказу 4711-200 и расскажи, что было поставлено.»
• «В каких документах в бакете упоминается рамочное соглашение с Kessler?»
• «Дай мне PDF самого свежего ежемесячного отчёта в виде ссылки для скачивания.»

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

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

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

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

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

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

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

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

FAQ

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

Работает ли это с DigitalOcean Spaces, MinIO или Wasabi? Да. Укажи endpoint провайдера, например https://fra1.digitaloceanspaces.com для Spaces или URL своего MinIO; для Amazon S3 оставь поле пустым.

Какие права нужны ключу? Получение списка и чтение этого бакета, больше ничего. Коннектор никогда не пишет в бакет.

Может ли AnythingMCP Cloud достучаться до MinIO в нашей офисной сети? Нет. В Cloud endpoint должен находиться в публичном интернете. Запусти AnythingMCP на своём сервере рядом с частным MinIO.

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

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

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

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