WebMCP in WordPress und WooCommerce einbauen: ein Praxisleitfaden

WordPress und WooCommerce passen sehr gut zu WebMCP: Die Daten, die Agenten brauchen (Produkte, Preise, Lagerbestand, Seiten, FAQs), liegen bereits hinter sauberen APIs. Dieser Leitfaden zeigt die praktischen Schritte, die wir nutzen – von der Auswahl der Tools bis zum Testen – mit Code, den Sie anpassen können. Falls WebMCP neu für Sie ist, lesen Sie zuerst, was WebMCP ist.

Schritt 1: Die ersten Tools auswählen

Machen Sie nicht alles zugänglich. Wählen Sie die zwei oder drei Aktionen, nach denen Kunden am häufigsten fragen, und starten Sie mit reinem Lesezugriff:

• Shops: search_products, get_product (Varianten, Lagerbestand), get_store_policy (Versand, Rückgabe).
• Dienstleister: find_service, get_faq, prepare_quote_request.
• Buchungen: list_services, find_open_slots; das Bestätigen einer Buchung kommt später und braucht immer den Besucher.

Schritt 2: Plugin oder eigene Tools?

Ein Plugin wie WebMCP Bridge registriert in wenigen Minuten Standard-Tools mit Lesezugriff für Beiträge und Produkte. Für eine einfache Website ist das ein guter Test. Ihre eigenen Regeln kennt es aber nicht: Liefergebiete, Staffelpreise, Buchungslimits oder welche Plugins welche Daten enthalten. Dafür schreiben Sie ein kleines eigenes Plugin mit Ihren eigenen Tools. Der Rest dieses Leitfadens zeigt diesen Weg.

Schritt 3: Bestehende Formulare zu Tools machen

Der schnellste Erfolg ist die deklarative API. Ergänzen Sie toolname und tooldescription in einem bestehenden Formular, etwa Ihrem Kontakt- oder Angebotsformular. Felder mit Label werden zu Eingaben des Tools, und toolparamdescription kann ein Feld genauer erklären:

<form toolname="request_quote" tooldescription="Prepare a quote request. The visitor reviews and sends it." action="/quote">
  <label for="qname">Name</label> <input id="qname" name="name">
  <label for="qemail">Email</label> <input id="qemail" name="email" type="email">
  <select name="service" toolparamdescription="Which service the quote is for.">
    <option>Website redesign</option>
    <option>WooCommerce store</option>
  </select>
  <button type="submit">Send</button>
</form>

Ohne das Attribut toolautosubmit füllt der Browser das Formular nur aus; der Besucher klickt weiterhin selbst auf „Senden“. Behalten Sie das für alles bei, was Ihr Team kontaktiert.

Schritt 4: Ein Produktsuche-Tool mit der Store API

Die Store API von WooCommerce (/wp-json/wc/store/v1/products) ist öffentlich, liefert dieselben Daten, die Kunden sehen, und berücksichtigt bereits die Sichtbarkeit von Produkten. Ein kleines Skript, das Ihr Plugin lädt, kann darauf ein Such-Tool registrieren:

const mc = document.modelContext || navigator.modelContext;
if (mc && mc.registerTool) {
  mc.registerTool({
    name: 'search_products',
    description: 'Search the store catalog. Returns up to 5 products with price, stock and link.',
    inputSchema: {
      type: 'object',
      properties: {
        query: { type: 'string', description: 'Keywords, e.g. running shoe' },
        max_price: { type: 'number', description: 'Highest price in the store currency' },
      },
      required: ['query'],
    },
    annotations: { readOnlyHint: true },
    execute: async ({ query, max_price }) => {
      const url = new URL('/wp-json/wc/store/v1/products', location.origin);
      url.searchParams.set('search', String(query).slice(0, 80));
      url.searchParams.set('per_page', '5');
      if (max_price) url.searchParams.set('max_price', String(Math.round(max_price * 100)));
      const items = await (await fetch(url)).json();
      return JSON.stringify(items.map((p) => ({
        name: p.name, price: p.prices.price / 10 ** p.prices.currency_minor_unit,
        in_stock: p.is_in_stock, url: p.permalink,
      })));
    },
  });
}

Binden Sie es in Ihrem Plugin mit wp_enqueue_script() auf den passenden Seiten ein, meist im gesamten Shop. Durch die Feature-Prüfung in der ersten Zeile überspringen Browser ohne WebMCP das Skript.

Schritt 5: Eigene Daten über die REST API

Für Daten, die die Store API nicht abdeckt, etwa Liefergebiete oder Terminslots aus einem Buchungs-Plugin, ergänzen Sie eine kleine REST-Route mit Lesezugriff. Setzen Sie immer einen permission_callback, prüfen Sie jedes Argument und geben Sie nur zurück, was ein Kunde sehen darf:

add_action('rest_api_init', function () {
  register_rest_route('mysite/v1', '/delivery', [
    'methods' => 'GET',
    'permission_callback' => '__return_true', // public, read-only data
    'args' => ['postcode' => ['required' => true, 'sanitize_callback' => 'sanitize_text_field']],
    'callback' => function ($req) {
      return ['postcode' => $req['postcode'], 'days' => mysite_delivery_days($req['postcode'])];
    },
  ]);
});

Schritt 6: Sensible Aktionen brauchen den Kunden

In den Warenkorb legen, Buchen und Formulare senden verändern etwas. Kennzeichnen Sie diese Tools deshalb mit consequentialHint: true und lassen Sie den Kunden bestätigen. Nutzen Sie die eigene Sitzung des Kunden und WordPress-Nonces, niemals einen Admin-Schlüssel. Überlassen Sie Checkout und Zahlung dem Kunden. Bauen Sie keine Tools, die Bestellungen, Kunden oder Benutzer auflisten.

Schritt 7: Testen, dann live gehen

1. Entwickeln Sie zuerst auf einer Staging-Kopie Ihrer Website.
2. Testen Sie in einem aktuellen Chrome mit aktiviertem WebMCP und rufen Sie jedes Tool mit gültigen und ungültigen Eingaben auf.
3. Prüfen Sie, dass normale Besucher keine Änderung bemerken und die Ladezeit gleich bleibt.
4. Prüfen Sie die Live-Seite mit dem kostenlosen WebMCP-Checker, um sicherzustellen, dass die Tools von außen sichtbar sind.
5. Protokollieren Sie Tool-Aufrufe ohne personenbezogene Daten und werten Sie sie nach dem Start aus.

Sollen wir das für Sie übernehmen?

Wir konzipieren, entwickeln und testen WebMCP-Tools für WordPress und WooCommerce – beginnend mit einem kostenlosen Readiness-Check und einem Festpreisangebot. Sehen Sie sich unseren Service WordPress WebMCP Integration an, oder lesen Sie WebMCP vs. MCP, um zu entscheiden, ob Sie zusätzlich einen MCP-Server brauchen.