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

QNAP NAS в Gemini

Коротко: разреши SFTP на NAS, создай пользователя, который может только читать общую папку, и добавь NAS в AnythingMCP как коннектор File Search. AnythingMCP индексирует полный текст этой папки и поддерживает индекс в актуальном состоянии. Затем подключи AnythingMCP к Gemini CLI. Gemini сможет находить файлы по имени и по содержимому, читать нужные страницы и отдавать тебе сам файл: во вложении или по временной ссылке для скачивания. На 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), уже сняты с выбора, так что Gemini никогда не процитирует устаревший документ. Пока ты отмечаешь папки, типы файлов или ограничение по возрасту, индикатор сравнивает твой выбор с лимитами твоего тарифа; если выбор больше лимита тарифа, сними отметки с части папок или перейди на более высокий тариф.
4. Описание. AnythingMCP составляет черновик описания коннектора по результатам сканирования, например: «Общая папка Engineering: перечни чертежей, технические паспорта и протоколы испытаний, 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

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

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

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

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

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

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

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

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

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

FAQ

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

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