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-testinge riavviare il browser.
Alcune funzionalità sono state introdotte in versioni successive del trial:
outputSchemadisponibile da Chrome 159.- l’annotazione
debuggingda 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:
| Caratteristica | MCP | WebMCP |
|---|---|---|
| Dove vivono i tool | Su un server | Nella pagina web |
| Chi li chiama | Qualsiasi client MCP | Un agente con accesso alla pagina renderizzata |
| Quando sono disponibili | Finché il server è attivo | Solo a pagina aperta |
| Login usato | Credenziali proprie | Sessione dell’utente |
| Componenti | Tool, resource, prompt | Solo tool |
| Uso migliore | Attività in background, accesso ai dati | Azioni 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.