WebMCP

WebMCP ermöglicht es einer Webseite, einem KI-Agenten im Browser strukturierte Tools bereitzustellen. Erfahren Sie, wie es sich von MCP unterscheidet, was Chrome unterstützt, Sicherheitsrisiken und wann Sie warten sollten.

Erstveröffentlicht: 17. Juli 2026 · Zuletzt aktualisiert: 3. Aug. 2026 · Fortgeschritten
Sprachen
1 Evidenzsignal auf dieser Seite

WebMCP ist eine experimentelle Browser-API, die es einer offenen Webseite ermöglicht, einem KI-Agenten strukturierte Tools anzubieten. Es ist nützlich für begrenzte Seitenaktionen, nicht für Web-Discovery oder Rankings. Stand 17. Juli 2026 ist es ein Community-Group-Entwurf und ein Chrome-149-Origin-Trial; aktuelle Chrome-Beispiele verwenden document.modelContext, während navigator.modelContext in Chrome 150 veraltet ist.

TL;DR — WebMCP stellt Seiten-eigene Tools aus document.modelContext einem Agenten im aktiven Browsing-Kontext bereit. Die imperative API registriert einen Namen, eine Beschreibung, JSON-Schema-Eingaben, Annotationen und einen asynchronen Callback; Tools können zustandsabhängig sein und mit einem AbortSignal deregistriert werden. Chrome dokumentiert auch eine deklarative Formularebene, aber der Community-Group-Entwurf vom 10. Juli 2026 kennzeichnet seinen deklarativen Abschnitt weiterhin als TODO. Die Funktion befindet sich in einem Chrome-149-Origin-Trial, nicht in einer stabilen, browserübergreifenden Basislinie. Behandeln Sie sie als progressive Verbesserung, nicht als SEO-Infrastruktur, und sichern Sie sie als authentifizierte Anwendungsoberfläche.

Evidence for this claim Chrome documents declarative form annotations such as toolname and tooldescription, but the declarative section of the July 10, 2026 Community Group draft is still marked TODO. Scope: secure browser context Confidence: high · Verified: WebMCP Draft Community Group Report

Wie WebMCP im Browser funktioniert

Ein sinnvoller WebMCP-Lebenszyklus beginnt und endet mit der Seite. Die Seite registriert nur die Aktionen, die in ihrem aktuellen Zustand gültig sind; ein Agent, der bereits in diesem Browsing-Kontext arbeitet, entdeckt und ruft eine davon auf; die Seite führt ihre normale Anwendungslogik aus, aktualisiert die für Menschen sichtbare Oberfläche und gibt ein begrenztes Ergebnis zurück. Wenn sich der Zustand ändert, entfernt die Seite Tools, die nicht mehr zutreffen. Evidence for this claim The imperative API registers named, described, schema-constrained callbacks and supports state-aware cleanup with AbortSignal plus tool-set change notifications. Scope: Current draft and Chrome experiment; API details may change before stable release. Confidence: high · Verified: WebMCP ModelContext API Chrome: WebMCP Imperative API

WebMCP tools should follow the page's real state: register a valid action, execute the same logic as the UI, and remove it when the action is no longer available. Quelle: Patrick Stox — WebMCP

Five numbered steps run left to right. First, the page registers a name, description, input schema, and callback. Second, an agent already in the page context discovers it. Third, the agent invokes it with validated structured arguments. Fourth, the page reuses its normal application logic and updates the visible interface. Fifth, it returns a bounded result or safe error. A branch from execution shows that state changes or navigation should unregister the tool with AbortSignal and notify observers through toolchange.

© Patrick Stox LLC · CC BY 4.0 ·

Dieser zustandsbehaftete Lebenszyklus ist ein Grund, warum WebMCP kein statischer Abfall aller Funktionen in einem JavaScript-Bundle werden sollte. Ein Tool, das in der sichtbaren UI unmöglich ist, sollte normalerweise auch für den Agenten nicht verfügbar sein.

WebMCP vs. MCP: zwei unterschiedliche Laufzeitgrenzen

