Chi lavora con gli assistenti di programmazione AI lo sa bene: oggi è facilissimo farsi generare una presentazione o un report in HTML. Il problema arriva dopo. Il cliente vuole un PowerPoint che possa modificare, il collega vuole commentare una singola frase, il revisore vuole vedere cosa è cambiato prima di approvare. E così si finisce a copiare e incollare tra browser, PowerPoint e chat, perdendo formattazione, tempo e tracciabilità.
html-mcp-web nasce proprio per chiudere questo buco. Non è un generatore di slide e non è un editor online concorrente di Canva o Google Slides. È un livello di revisione locale, open source, che si mette tra la cartella con i file HTML prodotti dall'AI e il browser dove li guardi, li commenti e li rimandi all'agente per la correzione, fino all'export finale in PPTX editabile e PDF pronto da consegnare.
Cos'è html-mcp-web e quale problema risolve
html-mcp-web è un progetto open source pubblicato su GitHub dall'autore MiiKiyoshi e distribuito con licenza MIT, quindi liberamente utilizzabile, modificabile e integrabile anche in contesti commerciali, con i soli obblighi di mantenere copyright e licenza. La sigla MCP nel nome indica l'idea di fondo: esporsi come ponte verso gli agenti AI basati su Model Context Protocol e prompt da riga di comando, come quelli ormai diffusi per la generazione di codice e contenuti.
In pratica il programma trasforma qualsiasi cartella di slide o report HTML in un progetto revisionabile. Con un comando di inizializzazione viene creato un file di configurazione .html-mcp-web.yaml che descrive il layout, i file osservati e i modelli di partenza. Sono previsti due formati principali: slides 16:9 pensato per pitch, lezioni e proposte commerciali, e report A4 pensato per documenti lunghi, relazioni tecniche, dispense e dossier. I template di base vivono nella cartella di configurazione utente, in genere sotto ~/.config/html-mcp-web/templates/, e possono essere duplicati e adattati con logo, colori e font aziendali.
La differenza rispetto ai classici framework HTML per slide come Reveal.js o alle suite AI che generano presentazioni nel cloud è netta. Qui l'HTML resta la sorgente unica e versionabile con Git, resta in locale sulla propria macchina, non richiede abbonamenti o API a pagamento e non carica i dati dei clienti su servizi esterni. Il valore aggiunto non è generare da zero, ma gestire il giro di revisione umana che in Italia è quasi sempre obbligatorio prima di una consegna: correggi il tono, sistemi un prezzo, precisi una clausola, adatti una slide al gergo del cliente.
Per fondatori di piccole software house, agenzie di comunicazione, studi professionali e reparti marketing di PMI, questo significa poter usare l'AI per la bozza veloce senza rinunciare al controllo fine e al formato che il cliente si aspetta davvero, cioè un .pptx che si apre in PowerPoint, LibreOffice o Google Slides e si modifica senza impazzire.
A cosa serve davvero: casi d'uso per PMI, agenzie e freelance
Il primo caso d'uso è la proposta commerciale. Un'agenzia web, uno studio di design, una società di consulenza o una ditta di impianti genera con l'assistente AI una bozza di 12-15 slide in HTML a partire da appunti, capitolato o trascrizione di una call. Con html-mcp-web il team apre la presentazione nel browser, ogni membro seleziona paragrafi o titoli e lascia commenti ancorati esattamente a quella porzione di testo, non note generiche a margine. Il titolare risponde, chiede all'agente di riformulare solo quel blocco e approva la modifica prima che diventi definitiva.
Il secondo caso è il report periodico. Pensiamo a un consulente del lavoro che prepara un aggiornamento normativo per i clienti, a un commercialista che spiega una manovra fiscale, a un tecnico della sicurezza che deve produrre dispense per corsi obbligatori, a un'agenzia immobiliare che presenta un'analisi di zona. Il formato report A4 permette di scrivere una volta in HTML, raccogliere commenti puntuali dai colleghi e poi esportare sia il PDF istituzionale da inviare via PEC o caricare sul sito, sia il PPTX editabile da usare in aula o in riunione.
Il terzo caso è la formazione e la documentazione interna. Molte PMI italiane faticano a mantenere aggiornati manuali operativi, procedure e onboarding. Partire da un report HTML generato da procedure esistenti, farlo revisionare dai responsabili di reparto direttamente nel browser con commenti ancorati e poi esportarlo in slide per la formazione in presenza riduce drasticamente i tempi di produzione e gli errori di trascrizione.
Il quarto caso è la collaborazione asincrona con clienti esigenti. Anziché inviare bozze via email con indicazioni vaghe del tipo pagina 4, secondo paragrafo, forse cambierei, il cliente può aprire il link locale o l'anteprima condivisa, selezionare la frase incriminata e scrivere cosa non va. Tutto resta collegato al punto esatto del documento, con thread di discussione e proposte di modifica confrontabili prima e dopo. Per chi vende creatività e consulenza, questa precisione è percepita come professionalità e riduce i cicli infiniti di revisione.
Come funziona: selezione, commenti, agenti ed export
Il flusso di lavoro è volutamente semplice e pensato per chi già usa assistenti AI da terminale. Dopo aver copiato i file HTML, CSS, immagini SVG, PNG, JPG e WebP e JavaScript in una cartella di lavoro, si lancia il comando di init che scrive il file YAML di progetto. Poi si avvia la modalità di ascolto, in genere con un comando di tipo listen, che mette in piedi un piccolo server locale, per impostazione predefinita sulla porta 8765, e attiva il monitoraggio automatico dei file.
Aprendo l'indirizzo locale nel browser, in particolare Firefox che è il browser di riferimento per installazione e test, la presentazione appare con un livello aggiuntivo di interfaccia. L'utente può trascinare il mouse su una frase, un titolo o una cella e creare un commento ancorato a quella selezione. Si apre un thread dove è possibile discutere, allegare indicazioni e, quando serve, chiamare l'agente AI. È questo il passaggio chiave: non è un commento morto in un PDF, ma un'istruzione contestualizzata che l'agente riceve insieme al punto esatto del codice da toccare.
L'agente propone una correzione mostrando la differenza in stile prima e dopo, spesso rappresentata come rimozioni e aggiunte. L'umano può confrontare, chiedere varianti, rifiutare o premere Apply per applicare la modifica al file sorgente. Poiché il server osserva il filesystem, la pagina si aggiorna subito e il ciclo può continuare frase per frase senza mai uscire dal browser e senza incollare snippet di codice a mano.
Quando la revisione è completa arriva la seconda funzione distintiva: l'export. Con un'operazione dedicata il progetto genera un file PPTX davvero editabile, con caselle di testo, titoli e immagini modificabili in PowerPoint, e un PDF impaginato per stampa e archiviazione. Non si tratta di una semplice stampa fotografica della pagina, ma di una conversione pensata per mantenere struttura e modificabilità, così l'HTML resta l'originale versionabile e il PPTX diventa il derivato da consegnare. I template personalizzati permettono di garantire coerenza grafica tra diverse consegne senza rifare ogni volta l'impaginazione.
Dal punto di vista tecnico, tutto gira in locale su CPU comune, senza bisogno di GPU né di servizi cloud obbligatori. I requisiti dichiarati sono essenzialmente Python e Firefox, più un assistente AI da riga di comando che sappia leggere le istruzioni di installazione. Questo lo rende adatto a chi vuole mantenere dati sensibili, listini e materiali pre-gara dentro il proprio perimetro.
Installazione e flusso di lavoro passo passo
Il percorso consigliato per una prima prova è prudente e isolato, come si fa con qualsiasi tool che tocca file di lavoro. Si parte creando una macchina o una cartella di test senza segreti aziendali, si clona il repository da GitHub e si seguono le istruzioni del README affidando i controlli preliminari all'assistente AI, che verifica presenza di Python, Firefox e dipendenze.
Il secondo passo è non lavorare mai sugli originali. Si duplica una cartella di esempio fornita dal progetto, ad esempio quella per slide neutre, e si lancia l'inizializzazione solo sulla copia. Si controlla il file .html-mcp-web.yaml generato per capire layout scelto, pattern di file osservati come *.html, *.css, *.js, *.svg, *.png, *.jpg, *.webp e porta locale. Poi si avvia il server e si apre il browser su localhost con la porta indicata.
A questo punto si simula un vero giro di revisione: si seleziona un titolo troppo lungo, si apre un commento, si chiede all'agente di accorciarlo in stile più diretto, si confronta la proposta e si applica. Si prova poi a chiedere una modifica di stile su un intero blocco, una traduzione o una semplificazione del linguaggio tecnico. Infine si testa l'export in PPTX e PDF aprendoli in PowerPoint o LibreOffice per verificare font, interruzioni di pagina, immagini e caselle editabili.
Solo dopo questo giro ha senso creare un template aziendale. Si duplica un template esistente sotto la cartella di configurazione, si inseriscono colori sociali, copertina, piè di pagina con partita IVA e contatti, tipografia leggibile anche su proiettori datati, e lo si riusa come base per tutte le proposte future. Tenere HTML, YAML e asset sotto Git permette di tracciare chi ha chiesto cosa e di tornare indietro se una revisione peggiora il testo.
Perché conta nell'era degli agenti AI, limiti e dove trovarlo
html-mcp-web conta perché sposta l'attenzione dal generare di più al revisionare meglio. Gran parte degli strumenti AI promette bozze infinite, ma per una PMI italiana il collo di bottiglia non è produrre dieci versioni di una slide, è farne approvare una sola al cliente senza errori, nel formato giusto e con un linguaggio adatto. Portare commenti ancorati, approvazione umana e diff prima e dopo dentro il browser significa introdurre un vero human-in-the-loop leggero, senza costringere commerciali, docenti o consulenti a imparare Git o a leggere codice HTML.
Conta anche per una ragione di sovranità pratica. Lavorare in locale, con file osservati, template propri e nessun costo a token o abbonamento cloud obbligatorio, è coerente con i vincoli di molte realtà italiane: budget limitati, PC standard, attenzione alla privacy, necessità di consegnare file aperti e modificabili per gare, bandi e consigli di amministrazione. Mantenere l'HTML come sorgente unica evita la divergenza tra versione web, versione PowerPoint e versione PDF che affligge tanti uffici.
Vanno però dichiarati con onestà i limiti. È un progetto giovane, pensato per utenti a proprio agio con terminale, browser e nozioni base di HTML e CSS. Non è un editor drag-and-drop per chi non vuole vedere codice, non sostituisce un grafico per impaginazioni complesse e l'export PPTX, per quanto editabile, non sarà sempre pixel-identico al rendering web, soprattutto con animazioni, font particolari o layout molto creativi. Va provato su casi reali prima di prometterlo ai clienti e va tenuto aggiornato seguendo il repository, fissando la versione usata per i progetti importanti.
Il punto di riferimento ufficiale è la pagina GitHub all'indirizzo https://github.com/MiiKiyoshi/html-mcp-web, dove si trovano README, esempi, elenco dei template e istruzioni di installazione, con licenza MIT dichiarata. Per agenzie, freelance della presentazione, formatori e piccole software house che già generano bozze con l'AI ma perdono ore a trasformarle in file consegnabili, è oggi uno dei piccoli tool open source più concreti da mettere in valutazione: poco appariscente, molto operativo, orientato a chiudere il lavoro e non solo a iniziarlo.