WebMCP

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

Pubblicato: 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 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 Intent to Experiment

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.

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 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.

Norme relative alle 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.

Imitare un agente per testare gli 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 agentica di esempio per ispezionare, monitorare ed eseguire gli strumenti WebMCP con prompt in linguaggio naturale. In particolare, questa estensione considera sempre attendibili le annotazioni WebMCP, che possono avvisare l'agente di azioni sensibili. Ciò dimostra come uno strumento può funzionare in modo 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 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 dispositivo. Per farlo, attiva chrome://flags/#prompt-api-tool-use.

Installa l'estensione Model Context Tool Inspector per sperimentare 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 disporre di una chiave API, che fornisci nell'interfaccia dell'estensione. Per impostazione predefinita, i prompt vengono inviati al modello gemini-3.6-flash. Puoi selezionare un altro modello Gemini con cui sperimentare o personalizzare il codice dell'estensione per utilizzare il modello di un altro fornitore.

Partecipare e condividere feedback

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

Avanti
API imperativa