Die Namen laden zur Verwechslung ein, aber die operative Grenze ist unterschiedlich. WebMCP lebt in der Ereignisschleife eines Dokuments und in der aktuellen Browser-Sitzung. Remote-MCP lebt an der Integrationsgrenze der KI-Anwendung und erreicht üblicherweise einen persistenten Backend-Server. Evidence for this claim WebMCP is designed for tools owned by an active page and its browser context, while remote MCP commonly connects an AI application to a persistent backend server. Scope: Architecture-selection guidance, not a rule that prevents an application from using both technologies. Confidence: high · Verified: Chrome: When to use WebMCP and MCP

WebMCP owns page-context actions; remote MCP owns durable application-to-server integrations. Many products will use both. Quelle: WebMCP

The left lane shows WebMCP: a browser agent interacts with an open web page, which owns a JavaScript tool and current visible session state. The page must be open for those tools to exist. The right lane shows remote MCP: an AI application connects through an MCP client to a persistent MCP server, which can remain available outside a browser tab. The two lanes are complementary rather than replacements.

© Patrick Stox LLC · CC BY 4.0 ·

SchnittstelleWo sie lebtWann sie entdeckt wirdMuss die Seite geöffnet sein?Am besten geeignet für
WebMCPAktives Browser-DokumentNachdem der Client die Seite besuchtJaAktueller UI-Zustand und Seitenaktionen
Remote-MCPKI-Client und ein MCP-ServerÜber Client/Server-Konfiguration oder DiscoveryNeinPersistente Tools, Daten und Backend-Workflows
Web/API-EndpunktAnwendungs-BackendÜber anwendungsspezifische IntegrationNeinStabiler programmatischer Zugriff für bekannte Verbraucher
Strukturierte DatenSeiten-MarkupWährend der SeitenverarbeitungWird normalerweise als Inhalt abgerufenBeschreibung von Entitäten und Seitenbedeutung, nicht Ausführung von Aktionen
llms.txtStatische TextdateiWenn ein Client sie anfordertKein aktiver Tab erforderlichVorgeschlagene Inhaltsrichtlinie; keine aufrufbare Tool-Oberfläche
Browser-AutomatisierungAgent/Controller, der die UI interpretiertNach dem Laden und Inspizieren der SeiteJaFallback, wenn kein explizites Seiten-Tool existiert

Wählen Sie nicht anhand des Akronyms, sondern anhand des Eigentümers der Aktion. Wenn die Aktion den aktuellen DOM, die Auswahl, den Warenkorb oder den UI-Zustand benötigt, könnte WebMCP passen. Wenn sie im Hintergrund, über viele Websites hinweg oder ohne geöffneten Tab ausgeführt werden muss, verwenden Sie eine API oder ein entferntes MCP.

Die imperative API

Die imperative API registriert ein Tool über document.modelContext.registerTool(). Das Tool enthält einen eindeutigen Namen, eine Beschreibung, ein JSON-Schema-Input, einen execute-Callback und optionale Annotationen. Chrome dokumentiert außerdem getTools(), executeTool() zum Testen und ein toolchange-Ereignis. Evidence for this claim Current Chrome documentation uses document.modelContext and says navigator.modelContext is deprecated beginning in Chrome 150. Scope: Chrome implementation guidance checked July 17, 2026; version and API-name claims expire quickly. Confidence: high · Verified: Chrome: WebMCP Imperative API

Dieser illustrative Kandidat zeigt die beabsichtigte Form für einen zukünftigen Schema-Validator-Pilot. Er läuft nicht auf dieser Website, und die API kann sich vor einer stabilen Version ändern:

if (document.modelContext) {
  const registration = new AbortController();

  await document.modelContext.registerTool({
    name: 'validate_schema',
    description: 'Validate pasted JSON-LD and return bounded issues.',
    inputSchema: {
      type: 'object',
      properties: {
        markup: {
          type: 'string',
          description: 'JSON-LD markup to validate.',
          maxLength: 50000
        }
      },
      required: ['markup'],
      additionalProperties: false
    },
    annotations: {
      readOnlyHint: true,
      untrustedContentHint: true
    },
    execute: async ({ markup }) => {
      const result = await validateWithTheSameEngineAsTheUI(markup);
      renderResultInTheVisibleUI(result);
      return minimizeValidationResult(result);
    }
  }, { signal: registration.signal });

  // When this page state no longer supports validation:
  // registration.abort();
}

