agent-tracking

Guides

Wie bekomme ich Analytics für WebMCP-Tools auf meiner Site?

Unterstützte WebMCP-Aufrufe können im Browser instrumentiert werden; Remote-MCP-Aufrufe brauchen eine Serverintegration. Das Snippet beobachtet unterstützte Model-Context-APIs und deklarative Formulare und erfasst sichere Metadaten sowie technische Ergebnisse ohne rohe Argumentwerte. Die Abdeckung hängt von Browser-API und Einbaureihenfolge ab.

Von · Stand 2026-09-08

Read this guide in English

Warum Instrumentierung nötig ist

Ein lokaler Browser-WebMCP-Aufruf erzeugt möglicherweise keine separate Serveranfrage. Eigene Analytics können dafür ein Custom Event senden; Agent Tracking beobachtet unterstützte APIs bei rechtzeitig geladenem Snippet. Rohe Argumentwerte werden nicht erfasst.

Vor der Tool-Registrierung installieren

Lade das Snippet vor der Registrierung unterstützter Tools. Deklarative Formulare brauchen unterstütztes Markup und Browser-Verhalten. Prüfe die Tools-Ansicht nach einem echten Aufruf, statt vollständige Abdeckung anzunehmen.

await navigator.modelContext.registerTool({
  name: "add_to_cart",
  description: "Add a product to the cart by SKU.",
  inputSchema: { type: "object", properties: { sku: { type: "string" }, qty: { type: "integer" } }, required: ["sku"] },
  execute: async ({ sku, qty }) => { /* your code */ },
});

Die Fragen, die die Tools-Ansicht beantwortet

Wie viele beobachtete Aufrufe je Tool und Tag stattfanden, ihre technischen Ergebnisse und ihre Dauer. Registrierte Tools ohne beobachteten Aufruf können ungenutzt sein oder außerhalb der Instrumentierung liegen. Fehler sind sichere Klassen statt roher Meldungen.

Von Aufrufen zu Ergebnissen

data-agent-goal erfasst einen Browser-Versuch. Ein Site-Server-Endpunkt erfasst einen bestätigten Geschäftsabschluss. Lies beide getrennt, solange dein eigener Workflow nicht den konkreten Aufruf und Beleg verbindet.

<button type="submit" data-agent-goal="order_placed">Place order</button>

Kurz gefragt

Deckt das auch entfernte MCP-Server ab?

Ja, über den getrennten authentifizierten Server-Tool-Endpunkt. Das Browser-Snippet sieht entfernte Aufrufe nicht; der MCP-Leseendpunkt zeigt gemeldete Kennzahlen.

Werden Argumentwerte erfasst?

Rohe Argumentwerte werden nicht gespeichert. Unterstützte Browserereignisse enthalten sichere Metadaten wie Toolname und technisches Ergebnis; das Eventschema nennt die genauen Felder.