Che cos’è WebMCP e perché è importante

WebMCP è una proposta di standard web nata nel Web Machine Learning Community Group del W3C. Il suo obiettivo è consentire a una pagina web di dichiarare agli agenti AI, che operano direttamente nel browser, quali azioni mette a disposizione: cercare, filtrare, compilare un modulo, leggere lo stato di un carrello e così via.

Ogni azione è definita come un tool con tre componenti fondamentali: un nome univoco, una descrizione in linguaggio naturale e uno schema JSON dei parametri di ingresso (inputSchema) e, facoltativamente, di uscita (outputSchema). Grazie a questa dichiarazione, l’agente non deve più dedurre dal DOM quale bottone premere o quale campo compilare: chiama semplicemente la funzione e riceve un risultato strutturato.

Chrome sta sperimentando WebMCP in origin trial, mentre ChatGPT lo usa già nel browser della sua app desktop. La specifica W3C è stata aggiornata il 13 novembre 2026. Per chi gestisce un sito con funzioni interattive, gli strumenti per provare WebMCP sono già disponibili, ed è il momento ideale per capire come funzionano prima che gli agenti nel browser diventino un nuovo canale di traffico.

Lo stato dell’arte (novembre 2026)

La specifica W3C

WebMCP è attualmente in fase di Draft Community Group Report. La versione più recente, datata 13 novembre 2026, è pubblicata sul sito del W3C. Non è ancora uno standard approvato, perciò interfacce e nomi possono ancora cambiare.

L’API è esposta su document.modelContext e ruota attorno a tre metodi principali:

    • registerTool()
    • getTools()
    • executeTool()

Una nota importante per chi ha seguito le guide del 2025: il metodo navigator.modelContext.provideContext(), citato in quelle versioni, è stato rimosso. Il codice deve ora utilizzare document.modelContext.registerTool().

Chrome: dev trial, origin trial e flag

Secondo ChromeStatus, WebMCP è in dev trial da Chrome 146 e in origin trial da Chrome 149 a 156, con estensione fino a Chrome 162. La console di registrazione dell’origin trial indica il 30 marzo 2027 come data di fine. Lo stato della funzione in Chrome è “Proposed”.

Ci sono due modalità per attivare l’API:

    • In produzione: iscrivere il dominio all’origin trial e inserire il token fornito nelle pagine; l’API si attiva per i visitatori che usano Chrome 149 o successivo.
    • In sviluppo locale: abilitare il flag chrome://flags/#enable-webmcp-testing e riavviare il browser.

Alcune funzionalità sono state introdotte in versioni successive del trial:

    • outputSchema disponibile da Chrome 159.
    • l’annotazione debugging da Chrome 156.
    • rimozione di un tool senza interrompere le esecuzioni in corso da Chrome 153.
    • deprecazione del passaggio di argomenti come stringa JSON da Chrome 155 (imperative API).

Come funziona WebMCP: le due API

API dichiarativa

L’API dichiarativa consiste nel registrare i tool nella pagina mediante document.modelContext.registerTool(). Il codice tipico è:

document.modelContext.registerTool({

name: "search_products",

description: "Cerca prodotti nel catalogo in base a query e filtri",

inputSchema: {

type: "object",

properties: {

query: {type: "string"},

category: {type: "string"},

priceRange: {type: "array", items: {type: "number"}}

},

required: ["query"]

},

outputSchema: {

type: "object",

properties: {

results: {type: "array", items: {type: "object"}}

}

}

});

Una volta registrati, gli agenti possono interrogare la pagina con document.modelContext.getTools() per ottenere l’elenco dei tool disponibili, scegliendo quello più adatto alla richiesta dell’utente.

API imperativa

L’API imperativa permette di invocare direttamente un tool registrato:

const result = await document.modelContext.executeTool("search_products", {

query: "cuffie wireless",

category: "audio",

priceRange: [50, 200]

});

Il risultato è un oggetto JSON conforme allo outputSchema dichiarato. L’esecuzione avviene all’interno della pagina, con la sessione dell’utente, per cui le azioni (ad esempio aggiungere un prodotto al carrello) sono immediatamente visibili nell’interfaccia.

Implementazione pratica: esempio WordPress

Per chi utilizza WordPress, è possibile aggiungere rapidamente due tool di sola lettura tramite un piccolo plugin. Il plugin registra:

    • getproductdetails: restituisce nome, prezzo e disponibilità di un prodotto dato il suo ID.
    • getcartstatus: restituisce il numero di articoli e il totale corrente del carrello.

Ecco il codice principale del plugin (semplificato):

addaction('wphead', function() {

?>

});