Die wichtige Architektur ist nicht der Wrapper. Es ist, dass der Callback denselben Validator wie die sichtbare UI aufruft, serverseitige Limits und Autorisierung weiterhin gelten und die Antwort bewusst minimiert wird. Die Feature-Erkennung bewahrt den vollständigen menschlichen Workflow in nicht unterstützten Browsern.

Verwenden Sie document.modelContext, nicht veraltete Beispiele, die um navigator.modelContext herum aufgebaut sind; Chrome markiert letzteres ab Chrome 150 als veraltet. Datieren Sie diesen Hinweis, da die Funktion experimentell bleibt.

Evidence for this claim Current Chrome documentation uses document.modelContext; navigator.modelContext is deprecated in Chrome 150. Scope: browser document Confidence: high · Verified: WebMCP Imperative API

Die deklarative API hat eine Normen-Diskrepanz

Chrome dokumentiert einen deklarativen Ansatz, der gewöhnliche Formulare mit Attributen wie toolname, tooldescription und toolparamdescription annotiert. Es dokumentiert auch optionales toolautosubmit; andernfalls klickt der Benutzer auf Senden. SubmitEvent.agentInvoked identifiziert eine agentenausgelöste Übermittlung. Evidence for this claim Chrome documents declarative WebMCP form annotations, but the July 10, 2026 Community Group draft says its Declarative WebMCP section is entirely TODO. Scope: A direct comparison between Chrome implementation documentation and the current draft; it does not imply Chrome's experimental implementation is unavailable. Confidence: high · Verified: Chrome: WebMCP Declarative API WebMCP: Declarative WebMCP

Der Community-Group-Bericht vom 10. Juli sagt jedoch, dass sein Abschnitt zu Declarative WebMCP “entirely a TODO” ist und den Formular-zu-JSON-Schema-Algorithmus undefiniert lässt. Das bedeutet nicht, dass das Experiment von Chrome imaginär ist. Es bedeutet, dass die Implementierungsdokumentation dem normativen Entwurf voraus ist. Behandeln Sie deklaratives Markup als experimentelle Chrome-Oberfläche, nicht als etabliertes Cross-Browser-HTML.

Evidence for this claim Chrome documents declarative WebMCP form annotations, but the July 10, 2026 Community Group draft says its Declarative WebMCP section is entirely TODO. Scope: A direct comparison between Chrome implementation documentation and the current draft; it does not imply Chrome's experimental implementation is unavailable. Confidence: high · Verified: Chrome: WebMCP Declarative API WebMCP: Declarative WebMCP

Für jetzt bleiben gewöhnliche semantische Formulare die dauerhafte Basis. Eine experimentelle Annotationsschicht sollte sie verbessern, niemals Labels, Validierung, Barrierefreiheit, Bestätigung oder serverseitige Autorisierung ersetzen.

Tool-Erkennung, Lebenszyklus und Cross-Origin-Grenzen

Die aktuelle API hat mehrere Grenzen, die es wert sind, explizit entworfen zu werden:

  • Browsing-Kontext: Das Experiment von Chrome erfordert einen Browser-Kontext. Der Client besucht die Website, bevor er die Tools der Website entdeckt.
  • Dynamische Verfügbarkeit: Registrieren Sie Tools, wenn sie gültig sind, und brechen Sie ihre Registrierung ab, wenn Zustand oder Navigation sie ungültig machen. Beobachter können auf toolchange hören.
  • Gleichherkunft standardmäßig: Die tools-Permissions-Policy standardmäßig auf 'self'. Cross-Origin-Iframes benötigen explizite Delegation wie allow="tools".
  • Zweiseitige Cross-Origin-Zustimmung: Ein Tool kann exposedTo verwenden, um erlaubte sichere Ursprünge aufzulisten, während ein Aufrufer Tools von benannten Ursprüngen mit fromOrigins anfordert. Eine Seite, die zustimmt, reicht nicht aus.
  • Progressive Verbesserung: Nicht unterstütztes oder deaktiviertes WebMCP muss die gewöhnliche Seite vollständig nutzbar lassen.
