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

Hetzner Storage Box в Cursor

Коротко: добавь Storage Box в AnythingMCP как коннектор File Search по SFTP на порту 23, лучше всего с субаккаунтом, ограниченным одной папкой. AnythingMCP индексирует полный текст этой папки и поддерживает индекс в актуальном состоянии. Затем подключи AnythingMCP к Cursor. Cursor сможет находить файлы по имени и по содержимому, читать нужные страницы и отдавать тебе сам файл: вложением или в виде временной ссылки для скачивания. На 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), уже сняты с выбора, поэтому Cursor никогда не процитирует устаревший документ. Индикатор сравнивает твой выбор с тарифом, пока ты отмечаешь папки, типы файлов или ограничение по возрасту; если выбранное больше лимита тарифа, сними отметки с лишнего или перейди на другой тариф.
4. Описание. AnythingMCP составляет черновик описания коннектора по результатам сканирования, например: «Выгруженные отчёты и архив документов бухгалтерии, PDF и Excel, 2019–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

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

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

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

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

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

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

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

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

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