Comment ajouter WebMCP à WordPress et WooCommerce : guide pratique

WordPress et WooCommerce se prêtent naturellement à WebMCP : les données dont les agents ont besoin (produits, prix, stock, pages, FAQ) sont déjà accessibles via des API propres. Ce guide présente les étapes concrètes que nous suivons, du choix des outils jusqu’aux tests, avec du code que vous pouvez adapter. Si vous découvrez WebMCP, commencez par ce qu’est WebMCP.

Étape 1 : choisir les premiers outils

N’exposez pas tout. Choisissez les deux ou trois actions sur lesquelles vos clients vous interrogent le plus, et commencez en lecture seule :

• Boutiques : search_products, get_product (variantes, stock), get_store_policy (livraison, retours).
• Entreprises de services : find_service, get_faq, prepare_quote_request.
• Réservations : list_services, find_open_slots ; la confirmation d’une réservation vient plus tard et nécessite toujours le visiteur.

Étape 2 : extension ou outils sur mesure ?

Une extension comme WebMCP Bridge enregistre en quelques minutes des outils standard en lecture seule pour les articles et les produits. C’est un bon test pour un site simple. Mais elle ne connaît pas vos propres règles : zones de livraison, prix de gros, limites de réservation, quelles extensions contiennent quelles données. Pour cela, écrivez une petite extension sur mesure avec vos propres outils. La suite de ce guide présente cette approche.

Étape 3 : transformer les formulaires existants en outils

Le gain le plus rapide vient de l’API déclarative. Ajoutez toolname et tooldescription à un formulaire existant, comme votre formulaire de contact ou de devis. Les champs avec libellé deviennent les paramètres de l’outil, et toolparamdescription permet de préciser un champ :

<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>

Sans l’attribut toolautosubmit, le navigateur se contente de remplir le formulaire ; c’est toujours le visiteur qui clique sur Envoyer. Gardez ce fonctionnement pour tout ce qui contacte votre équipe.

Étape 4 : un outil de recherche de produits avec la Store API

La Store API de WooCommerce (/wp-json/wc/store/v1/products) est publique, renvoie les mêmes données que celles vues par les acheteurs et respecte déjà la visibilité des produits. Un petit script, chargé par votre extension, peut enregistrer un outil de recherche qui s’appuie dessus :

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

Chargez-le depuis votre extension avec wp_enqueue_script() sur les pages concernées, en général toute la boutique. Grâce à la vérification de la première ligne, les navigateurs sans WebMCP l’ignorent.

Étape 5 : vos propres données via la REST API

Pour les données que la Store API ne couvre pas, comme les zones de livraison ou les créneaux d’une extension de réservation, ajoutez une petite route REST en lecture seule. Définissez toujours un permission_callback, validez chaque argument et ne renvoyez que ce qu’un client a le droit de voir :

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'])];
    },
  ]);
});

Étape 6 : les actions sensibles exigent l’acheteur

L’ajout au panier, la réservation et l’envoi de formulaires modifient quelque chose : signalez ces outils avec consequentialHint: true et laissez l’acheteur confirmer. Utilisez la session de l’acheteur et les nonces WordPress, jamais une clé administrateur. Laissez la commande et le paiement à l’acheteur. Ne créez pas d’outils qui listent les commandes, les clients ou les utilisateurs.

Étape 7 : tester, puis lancer

1. Développez d’abord sur une copie de préproduction de votre site.
2. Testez dans une version récente de Chrome avec WebMCP activé, et appelez chaque outil avec des paramètres valides et invalides.
3. Vérifiez que les visiteurs habituels ne voient aucune différence et que la vitesse des pages ne change pas.
4. Lancez le vérificateur WebMCP gratuit sur la page en ligne pour confirmer que les outils sont visibles de l’extérieur.
5. Journalisez les appels d’outils sans données personnelles, et analysez-les après le lancement.

Vous préférez nous le confier ?

Nous concevons, développons et testons des outils WebMCP pour WordPress et WooCommerce, en commençant par un audit de préparation gratuit et un devis forfaitaire. Découvrez notre service d’intégration WebMCP pour WordPress, ou lisez WebMCP ou MCP pour savoir si vous avez aussi besoin d’un serveur MCP.