Evidence for this claim WebMCP tool exposure is origin-isolated and controlled by the tools Permissions Policy; cross-origin iframes require explicit delegation. Scope: browser document Confidence: high · Verified: WebMCP Imperative API

Dies sind nützliche Plattformkontrollen, aber sie machen eine riskante Anwendungsaktion nicht zu einer sicheren.

Sicherheit: Die Browser-Sitzung erhöht die Einsätze

Ein Browser-Agent kann innerhalb der authentifizierten Sitzung des Benutzers arbeiten. Das kann das Feature sein – Zugriff auf den aktuellen Warenkorb, das Konto oder den Arbeitsbereich – und die Gefahr. Chrome und der Entwurf diskutieren Prompt-Injection, irreführende Tool-Metadaten, kontaminierte Tool-Ausgaben, übermäßig breite Parameter, Datenschutzlecks, Cross-Origin-Exposition und Missbrauch der angemeldeten Autorität. Evidence for this claim WebMCP tool hints can communicate read-only and untrusted-output intent, but they do not eliminate prompt injection, misleading metadata, privacy leakage, cross-origin risk, or misuse of authenticated browser authority. Scope: Threat-model and defensive guidance; application authorization and confirmation remain implementation responsibilities. Confidence: high · Verified: WebMCP security and privacy considerations Chrome: WebMCP tool security Chrome: Agent security considerations

Behandeln Sie jedes Tool als öffentlichen Anwendungsendpunkt mit einem ungewöhnlichen Aufrufer:

  1. Halten Sie das Tool eng umrissen. Eine Aufgabe, explizite Eingaben, enge Aufzählungen und Längen, kein versteckter “Alleskönner”-Parameter.
  2. Erzwingen Sie die Autorisierung in der Anwendungslogik. Der Agent erhält nicht mehr Befugnisse als der angemeldete Benutzer, und ein Hinweis ist keine Berechtigung.
  3. Trennen Sie Lese- von Schreibvorgängen. readOnlyHint und untrustedContentHint kommunizieren Risiken; sie erzwingen sie nicht.
  4. Verlangen Sie eine sichtbare Bestätigung für Konsequenzen. Käufe, Übermittlungen, Löschungen, Nachrichten und Kontenänderungen benötigen einen für Menschen verständlichen Kontrollpunkt.
  5. Minimieren Sie die Ausgabe. Geben Sie nur das zurück, was die Aufgabe benötigt; geben Sie niemals Sitzungsdaten, rohe Header, Geheimnisse oder nicht zusammenhängende Datensätze preis.
  6. Behandeln Sie die Ausgabe als nicht vertrauenswürdig. Eine Zeichenfolge, die von einem Tool zurückgegeben wird, kann zur Eingabe für spätere Modellüberlegungen werden. Lassen Sie nicht zu, dass sie Anweisungen oder Befugnisse einschmuggelt.
  7. Protokollieren Sie die Grenze. Erfassen Sie das Tool, die Eingabeklasse, die Autorisierungsentscheidung, die Bestätigung, die Ergebnisklasse, den Fehler, die Herkunft und den Lebenszyklus, ohne Geheimnisse zu protokollieren.

Die sichere Frage ist nicht “Kann ein Agent dies aufrufen?” Es ist “Würde ich dies als überprüften Endpunkt einem Aufrufer aussetzen, der Anweisungen missverstehen und nicht vertrauenswürdigen Text weiterleiten kann?”

Testen Sie Verträge und Agentenverhalten getrennt

Chromes eval-Richtlinien trennen deterministische Produkttests von probabilistischen Agententests. Evidence for this claim WebMCP testing should combine deterministic contract and UI-state tests with probabilistic evaluation of agent tool selection and use. Scope: Chrome's evaluation guidance; teams must define product-specific tasks, models, risks, and thresholds. Confidence: high · Verified: Chrome: Evals for WebMCP Beides ist wichtig:

