Как подключить QNAP NAS к Cursor

QNAP NAS в Cursor

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

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

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

• Разрешённый SFTP (Control Panel → Network & File Services → Telnet/SSH → Allow SFTP) или включённый WebDAV, если ты предпочитаешь WebDAV.
• Пользователь QNAP с доступом только для чтения к общей папке.
• Для AnythingMCP Cloud: NAS должен быть доступен из интернета, а порт проброшен на твоём роутере. Self-hosted AnythingMCP может обращаться к нему по локальной сети.
• Рабочее пространство AnythingMCP: AnythingMCP Cloud (7 дней бесплатно) или собственная self-hosted установка.

Это работает с QTS и QuTS hero. SMB (порт 445) из Cloud недоступен: ему не место в интернете. Используй SFTP или WebDAV либо self-hosted AnythingMCP.

Настройка

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

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

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

• «Найди в папке Engineering технический паспорт насосов серии K-300.»
• «В каких протоколах испытаний упоминается модель двери Nordtor NT-601?»
• «Найди все строки Excel с артикулом 4711-200.»
• «Что находится в самом новом файле папки Orders?»

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

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

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

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

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

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

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

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

FAQ

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

SFTP или WebDAV на QNAP? Подойдёт любой. SFTP разрешается в Control Panel → Network & File Services → Telnet/SSH. Запись в Marketplace открывает мастер с SFTP.

Нужно ли открывать NAS в интернет? Для AnythingMCP Cloud — да: пробрось порт. Self-hosted AnythingMCP в той же сети обращается к NAS без проброса портов.

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

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

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

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