Automatiza la conversión de imágenes con la CLI de Contenta, el servidor MCP y agentes de IA

Publicado el 2 de julio de 2026 · 9 min de lectura

La mayoría conoce Contenta Converter por su asistente de Windows: arrastras una carpeta de fotos, eliges un formato y pulsas convertir. Pero el asistente es solo una forma de manejarlo. Exactamente el mismo motor de conversión — más de 100 formatos, RAW de 600+ cámaras, redimensionado, efectos — también se entrega con una interfaz de línea de comandos completa, un servidor MCP integrado y skills listas para agentes de programación con IA.

Este artículo recorre las tres capas: crear scripts con la CLI contenta, conectar el servidor MCP a Claude Desktop o Claude Code, y dejar que un agente de IA ejecute toda tu cadena de procesamiento de imágenes a partir de una petición en lenguaje natural. Todo lo que se muestra viene en el instalador estándar — sin descargas aparte ni licencias adicionales.

La CLI contenta: el mismo motor, en scripts

El ejecutable se llama contenta y se instala junto con la aplicación de escritorio — mismo instalador, misma licencia. Una instalación por defecto lo coloca en %LOCALAPPDATA%\Programs\ContentaConverter\ y añade esa carpeta a su PATH, así que contenta funciona desde cualquier terminal nuevo.

Ofrece 13 comandos: convert, batch, info, effects, formats, pdf-album, slideshow, ai-transform, watch, profile, register, status y serve. Las entradas son posicionales — apuntas un comando a un archivo o carpeta y añades opciones. Convertir un RAW de Canon a un JPEG de alta calidad es una sola línea:

contenta convert photo.cr2 --format jpg --quality 92

El procesamiento por lotes funciona igual — apunta a una carpeta. Esto redimensiona un directorio entero de fotos de producto para que quepan en 2000 × 2000 píxeles y las guarda como JPEG:

contenta batch ./photos --output ./ready --format jpg --resize 2000x2000 --resize-mode fit

Todos los comandos aceptan --json para salida legible por máquina y devuelven códigos de salida correctos, así que la CLI encaja limpiamente en scripts de PowerShell, pipelines de bash, trabajos de CI y tareas programadas.

Recetas de automatización reales

Dos patrones cubren la mayor parte de lo que automatizan nuestros usuarios. Ambos funcionan sin supervisión una vez configurados.

1. La carpeta vigilada que trabaja sola

El comando watch vigila una carpeta y convierte automáticamente cada imagen nueva o modificada. Lo inicias una vez y sigue funcionando — dejas archivos dentro y salen convertidos:

contenta watch ./incoming --output ./processed --format webp

Prográmalo al iniciar sesión con el Programador de tareas y tendrás un servicio de conversión sin un solo clic: escaneos, fotos del móvil e importaciones de cámara llegan a la carpeta de entrada, y segundos después aparecen WebP listos para la web en la carpeta de salida.

2. La cadena de redimensionado para e-commerce

Los marketplaces son estrictos con las dimensiones — Amazon, por ejemplo, exige fotos de producto en un lienzo de 2000 × 2000. Un solo comando batch convierte el volcado de una tarjeta de memoria en una carpeta lista para subir:

contenta batch ./photos --output ./ready --format jpg --resize 2000x2000 --resize-mode fit

Envuélvelo en un script de dos líneas y cada nueva sesión de producto pasa de la cámara al marketplace con un solo comando — archivos RAW incluidos, porque el motor decodifica de forma nativa más de 600 formatos de cámara.

El servidor MCP: pon el motor en manos de un agente de IA

MCP (Model Context Protocol) es el estándar abierto que usan los asistentes de IA para invocar herramientas externas. Contenta Converter incluye un servidor MCP integrado — se inicia con un solo comando:

contenta serve

Expone 10 herramientas — conversión individual y por lotes, detección de formato, lectura y escritura de metadatos, eliminación de fondo con IA, álbumes PDF, presentaciones y más — y funciona durante la prueba gratuita. Para conectar Claude Desktop, añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "contenta": {
      "command": "contenta",
      "args": ["serve"]
    }
  }
}

A partir de ahí puedes pedirle a tu asistente cosas como «convierte todos los HEIC de mi carpeta de Descargas a JPEG» y llamará directamente al motor local. Tus imágenes nunca salen de tu equipo — el agente orquesta, la conversión se ejecuta en local.

Skills de Claude Code: procesamiento de imágenes en lenguaje natural

Si usa Claude Code, la skill /contenta-image-processing viene incluida en el plugin de Contenta Converter junto con el servidor MCP, así que una sola instalación le da ambos al agente. Dos comandos:

/plugin marketplace add contentasoftware/contenta-converter-plugin
/plugin install contenta-converter@contenta-converter-plugin

En Cursor, Claude Desktop, VS Code o cualquier otro cliente MCP, añada esta entrada de servidor (requiere Node.js 18 o superior):

{
  "mcpServers": {
    "contenta-converter": { "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/contenta-converter-mcp"] }
  }
}

Después, describe el trabajo con tus propias palabras:

• «Redimensiona todas las fotos de esta carpeta para Amazon y Etsy»
• «Convierte estos archivos CR2 a JPEG con calidad del 92%»

La skill traduce la petición a los comandos contenta correctos, los ejecuta, comprueba los códigos de salida e informa. Tú revisas el plan; el agente teclea.

Todo documentado en GitHub

El código fuente del plugin, la referencia del servidor MCP y la documentación de la CLI están en el repositorio público de GitHub, y el paquete lanzador está publicado en npm:

github.com/contentasoftware/contenta-converter-plugin · npmjs.com/package/@contentasoft/contenta-converter-mcp

La documentación se mantiene junto con el producto, así que lo que lees allí coincide con el binario de tu disco. Copia las recetas directamente a tus propios scripts, o abre un issue si encuentras un caso límite.

Preguntas frecuentes