agent-tracking

Guides

Wie erfasse ich MCP- und WebMCP-Tool-Aufrufe auf meiner Site?

Wenn deine Seiten Tools über navigator.modelContext oder document.modelContext registrieren oder deklarative Formulare mit toolname bereitstellen, erfasst das Snippet jede Registrierung und jeden Aufruf: Name, Dauer, Erfolg oder Fehlschlag, Fehlerklasse und die Namen der Eingabefelder, nie deren Werte.

Von · Stand 2026-09-08

Read this guide in English

Nichts an deinem Code ändern

Das Snippet umhüllt registerTool und provideContext, bevor dein Code läuft. Registriere Tools wie in der Spezifikation, und sie erscheinen in der Tools-Ansicht. Deklarative Tools, Formulare mit toolname-Attribut, werden beim Absenden erfasst.

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 */ },
});

Was die Tools-Ansicht beantwortet

Je Tool: Aufrufe, Erfolgsquote, mittlere Dauer, die drei häufigsten Fehlermeldungen, ob es deklarativ ist, wann es zuletzt gesehen wurde und ob es je aufgerufen wurde. Das Letzte zählt am meisten: Ein Tool, das niemand aufruft, hat eine Beschreibung, die Agenten nicht verstehen, oder ein Schema, das sie nicht füllen können.

Feldnamen, nie Werte

Die Namen der Argument-Felder werden erfasst, damit du siehst, dass Agenten sku schicken, aber nie qty. Die Werte nicht, sodass nichts, was jemand eingetippt hat, den Server erreicht.

Das Manifest

Wenn du /.well-known/webmcp veröffentlichst, hasht das Snippet es einmal pro Besuch. Das Dashboard zeigt die letzte Änderung; in Pro und Agency geht eine Mail raus, wenn es sich ändert, was ein Deployment entlarvt, das still ein Tool entfernt hat.

Kurz gefragt

Sieht es MCP-Server, die Agenten außerhalb des Browsers aufrufen?

Nein. Es sieht Tools, die in der Seite über die Model-Context-API des Browsers aufgerufen werden. Ein entfernter MCP-Server hat eigene Logs; hier wird die Browserseite gemessen.

Kann ich es ohne Agenten testen?

Ja. Die Demo-Seite hat zwei Tools und einen Simulieren-Knopf; simulierte Aufrufe sind markiert und zählen nie als Agenten.