Il plugin è stato testato in Chrome con l’origin trial attivo e funziona correttamente sia in modalità sviluppo locale che in produzione, purché il token dell’origin trial sia incluso nell’header HTTP.

Sicurezza e controlli di consenso

OpenAI, nella sua implementazione “Site tools” per ChatGPT desktop, prevede un controllo di sicurezza prima che il sito esegua un tool. Le azioni sensibili (invio messaggi, acquisti, cancellazioni) richiedono conferma esplicita dell’utente. Inoltre, l’utente può disattivare tutti i Site tools dalle impostazioni del browser (Impostazioni > Browser > Autorizzazioni).

WebMCP non impone meccanismi di consenso a livello di specifica, ma è consigliabile adottare le seguenti best practice:

    • Mostrare all’utente, in modo chiaro, quali tool sono disponibili prima della loro esecuzione.
    • Richiedere conferma per azioni che modificano lo stato dell’account o effettuano pagamenti.
    • Validare i parametri in ingresso sul server (anche se il tool è eseguito client‑side) per prevenire injection.

Impatto sulla SEO

Dal punto di vista dei motori di ricerca, WebMCP non altera direttamente il contenuto indicizzato, ma può influenzare il ranking in due modi:

    • Riducendo gli errori di “actuation” da parte degli agenti AI, migliora la user experience e, di conseguenza, metriche come il tempo di permanenza.
    • Fornendo dati strutturati (inputSchema e outputSchema) che i crawler possono interpretare, potenzialmente arricchendo i risultati di ricerca con “rich snippets”.

È comunque importante mantenere i tool sincronizzati con la logica di business: un tool non più supportato o con schema obsoleto può generare “allucinazioni” negli agenti AI, con effetti negativi sulla percezione dell’affidabilità del sito.

Confronto WebMCP vs MCP

Il nome può creare confusione: WebMCP non è un’estensione del Model Context Protocol (MCP) né lo sostituisce. Google utilizza l’analogia “MCP è un call center, disponibile ovunque; WebMCP è un esperto in negozio, disponibile solo mentre l’utente è sulla pagina”.

Le differenze principali sono:

CaratteristicaMCPWebMCP
Dove vivono i toolSu un serverNella pagina web
Chi li chiamaQualsiasi client MCPUn agente con accesso alla pagina renderizzata
Quando sono disponibiliFinché il server è attivoSolo a pagina aperta
Login usatoCredenziali proprieSessione dell’utente
ComponentiTool, resource, promptSolo tool
Uso miglioreAttività in background, accesso ai datiAzioni sul sito durante la navigazione

In sintesi, MCP è ideale per integrazioni server‑to‑server o per agenti che operano fuori dal contesto di una pagina, mentre WebMCP è pensato per interazioni immediate con l’interfaccia utente.

Quando e come adottare WebMCP

WebMCP è consigliato in questi scenari:

    • Siti e‑commerce con ricerca prodotti, filtri e checkout complessi.
    • Applicazioni SaaS dove gli utenti devono eseguire operazioni ricorrenti (es. generare report).
    • Piattaforme di supporto dove gli agenti AI devono aprire ticket, aggiornare stato o recuperare informazioni utente.

Per iniziare:

    • Verificare la compatibilità del browser (Chrome 149+ con origin trial attivo).
    • Definire i tool necessari, scegliendo nomi descrittivi e creando schemi JSON precisi.
    • Implementare la registrazione dei tool con document.modelContext.registerTool().
    • Testare le chiamate tramite la console di Chrome o usando l’interfaccia di ChatGPT “Site tools”.
    • Documentare le policy di consenso e aggiungere UI di avviso per l’utente.

Una volta in produzione, monitorare i log di esecuzione (Chrome for Developers fornisce eventi di debugging) e aggiornare gli schemi quando la logica di business evolve.

Prospettive future

Il trial di Chrome dovrebbe concludersi a marzo 2027. Se la community accoglierà positivamente la proposta, è plausibile che WebMCP diventi parte integrante di un futuro standard W3C, con supporto esteso anche da Firefox, Safari ed Edge. Nel frattempo, gli sviluppatori possono trarre vantaggio dal fatto che la API è già disponibile in Chrome e che OpenAI sta integrando i “Site tools” nei propri agenti.

Adottare WebMCP ora significa preparare il proprio sito a una nuova era di interazione AI‑driven, riducendo la dipendenza da heuristics basate sul DOM e migliorando la robustezza delle automazioni. Con una corretta implementazione, sicurezza e comunicazione all’utente, i tool WebMCP possono diventare un canale di traffico aggiuntivo, capace di aumentare conversioni e soddisfazione del cliente.