Integrazioni MCP
Cos'è WebMCP, come usarlo oggi e quali sono i suoi limiti.
Questa pagina tratta due aspetti correlati ma distinti: WebMCP, uno standard del browser implementato direttamente nelle pagine degli strumenti di questo sito, e il Model Context Protocol (MCP) in senso più ampio, per qualsiasi client compatibile con MCP che voglia basarsi sui metadati delle funzionalità documentati nell'hub per sviluppatori.
Cos'è davvero WebMCP#
WebMCP è una proposta del W3C Web Machine Learning Community Group, redatta da ingegneri di Google Chrome e Microsoft Edge (la presentazione pubblica si trova su github.com/webmachinelearning/webmcp). Definisce document.modelContext, un'API del browser che una pagina web usa per registrare strumenti strutturati — con un nome, una descrizione e uno schema JSON per gli input — che un agente AI nella stessa scheda del browser dell'utente può individuare e chiamare.
OpenAI non ha creato questo standard, ma lo ha adottato: il browser integrato di ChatGPT, ChatGPT Work e Codex hanno iniziato a individuare e chiamare strumenti WebMCP su siti come questo intorno al 2026-08-25. Il protocollo proprietario di OpenAI, Apps SDK, è un modello MCP con widget distinto e lato server, che richiede un backend: questo sito non lo usa perché gli strumenti locali non hanno un backend da contattare.
Come usarlo oggi#
Apri una qualsiasi pagina di questo sito in un browser con un'interfaccia AI che supporta già WebMCP — al momento della stesura, tra queste ci sono Gemini in Chrome e il browser integrato di ChatGPT (incluso Codex) — e chiedile di eseguire un'operazione con uno strumento PDF. L'agente può elencare gli strumenti, aprirne uno e, dopo che avrai selezionato i file, eseguirlo o chiederti prima di confermare le impostazioni.
Non serve alcuna configurazione da parte tua, oltre a usare un browser o un'interfaccia agente compatibile con WebMCP. Per questo sito non c'è nulla da installare, autorizzare o configurare.
Individuare gli strumenti con i client MCP#
/llms.txt e /llms-full.txt sono il modo più rapido per consentire a un client compatibile con MCP di elencare gli strumenti disponibili, le relative categorie e le pagine che ne regolano l'uso (questa pagina, Privacy e Sicurezza).
/agents/webmcp.json (e il relativo alias /.well-known/webmcp.json) è il catalogo statico per l'integrazione con il browser. In un browser compatibile, gli strumenti live document.modelContext sono quelli autorevoli perché riflettono la pagina attuale e gli input selezionati dall'utente; il catalogo statico è un ripiego per i client che non hanno caricato la pagina.
/.well-known/security.txt è pubblicato per gli strumenti di sicurezza automatizzati e segue RFC 9116; non è un percorso generico per individuare le funzionalità e non va usato a tale scopo.
WebMCP e MCP remoto sono interfacce diverse#
WebMCP funziona all'interno di un browser compatibile e condivide in tempo reale con l'utente la pagina visibile, i file locali selezionati, l'avanzamento e i risultati. Funziona senza inviare i byte dei documenti a un server MCP separato, perché non c'è alcun server separato nel flusso.
Questa app non gestisce un server MCP remoto (utilizzabile da desktop o server) e non prevede di aggiungerne uno per i suoi strumenti locali: non c’è un backend a cui uno strumento locale possa fare chiamate. Un client MCP desktop o lato server non ottiene automaticamente accesso agli strumenti del browser descritti in questa pagina: avrebbe bisogno di una propria integrazione con un browser compatibile con WebMCP.
I limiti, senza giri di parole#
Devi scegliere tu i file. Al momento, le specifiche di WebMCP non prevedono un meccanismo per trasmettere i byte dei file: un agente non può mai inviare un file a questo sito e gli strumenti del sito non possono mai chiederne uno tramite WebMCP. Ogni strumento qui opera solo sui file che hai già selezionato tramite il selettore file del browser o trascinandoli e rilasciandoli: un’azione nativa dell’utente che nessuna pagina o script può eseguire al posto tuo.
I byte dei documenti non arrivano mai a un agente. I nomi dei file sono la sola eccezione, circoscritta: lo strumento list_loaded_files nella pagina dello strumento attivo restituisce nomi, dimensioni e numero di pagine, così un agente può dirti cosa risulta caricato. Il contenuto dei file, invece, non è mai incluso in alcuna risposta WebMCP, di nessuno strumento e in nessuna pagina.
Non esiste un server MCP remoto separato, perché questa app non ha un backend a cui gli strumenti locali possano fare chiamate. Tutto ciò che WebMCP fa qui avviene nella scheda del browser che stai usando.
Mostrare i rifiuti con trasparenza#
Quando uno strumento rifiuta un’operazione invece di fingere che sia riuscita (Encrypt PDF è l’esempio più chiaro: vedi Sicurezza), un agente dovrebbe mostrarti il messaggio di rifiuto, senza riprovare di nascosto né nasconderlo dietro un errore generico.