Automatizza la conversione di immagini con la CLI Contenta, il server MCP e gli agenti IA

Pubblicato il 2 luglio 2026 · 9 min di lettura

La maggior parte delle persone conosce Contenta Converter tramite la procedura guidata di Windows: trascini una cartella di foto, scegli un formato, clicchi su converti. Ma la procedura guidata è solo uno dei modi per usarlo. Lo stesso identico motore di conversione — oltre 100 formati, RAW da 600+ fotocamere, ridimensionamento, effetti — viene fornito anche con un'interfaccia a riga di comando completa, un server MCP integrato e skill pronte per gli agenti di programmazione IA.

Questo articolo attraversa tutti e tre i livelli: creare script con la CLI contenta, collegare il server MCP a Claude Desktop o Claude Code, e lasciare che un agente IA esegua l'intera pipeline di immagini a partire da una richiesta in linguaggio naturale. Tutto ciò che vedi qui è incluso nell'installer standard — nessun download separato, nessuna licenza aggiuntiva.

La CLI contenta: lo stesso motore, in versione script

L'eseguibile si chiama contenta e si installa insieme all'app desktop — stesso installer, stessa licenza. Un'installazione predefinita lo mette in %LOCALAPPDATA%\Programs\ContentaConverter\ e aggiunge quella cartella al PATH, quindi contenta funziona da qualsiasi nuovo terminale.

Espone 13 comandi: convert, batch, info, effects, formats, pdf-album, slideshow, ai-transform, watch, profile, register, status e serve. Gli input sono posizionali — punti un comando a un file o a una cartella e aggiungi le opzioni. Convertire un RAW Canon in un JPEG di alta qualità è una sola riga:

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

L'elaborazione batch funziona allo stesso modo — basta puntare a una cartella. Questo ridimensiona un'intera directory di foto prodotto entro 2000 × 2000 pixel e le salva come JPEG:

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

Ogni comando accetta --json per un output leggibile dalle macchine e restituisce codici di uscita corretti, così la CLI si inserisce senza attriti in script PowerShell, pipeline bash, job CI e attività pianificate.

Ricette di automazione reali

Due schemi coprono la maggior parte di ciò che i nostri utenti automatizzano. Entrambi girano senza supervisione una volta configurati.

1. La cartella monitorata che lavora da sola

Il comando watch monitora una cartella e converte automaticamente ogni immagine nuova o modificata. Lo avvii una volta e continua a girare — metti dentro i file, escono convertiti:

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

Avvialo all'accesso tramite l'Utilità di pianificazione e avrai un servizio di conversione a zero clic: scansioni, foto dal telefono e importazioni dalla fotocamera arrivano nella cartella di ingresso, e pochi secondi dopo i WebP pronti per il web compaiono nella cartella di uscita.

2. La pipeline di ridimensionamento per l'e-commerce

I marketplace sono severi sulle dimensioni delle immagini — Amazon, ad esempio, richiede foto prodotto su una tela 2000 × 2000. Un solo comando batch trasforma lo scarico di una scheda di memoria in una cartella pronta per il caricamento:

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

Avvolgilo in uno script di due righe e ogni nuovo servizio fotografico passa dalla fotocamera al marketplace con un solo comando — file RAW inclusi, dato che il motore decodifica nativamente oltre 600 formati di fotocamera.

Il server MCP: consegna il motore a un agente IA

MCP (Model Context Protocol) è lo standard aperto che gli assistenti IA usano per richiamare strumenti esterni. Contenta Converter include un server MCP integrato — si avvia con un solo comando:

contenta serve

Espone 10 strumenti — conversione singola e batch, rilevamento del formato, lettura e scrittura dei metadati, rimozione dello sfondo con IA, album PDF, slideshow e altro — e funziona già durante la prova gratuita. Per collegare Claude Desktop, aggiungi questo al tuo claude_desktop_config.json:

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

Da quel momento puoi chiedere al tuo assistente cose come “converti tutti gli HEIC nella cartella Download in JPEG” e lui chiamerà direttamente il motore locale. Le tue immagini non lasciano mai il tuo computer — l'agente orchestra, la conversione gira in locale.

Skill per Claude Code: elaborazione di immagini in linguaggio naturale

Se usi Claude Code, la skill /contenta-image-processing è inclusa nel plugin Contenta Converter insieme al server MCP: una sola installazione dà all'agente entrambi. Due comandi:

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

In Cursor, Claude Desktop, VS Code o qualsiasi altro client MCP, aggiungi questa voce server (richiede Node.js 18 o successivo):

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

Poi descrivi il lavoro con parole tue:

• “Ridimensiona ogni foto di questa cartella per Amazon ed Etsy”
• “Converti questi file CR2 in JPEG con qualità al 92%”

La skill traduce la richiesta nei comandi contenta giusti, li esegue, controlla i codici di uscita e riferisce. Tu approvi il piano; l'agente digita.

Tutto documentato su GitHub

Il sorgente del plugin, il riferimento del server MCP e la documentazione della CLI sono nel repository GitHub pubblico, e il pacchetto launcher è pubblicato su npm:

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

La documentazione è mantenuta insieme al prodotto, quindi ciò che leggi lì corrisponde al binario sul tuo disco. Copia le ricette direttamente nei tuoi script, oppure apri una issue se incontri un caso limite.

Domande frequenti