Qué canal elegir en cada caso: aplicación web, CLI, MCP, API o autoalojamiento
En resumen
Seis puertas llevan al mismo motor de documentos. Elige según quién o qué inicia el trabajo y por dónde puede viajar el archivo, no por costumbre.
La tabla de decisión
| Canal | Quién lo maneja | Adónde van los archivos | Ideal para | Necesita |
|---|---|---|---|---|
| Aplicación web | Tú, con el ratón | La nube de Documentize | Trabajos puntuales, probar cosas, vista previa visual | Un navegador |
| Plugin de CLI | Tú o un script | Tu máquina (el motor se ejecuta en local) | Trabajos repetibles, carpetas de archivos, cron, CI | Entorno de ejecución .NET 10, una descarga por plugin |
| Servidor MCP | Un asistente de IA | La nube de Documentize (el asistente pasa URL de archivos) | «Comprime esto y luego resúmelo» en un chat | Un cliente MCP y, opcionalmente, una clave dmk_ |
| API REST | Tu propio programa | La nube de Documentize | Integrarlo en una aplicación | Un cliente HTTP; consulta la advertencia en la página de la API |
| Autoalojamiento | Tu programa o la interfaz web que alojas | Solo tu servidor | Datos confidenciales, redes aisladas | Entorno de ejecución .NET 9 o Docker |
| Clientes de escritorio | Tú, en una ventana nativa o en un terminal | La nube, o un motor local o autoalojado | Mantenerte fuera del navegador, con algo de trabajo sin conexión | Windows 10+, Linux o cualquier terminal |
Preguntas que lo deciden
- ¿Debe el archivo quedarse dentro de mi red? Sí: autoalojamiento, o plugins de CLI (procesan en local). No: cualquiera.
- ¿Elige una persona los archivos cada vez? Sí: web o escritorio. No: CLI, API o MCP.
- ¿Quien llama es un asistente de IA? Sí: MCP. Está pensado para que un modelo descubra herramientas, lea los rechazos y reintente con criterio.
- ¿Necesito encadenar más de dos pasos sobre muchos archivos? Plugins de CLI en un script de shell, o MCP con sus herramientas por lotes.
- ¿Estoy construyendo un producto encima? API REST o autoalojamiento, más el contrato de plugins si lo amplías.
Compromisos que conviene conocer
- Los plugins de CLI se ejecutan en tu hardware. Sin subida, sin esperar a una cola; pero instalas el entorno de ejecución .NET, un archivo de licencia (o trabajas en modo de evaluación) y, en Linux, fuentes y
libgdiplus. - MCP y REST están en la nube. Tus archivos se procesan en los servidores de Documentize y los resultados están disponibles mediante enlaces de descarga. Trátalo exactamente igual que la aplicación web en cuanto a privacidad.
- El autoalojamiento cambia comodidad por control. Tú llevas el ciclo de actualizaciones, pero nada sale de tu equipo.
- Las aplicaciones con IA (resúmenes, chat con un PDF, listas de comprobación) se ejecutan en la nube; algunas también tienen un plugin de CLI, así que revisa el catálogo.
Errores frecuentes
- Usar la aplicación web para un lote de 200 archivos. Usa CLI o MCP con
ProcessBatch. - Dar archivos confidenciales a un asistente de IA sin un autoalojamiento. Usa el autoalojamiento y apunta los clientes hacia él.
- Esperar que la CLI acepte
--input file.pdf. No lo hace; consulta Plugins de CLI para el modelo basado en carpetas.