Какой канал выбрать: веб-приложение, CLI, MCP, API или Self-host
Кратко
К одному и тому же движку документов ведут шесть дверей. Выбирайте по тому, кто или что запускает работу и куда может уйти файл, а не по привычке.
Таблица выбора
| Канал | Кто управляет | Куда попадают файлы | Лучше всего для | Что нужно |
|---|---|---|---|---|
| Веб-приложение | Вы, мышью | Облако Documentize | Разовые задачи, пробы, наглядный предпросмотр | Браузер |
| CLI-плагин | Вы или скрипт | Ваш компьютер (движок работает локально) | Повторяемые задачи, папки с файлами, cron, CI | Среда выполнения .NET 10, отдельная загрузка каждого плагина |
| MCP-сервер | ИИ-ассистент | Облако Documentize (ассистент передаёт ссылки на файлы) | «Сожми это, а потом сделай краткое содержание» в чате | MCP-клиент и, по желанию, ключ dmk_ |
| REST API | Ваша собственная программа | Облако Documentize | Встраивание в приложение | HTTP-клиент; см. оговорку на странице об API |
| Self-host | Ваша программа или веб-интерфейс, который вы размещаете | Только ваш сервер | Конфиденциальные данные, изолированные сети | Среда выполнения .NET 9 или Docker |
| Desktop-клиенты | Вы, в нативном окне или терминале | Облако либо локальный/собственный движок | Работа без браузера, при желании почти офлайн | Windows 10+, Linux или любой терминал |
Вопросы, которые решают выбор
- Должен ли файл оставаться внутри моей сети? Да: self-host или CLI-плагины (они обрабатывают файлы локально). Нет: подойдёт что угодно.
- Каждый раз ли человек сам выбирает файлы? Да: веб или desktop. Нет: CLI, API или MCP.
- «Вызывает» ли работу ИИ-ассистент? Да: MCP. Он создан так, чтобы модель могла находить инструменты, читать отказы и разумно повторять попытки.
- Нужно ли выстроить больше двух шагов подряд над множеством файлов? CLI-плагины в shell-скрипте или MCP с пакетными инструментами.
- Я строю на этом продукт? REST API или self-host, а также контракт плагинов, если вы расширяете систему.
Компромиссы, о которых стоит знать
- CLI-плагины работают на вашем железе. Нет загрузки на сервер и ожидания в очереди; но вам нужно установить среду выполнения .NET, файл лицензии (или работать в пробном режиме) и, в Linux, шрифты и
libgdiplus. - MCP и REST работают в облаке. Ваши файлы обрабатываются на серверах Documentize, а результаты доступны по ссылкам для скачивания. С точки зрения приватности относитесь к ним так же, как к веб-приложению.
- Self-host меняет удобство на контроль. Цикл обновлений на вас, но ничего не покидает вашу машину.
- Приложения на основе ИИ (аннотации, чат с PDF, чек-листы) работают в облаке; у некоторых есть и CLI-плагин, так что загляните в каталог.
Частые ошибки
- Использовать веб-приложение для пачки из 200 файлов. Берите CLI или MCP
ProcessBatch. - Отдавать ИИ-ассистенту конфиденциальные файлы без self-host. Используйте self-host и направьте клиенты на него.
- Ожидать, что CLI принимает
--input file.pdf. Это не так; о модели на основе папок читайте в разделе CLI-плагины.
См. также
- CLI-плагины · MCP · REST API · Self-host · Desktop