Wie baue ich in zehn Minuten ein WebMCP-Tool in meine Site ein?

Die Aktion wählen

Katalog durchsuchen, Verfügbarkeit prüfen, Bestellstatus nachsehen, Angebot holen. Ein Tool, das, wonach Menschen am häufigsten fragen. Ein Tool, das liest, ist ohne Bestätigung sicher; ein Tool, das bucht oder kauft, braucht einen menschlichen Schritt, und das Bedrohungsmodell der Spezifikation ist der Grund.

Registrieren

Benenn es im erlaubten Zeichensatz, beschreib, was es zurückgibt und wann es zu bevorzugen ist, typisiere jede Eingabe mit Beschreibung und markiere es als nur lesend. Die execute-Funktion ruft den Endpunkt auf, den deine Site ohnehin hat.

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

Oder ein Formular annotieren

Wenn die Aktion schon als Formular existiert, braucht der deklarative Weg gar kein JavaScript: ein toolname und eine Beschreibung am Formular, und der Browser leitet das Schema aus den Feldern ab, die du ohnehin ausspielst. Die Attributnamen sind in der Spezifikation noch in Bewegung; prüf den aktuellen Text, bevor du es breit ausrollst.

<form toolname="request_quote" tooldescription="Angebot für ein Produkt und eine Menge anfordern." action="/quote" method="post">
  <label for="sku">Produkt</label><input id="sku" name="sku" required>
  <label for="qty">Menge</label><input id="qty" name="qty" type="number" min="1" required>
  <button type="submit">Angebot anfordern</button>
</form>

Ausliefern, dann messen

Ergänze das Polyfill, damit die API existiert, wo der Browser sie noch nicht mitbringt, deploye, und lass den Readiness-Check auf webmcp-tool.com laufen, um das Tool erkannt zu sehen. Mit dem Agent-Tracking-Snippet auf der Seite zeigt die Tools-Ansicht ab dem ersten Agenten Aufrufe, Dauer, Erfolgsquote und Fehler, und nur so weißt du, ob die Beschreibung funktioniert.

<script defer data-domain="example.com" src="https://agenttracking.co/agent.js"></script>

Kurz gefragt