WebMCP

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky
François Beaufort
François Beaufort
GitHub
Kasper Kulikowski
Kasper Kulikowski
X GitHub LinkedIn

Pubblicazione: 18 maggio 2026, Ultimo aggiornamento: 7 ottobre 2026

WebMCP è uno standard web proposto per aiutarti a creare ed esporre strumenti strutturati per gli agenti AI. WebMCP fornisce JavaScript e annota gli elementi dei moduli 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 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à degli agenti e può essere aggiunto come potenziamento progressivo.

Video esplicativo Web Estensioni Chrome Status Intenzione
GitHub Origin trial Origin trial Visualizza Intent to Experiment

Perché WebMCP?

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

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

A sinistra, l'agente esegue lo scraping del DOM. A destra, l'agente chiama uno strumento. Prova la 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 sulla tua pagina web in modo visibile, così gli utenti hanno la certezza che le attività vengano completate come previsto. In questo modo, anche il tuo brand e le tue scelte di design incentrate sulle persone rimangono intatti.

WebMCP supporta:

  • Discovery: un modo standard per le pagine di registrare gli strumenti con gli agenti, come 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 gli utenti possano completare le attività più facilmente. Puoi seguire questo processo su GitHub.

Casi d'uso

Esistono molti modi per utilizzare WebMCP. 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 passare più rapidamente al 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, per più città e 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à:

  • Compilare moduli strutturati: crea uno strumento submit_application per aiutare gli agenti a mappare correttamente la raccolta dei dati 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 in 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 gli sviluppatori, in modo che un agente possa attivare correzioni che altrimenti sarebbero nascoste dietro menu nidificati.

Il tuo caso d'uso non è presente? O hai un'idea che non vedi l'ora di condividere per WebMCP? Fai domande e partecipa alla discussione su GitHub.

Inizia

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

WebMCP locale

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

  1. Apri Chrome e vai all'indirizzo 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, come input di moduli, strumenti di navigazione, gestione dello stato o altre funzioni.
  • API dichiarativa: aggiungi annotazioni a un modulo HTML standard per creare uno strumento WebMCP.

Puoi eseguire il debug degli strumenti WebMCP e convalidare il modo in cui il browser analizza lo schema JSON con Chrome DevTools.

Limitazioni

Sebbene WebMCP miri a semplificare le attività complesse per gli agenti e gli esseri umani, esistono delle limitazioni:

  • Navigazione headless: sebbene sia possibile eseguire gli strumenti WebMCP in ambienti headless, questa API è progettata principalmente per i workflow del browser locale con un human-in-the-loop.
  • Overhead per interfacce complesse: se il tuo sito è molto complesso, probabilmente dovrai rifattorizzare 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 richiamabili.

Policy sulle autorizzazioni

Entrambe le API sono regolate dalla tools policy sulle autorizzazioni. Il criterio viene impostato su self per impostazione predefinita, il che consente la registrazione degli strumenti nei contesti di primo livello e della stessa origine e la disattiva per gli iframe multiorigine.

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

Demo

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

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

Imita un agente per testare i tuoi strumenti

Abbiamo creato due estensioni di Chrome per aiutarti a capire come funzionano gli strumenti WebMCP nelle nostre demo e nelle tue applicazioni.

Installa l'estensione di Chrome di esempio per gli agenti per ispezionare, monitorare ed eseguire gli strumenti WebMCP con prompt in linguaggio naturale. In particolare, questa estensione considera sempre attendibili le annotazioni di WebMCP, che possono avvisare l'agente di azioni sensibili. Questo dimostra come uno strumento può avere un rendimento diverso con le annotazioni.

Per impostazione predefinita, questa estensione utilizza un piccolo server Node con un SDK AI. Le chiavi API sono obbligatorie e rimangono sul server locale. I prompt vengono inviati al modello gemini-3.6-flash per impostazione predefinita, ma puoi modificare la scelta del modello e del provider API nel file .env dell'estensione. Sono presenti campi per OpenAI, Google e Anthropic oppure, in alternativa, puoi personalizzare l'estensione per utilizzare un modello di un altro provider.

In alternativa, puoi utilizzare un modello lato client con l'API Prompt. Non sono necessarie chiavi API e i dati rimangono sul tuo dispositivo. Per farlo, attiva chrome://flags/#prompt-api-tool-use.

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

Per utilizzare Gemini per chiamare i tuoi strumenti, devi avere una chiave API, che fornisci nell'interfaccia dell'estensione. I prompt vengono inviati per impostazione predefinita al modello gemini-3.6-flash. Puoi selezionare un modello Gemini diverso con cui sperimentare o personalizzare il codice dell'estensione per utilizzare il modello di un altro provider.

Interagisci e condividi feedback

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

Avanti
API imperativa