WebMCP

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Pubblicato il 18 maggio 2026, ultimo aggiornamento il 9 giugno 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 utente. Ciò può 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. Invece di un agente che esamina 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 un tool. Gli 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 sull'uomo e sul brand 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 ai 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'uomo: 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 delle applicazioni: 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 anteprima e condividi il tuo feedback.

Inizia

Partecipa alla prova dell'origine WebMCP da Chrome 149. Scopri di più su come iniziare a utilizzare le prove dell'origine.

WebMCP locale

WebMCP è disponibile come flag di Chrome per lo sviluppo 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 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.

Sicurezza e autorizzazioni

Le API WebMCP sono protette sia dai requisiti di isolamento dell'origine sia dalla policy relativa alle autorizzazioni.

Isolamento dell'origine

WebMCP è disponibile solo nei documenti isolati dall'origine. In questo modo, l'origine del documento rimane stabile per tutta la durata dello strumento.

Se in un documento è attivato document.domain (ad esempio utilizzando l'intestazione HTTP Origin-Agent-Cluster: ?0), le API WebMCP sono disattivate.

Policy relativa alle autorizzazioni

Entrambe le API sono protette dalla tools policy relativa alle autorizzazioni. La policy ha come valore predefinito self, che consente la registrazione degli strumenti nei contesti di primo livello e della stessa origine e la disattiva per gli iframe multiorigine.

Per consentire l'utilizzo degli strumenti WebMCP in un iframe multiorigine, aggiungi l'allow="tools" all'iframe.

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. Utilizza i prompt in linguaggio naturale per determinare se l'agente interagisce con gli strumenti WebMCP come previsto.

Con l'estensione, puoi:

  • Visualizzare gli strumenti registrati in una pagina monitorando l'API WebMCP.
  • 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 vedere se riesce a identificare e richiamare correttamente gli strumenti WebMCP appropriati. Per impostazione predefinita, i prompt vengono inviati al modello gemini-3-flash-preview.

Partecipa e condividi feedback

WebMCP è in fase di discussione attiva ed è soggetto a modifiche in futuro. Se provi queste API e hai feedback, saremo felici di riceverli.