Deterministische Tests sollten Registrierung, Schema-Ablehnung, gültige und ungültige Eingaben, Autorisierung, Ratenbegrenzungen, Nebenwirkungen, Fehlerform, Ausgabeminimierung, UI-Parität, Abmeldeverhalten und Fallback für nicht unterstützte Browser verifizieren.

Probabilistische Evals sollten messen, ob repräsentative Agenten das richtige Tool entdecken, irrelevante Tools vermeiden, die korrekten Parameter wählen, bei Bedarf um Klärung bitten, Bestätigungen respektieren, nach Erfolg aufhören und sich gegen feindselige Beschreibungen oder Ausgaben wehren.

Verwenden Sie nicht einen einzigen Demo-Prompt als Freigabegate. Ein erfolgreicher Callback beweist, dass der Code ausgeführt wurde; er beweist nicht, dass Modelle ihn zuverlässig auswählen oder dass die Aktion sicher ist.

Cloudflare Browser Run: nützliches Labor, keine Aktivierung

Cloudflare dokumentiert WebMCP-Unterstützung im experimentellen Laborpool von Browser Run und sagt, dass Laborsitzungen nicht für Produktionsworkloads verwendet werden sollten. Die Seite vom 23. April enthält auch ältere Testnamen aus der Chrome-Ära, verwenden Sie diese Seite also als Beleg für das aktuelle Produktangebot von Cloudflare – nicht als Autorität für die neueste WebMCP-API-Form. Evidence for this claim Cloudflare Browser Run offers experimental lab sessions that can consume and test page-provided WebMCP tools, but the page still owns tool registration and Cloudflare says lab sessions are not for production workloads. Scope: Cloudflare product documentation last updated April 23, 2026; its example API names lag current Chrome documentation and should not be used as the API authority. Confidence: high · Verified: Cloudflare Browser Run: WebMCP

Cloudflare kann eine Browsersitzung und einen Agentenpfad bereitstellen, der Tools konsumiert. Es kann den sicheren Vertrag für Ihre Anwendung nicht ableiten oder seitenbezogene Tools registrieren, die Sie nicht erstellt haben.

Vorgeschlagener patrickstox.com-Pilot: Schema-Validator

Der Schema-Markup-Validator ist ein guter zukünftiger Pilotkandidat, keine Live-WebMCP-Implementierung. Er hat bereits eine begrenzte eingefügte Eingabe, deterministische Logik, strukturierte Probleme und ein sichtbares Ergebnis. Ein zukünftiges validate_schema-Tool könnte dieselbe Validierungs-Engine wie die UI und die vorhandene Remote-MCP-Tool-Suite wiederverwenden.

Der Pilot sollte warten, bis die Browser-API eine stabile, nicht experimentelle Version erreicht und eine frische Sicherheitsüberprüfung besteht. Die erste Version sollte schreibgeschützt, funktionserkannt, eingabebegrenzt, antwortminimiert und auf Vorschau-, Admin- oder nur-Eigentümer-Oberflächen nicht verfügbar sein. Diese Website beansprucht derzeit keine WebMCP-Unterstützung.

Entscheidung: bauen, experimentieren, warten oder überspringen

SituationEntscheidung
Stabile Browserunterstützung ist für einen Kundenworkflow erforderlichWarten und die normale UI/API vollständig beibehalten
Sie haben eine begrenzte, schreibgeschützte Aktion und können ein privates Labor betreibenExperimentieren, mit Feature-Erkennung und ohne Produktionsabhängigkeit
Die Aufgabe erfordert Hintergrund- oder Headless-AusführungEine API oder ein Remote-MCP verwenden
Die Seite veröffentlicht nur InhalteWebMCP überspringen; semantisches, zugängliches HTML verbessern
Die Aktion schreibt, kauft, übermittelt, löscht oder legt private Daten offenNicht beiläufig pilotieren; ein separates Bedrohungsmodell und Bestätigungsdesign erfordern
Eine stabile Implementierung wird ausgeliefert und alle Vertrags-, Sicherheits- und Paritätstests bestehenEinen schrittweisen Produktionspilot in Betracht ziehen

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.