WebMCP

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Pubblicato il 18 maggio 2026

WebMCP è uno standard web proposto per aiutarti a creare ed esporre strumenti strutturati per gli agenti AI AI. WebMCP fornisce JavaScript e annota gli elementi del modulo HTML in modo che gli agenti sappiano esattamente come interagire con le funzionalità della pagina, per supportare l'esperienza di un utente. In questo modo è possibile migliorare significativamente le prestazioni e l'affidabilità dell'attivazione degli agenti.

Gli agenti AI sono una tecnologia più recente. Possono aiutare gli utenti umani a completare meglio le attività altamente complesse e tecniche. WebMCP offre una maggiore accuratezza per il completamento delle attività agentiche e può essere aggiunto come potenziamento progressivo.

Perché WebMCP?

WebMCP può aiutarti a colmare il divario tra applicazioni web e agenti, migliorando l'efficienza, l'affidabilità e il completamento delle attività, fornendo regole per l'interazione. Anziché esaminare l'elemento, ad esempio un pulsante o un campo, per comprenderne lo scopo, il sito web dichiara lo scopo dell'elemento, in modo che venga utilizzato correttamente

Questo è più affidabile dell'attivazione, che può avere numerosi passaggi e lasciare ogni passaggio aperto all'interpretazione dell'agente.

I siti web possono condividere uno scopo esplicito, ad esempio la ricerca o l'acquisto, definendo uno strumento. Questi strumenti vengono eseguiti in modo visibile sulla tua pagina web, in modo che gli utenti si fidino che le attività vengano completate come previsto. Inoltre, le scelte di progettazione incentrate sul brand e sull'utente rimangono intatte.

WebMCP supporta:

  • Rilevamento: un modo standard per le pagine di registrare gli strumenti con gli agenti, ad esempio checkout o filter_results.
  • Schemi JSON: definizioni esplicite di input e output previsti, per ridurre le allucinazioni o i malintesi.
  • Stato: una comprensione condivisa del contesto della pagina corrente, in modo che l'agente sappia quali risorse sono disponibili per agire in tempo reale.

Il nostro obiettivo è creare API che qualsiasi browser con capacità agentiche possa implementare e di cui possa usufruire, in modo che gli utenti possano completare più facilmente le attività. Puoi seguire questa procedura su GitHub.

Casi d'uso

Esistono molti modi in cui puoi utilizzare WebMCP sul web. Ad esempio:

  • Aiuta i tuoi clienti a ricevere assistenza. Se fornisci un software ai clienti, potresti avere un flusso di assistenza complesso per rispondere a molte domande diverse. Puoi utilizzare WebMCP per aiutare un agente a navigare più rapidamente nel modulo corretto e a compilare i campi con le informazioni fornite dall'utente.
  • Migliora la prenotazione dei viaggi. Aiuta gli agenti a prenotare viaggi complessi, in più città e con più passeggeri con meno passaggi.

Alcune azioni potrebbero essere sensibili, ad esempio effettuare un acquisto. Puoi includere un comando per richiedere l'interazione dell'utente con una finestra di dialogo di conferma.

In pratica, i tuoi strumenti potrebbero svolgere le seguenti attività:

  • Compila moduli strutturati: crea uno strumento submit_application per aiutare gli agenti a mappare correttamente i dati raccolti dalla conversazione con l'utente nei campi del modulo. Ad esempio, puoi distinguere se un campo richiede un nome completo o un nome e un cognome separati.
  • Supporta le interazioni degli agenti nelle interfacce incentrate sull'utente: alcuni campi sono progettati per gli utenti umani, ma potrebbero non essere compresi dagli agenti. Puoi creare uno strumento date_pick che consenta una selezione complessa di data e ora in una prenotazione o in una prenotazione di eventi.
  • Debug più rapido dell'applicazione: puoi creare uno strumento run_diagnostics in una pagina delle impostazioni per sviluppatori, in modo che un agente possa attivare correzioni che altrimenti sono nascoste dietro i menu nidificati.

Il tuo caso d'uso non è presente? Oppure hai un'idea che ti entusiasma condividere per WebMCP? Partecipa al programma di accesso in anteprima e condividi il tuo feedback.

Inizia

WebMCP è disponibile come flag di Chrome per lo sviluppo locale. Sarà disponibile in una prova dell'origine in Chrome 149.

Per attivare WebMCP in locale:

  1. Apri Chrome e vai a chrome://flags/#enable-webmcp-testing
  2. Imposta il flag su Attivato.
  3. Riavvia Chrome per applicare le modifiche.

Utilizza le API WebMCP

Esistono due API che puoi utilizzare per configurare gli strumenti del tuo sito web:

  • API imperativa: definisci diversi tipi di strumenti con JavaScript standard, ad esempio input di moduli, strumenti di navigazione, gestione dello stato o altre funzioni.
  • API dichiarativa: aggiungi annotazioni a moduli HTML standard per creare uno strumento WebMCP.

Limitazioni

Sebbene WebMCP miri a semplificare le attività complesse per agenti e persone, esistono alcune limitazioni:

  • Contesto di navigazione richiesto: poiché le chiamate agli strumenti vengono gestite in JavaScript, è necessario aprire una scheda del browser o una visualizzazione web per fornire un'interfaccia visibile e un contesto del browser. In altre parole, non è previsto il supporto per gli agenti o gli strumenti di assistenza per chiamare gli strumenti in uno stato headless.
  • Più overhead per le interfacce complesse: se il tuo sito è molto complesso, probabilmente devi eseguire il refactoring o aggiungere JavaScript per gestire lo stato dell'applicazione e dell'interfaccia.
  • Rilevabilità degli strumenti: i client e i browser devono visitare direttamente un sito per sapere se dispone di strumenti chiamabili.

Demo

Sono disponibili esempi di demo che riguardano sia le implementazioni imperative sia quelle dichiarative:

Puoi anche esaminare ed esplorare il codice sorgente della demo su GitHub.

Imita la chat dell'agente con l'estensione dell'inspector

Installa l'estensione Model Context Tool Inspector per sperimentare con un agente e vedere come funzionano gli strumenti WebMCP nelle demo live o nelle tue applicazioni. Puoi inserire prompt in linguaggio naturale per verificare se un agente può interagire correttamente con gli strumenti WebMCP.

Con l'estensione puoi:

  • Visualizzare gli strumenti registrati in una pagina monitorando l'API navigator.modelContext.
  • Chiamare manualmente gli strumenti ed eseguire le funzioni.
  • Verificare che lo schema JSON sia definito correttamente e che il browser possa analizzare i dati come previsto dallo strumento.
  • Visualizzare l'output strutturato o i messaggi di errore restituiti dallo strumento per assicurarti che siano scritti in modo chiaro e formattati correttamente, in modo che un agente possa comprenderli.

Parla con l'agente utilizzando il linguaggio naturale per verificare se riesce a identificare e richiamare correttamente gli strumenti WebMCP appropriati. Per impostazione predefinita, i prompt vengono inviati al modello gemini-3-flash-preview.

Interagisci e condividi il tuo feedback

WebMCP è in fase di discussione attiva ed è soggetto a modifiche in futuro. Se provi queste API e hai feedback, non esitare a comunicarcelo.