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

S3-бакет в Cursor

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

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

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

• Endpoint: для Amazon S3 оставь поле пустым, для DigitalOcean Spaces укажи, например, https://fra1.digitaloceanspaces.com, для MinIO — 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), уже сняты с выбора, так что Cursor не процитирует устаревший документ. Пока ты отмечаешь папки, типы файлов или ограничение по возрасту, полоса сравнивает твой выбор с лимитом тарифа; если выбор больше лимита, сними отметки с лишнего или перейди на другой тариф.
4. Описание. AnythingMCP составляет черновик описания коннектора по результатам сканирования, например «Архив счетов поставщиков и накладных, PDF, 2023–2026». Этот текст подсказывает Cursor, что находится в папке и когда в ней нужно искать. Если на сервере настроена ИИ-модель, мастер может составить черновик с её помощью и точно сообщает, что отправляется (названия папок, имена файлов, первые 2 000 символов до 20 примеров файлов, персональные данные маскируются); в противном случае черновик строится по структуре папок. Отредактируй его как хочешь.
5. Активация. Выбери префикс инструментов, интервал синхронизации и MCP-серверы, которые получат коннектор, и нажми Activate.

Первая синхронизация стартует сразу и выполняется в отдельном фоновом сервисе: Cursor и другие твои коннекторы продолжают отвечать с полной скоростью. На вкладке Files коннектора виден прогресс: найденные, проиндексированные и пропущенные файлы, время последней и следующей синхронизации, а также кнопка Sync now.

Шаг 2 — Скопируй URL сервера

В разделе MCP Servers открой сервер, выбранный в мастере, и скопируй его URL.

Шаг 3 — Добавь коннектор в Cursor

URL твоего сервера: в AnythingMCP открой MCP Servers → сервер, на котором находится этот коннектор, и скопируй его URL (https://cloud.anythingmcp.com/mcp/…). Используй его везде, где в этом руководстве встречается YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь такую запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начни чат: теперь агент может вызывать инструменты файлового поиска.

Шаг 4 — Задай вопрос

Начни новый чат и спроси о содержимом твоих файлов. Cursor сначала выполнит поиск по индексу, откроет подходящие страницы и ответит, указав имя файла, страницу и дату файла, так что ты сможешь проверить источник.

Что Cursor может делать с файлами

<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.

Запросы для Cursor

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

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

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

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

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

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

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

Поддерживает ли Cursor пользовательские MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Работает ли это с 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-бакета к Gemini
• Подключение S3-бакета к Microsoft Copilot
• Подключение S3-бакета к Muse
• Другие источники файлов в Cursor: SFTP-сервер, FTP / FTPS-сервер, WebDAV-сервер, Nextcloud, ownCloud, Synology NAS, QNAP NAS, хранилище Fritz!Box, Hetzner Storage Box, Сетевая папка (на своём сервере)