WebMCP

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Pubblicato: 18 maggio 2026, ultimo aggiornamento: 1° ottobre 2026

WebMCP è uno standard web proposto per aiutarti a creare ed esporre strumenti strutturati per gli agenti AI. WebMCP fornisce JavaScript e annotazioni degli 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. Ciò può migliorare significativamente le prestazioni e l'affidabilità dell'attivazione dell'agente.

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

Video esplicativo Web Estensioni Stato di Chrome Intenzione
GitHub Origin trial Origin trial Visualizza Intenzione di sperimentare

Perché WebMCP?

WebMCP fornisce regole di interazione che colmano il divario tra applicazioni web e agenti, migliorando efficienza, affidabilità e completamento delle attività. 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 come previsto.

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

A sinistra, l'agente esegue lo scraping del DOM. A destra, l'agente chiama uno strumento. Prova tu stesso nella nostra demo di prenotazione degli appuntamenti.

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. In questo modo, il tuo brand e le scelte di design incentrate sull'uomo rimangono intatti.

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 sfruttare, in modo che i tuoi utenti possano completare più facilmente le attività. Puoi seguire questo processo 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 fino al modulo corretto e compilare i campi con le informazioni fornite dall'utente.
  • Migliorare la prenotazione di viaggi. Aiuta gli agenti a prenotare viaggi complessi, in più città e con più passeggeri in 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 senso pratico, 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.
  • Interazioni degli agenti di assistenza in interfacce incentrate sull'utente: alcuni campi sono progettati per gli utenti umani, ma potrebbero non essere compresi dagli agenti. Potresti 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 altrimenti nascoste dietro menu nidificati.

Il tuo caso d'uso non è presente? Oppure hai un'idea che ti entusiasma e che vorresti condividere per WebMCP? Porre domande e partecipare alla discussione su GitHub.

Inizia

Partecipa all'origin trial di WebMCP da Chrome 149. Scopri di più su come iniziare a utilizzare le prove di origine.

WebMCP locale

WebMCP è disponibile come flag di Chrome per lo sviluppo locale:

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

Utilizzare 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, come 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 gli agenti e gli utenti, esistono delle limitazioni:

  • Navigazione headless: anche se è possibile eseguire gli strumenti WebMCP in ambienti headless, questa API è progettata principalmente per i flussi di lavoro del browser locale con un intervento umano.
  • 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 un sito direttamente per sapere se dispone di strumenti richiamabili.

Policy sulle autorizzazioni

Entrambe le API sono controllate dai tools criteri di autorizzazione. Il criterio è impostato per impostazione predefinita su self, che consente la registrazione degli strumenti nei contesti di primo livello e stessa origine e la disattiva per gli iframe multiorigine.

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

Demo

Sono disponibili esempi di demo che coprono implementazioni sia imperative sia dichiarative:

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

Simulare la chat con un agente con l'estensione Inspector

Installa l'estensione Model Context Tool Inspector per sperimentare un agente e vedere come funzionano gli strumenti WebMCP nelle demo dal vivo o nelle tue applicazioni. Utilizza prompt in linguaggio naturale per determinare se l'agente interagisce con gli strumenti WebMCP come previsto.

Con l'estensione puoi:

  • Scopri quali strumenti sono registrati in una pagina monitorando l'API WebMCP.
  • Chiama manualmente gli strumenti ed esegui le funzioni.
  • Verifica che lo schema JSON sia definito correttamente e che il browser possa analizzare i dati come previsto dallo strumento.
  • Visualizza 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.

Partecipare e condividere feedback

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

Avanti
API imperativa