WebMCP: trasformare un convertitore di file in uno strumento che gli agenti IA possono richiamare — WebConverter

Nota del redattore (2026-05). Chrome 150 ha deprecato navigator.modelContext a favore di document.modelContext (secondo la PR #184 della specifica WebMCP). Gli esempi in questo articolo usano il pattern di feature detection compatibile in avanti raccomandato dal team Chrome:

const modelContext = document.modelContext || navigator.modelContext;
if (modelContext) {
  // Register tools...
}

L'integrazione di WebConverter usa esattamente questo fallback, quindi continua a funzionare sui browser che espongono ancora il vecchio identificatore.

Il Model Context Protocol (MCP) ha standardizzato il modo in cui gli agenti IA richiamano gli strumenti. WebMCP porta quell'idea sul web aperto: invece di un processo server separato, è il sito web stesso a esporre strumenti tramite un'API del browser — document.modelContext — che un agente nel browser può scoprire e invocare. Abbiamo appena rilasciato un'integrazione WebMCP per WebConverter, trasformando ogni conversione che il sito può eseguire in uno strumento richiamabile dagli agenti che continua a funzionare al 100% localmente nel tuo browser.

Che cos'è WebMCP?

WebMCP è una bozza di standard web del W3C Web Machine Learning Community Group, progettata da ingegneri di Google e Microsoft. Definisce un singolo nuovo punto di accesso sull'oggetto navigator del browser: document.modelContext. Una pagina chiama registerTool() per pubblicare uno strumento con un nome — con una descrizione e un JSON Schema per i suoi input — e fornisce una funzione execute() che il browser (o un agente che agisce tramite esso) invoca quando lo strumento viene richiamato.

La differenza chiave rispetto all'MCP classico: non c'è alcun trasporto separato, alcun server localhost, alcun token da gestire. Lo strumento è il JavaScript della pagina stessa. Per un convertitore orientato alla privacy questo è decisivo — l'agente ottiene la capacità, ma il tuo file non lascia mai la scheda.

Perché un "File Converter MCP" è importante

Chiedi oggi a un assistente IA di convertire un file e di solito ha tre cattive opzioni: caricare il file su un'API di terze parti, eseguire uno strumento lato server che tocca i tuoi dati, oppure rifiutare. Un convertitore basato su WebMCP cambia i conti: nessun caricamento, nessuna chiave API, nessun limite di frequenza, nessun costo e carbonio quasi nullo perché il percorso carica-elabora-scarica non avviene mai.

Gli strumenti che abbiamo esposto

WebConverter registra due strumenti tramite document.modelContext: list_supported_formats, che restituisce i formati di input leggibili e i formati di output scrivibili affinché un agente possa pianificare una conversione valida; e convert_image, che riceve un file base64 più un formato di destinazione e restituisce il file convertito come base64 e un URL data:. Poiché gli strumenti incapsulano la pipeline Worker esistente, tutto ciò che il convertitore di immagini può fare ora può farlo anche un agente.

Come lo abbiamo realizzato

L'integrazione è un singolo piccolo script differito caricato su tutto il sito. Definisce i descrittori degli strumenti, li registra con l'API dello standard quando document.modelContext esiste e espone inoltre un piccolo registro programmatico che replica le stesse definizioni — una giuntura di automazione documentata affinché gli strumenti siano testabili e utilizzabili anche su browser che non hanno ancora rilasciato l'API nativa. L'intera cosa è incapsulata in modo che un Worker mancante o un WASM bloccato non possano mai propagare un errore alla pagina ospite, e aggiunge solo pochi kilobyte — nessun nuovo WebAssembly.

Una nota su fiducia e sicurezza

Gli strumenti richiamabili dagli agenti meritano attenzione. Gli strumenti di WebConverter sono di sola lettura per design: ricevono byte e restituiscono byte. Non scrivono mai su disco, non effettuano mai richieste di rete, non leggono mai altre schede e non persistono mai nulla. Un agente che richiama convert_image ha esattamente la capacità di un essere umano che clicca su "converti" — e non un bit di più.

Provalo

Apri la pagina WebMCP per una demo dal vivo che pilota lo strumento convert_image e un riferimento completo degli schemi degli strumenti. Se stai costruendo un agente, ecco come si presenta uno strumento di conversione file onesto, privato e a costo zero — ed è semplicemente una pagina web.