Cómo añadir WebMCP a WordPress y WooCommerce: guía práctica

WordPress y WooCommerce encajan de forma natural con WebMCP: los datos que necesitan los agentes (productos, precios, existencias, páginas, preguntas frecuentes) ya están detrás de API limpias. Esta guía muestra los pasos prácticos que seguimos, desde elegir las herramientas hasta probarlas, con código que puede adaptar. Si WebMCP es nuevo para usted, empiece por qué es WebMCP.

Paso 1: Elija las primeras herramientas

No lo exponga todo. Elija las dos o tres acciones sobre las que más preguntan los clientes y empiece con solo lectura:

• Tiendas: search_products, get_product (variaciones, existencias), get_store_policy (envíos, devoluciones).
• Empresas de servicios: find_service, get_faq, prepare_quote_request.
• Reservas: list_services, find_open_slots; confirmar una reserva viene después y siempre necesita al visitante.

Paso 2: ¿Plugin o herramientas a medida?

Un plugin como WebMCP Bridge registra en minutos herramientas estándar de solo lectura para entradas y productos. Es una buena prueba para un sitio sencillo. Pero no puede conocer sus propias reglas: zonas de entrega, precios por volumen, límites de reservas, qué plugins guardan qué datos. Para eso, escriba un pequeño plugin a medida con sus propias herramientas. El resto de esta guía muestra el camino a medida.

Paso 3: Convierta los formularios existentes en herramientas

La victoria más rápida es la API declarativa. Añada toolname y tooldescription a un formulario que ya tenga, como su formulario de contacto o de presupuesto. Los campos con etiqueta se convierten en las entradas de la herramienta, y toolparamdescription puede explicar mejor un campo:

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

Sin el atributo toolautosubmit, el navegador solo rellena el formulario; el visitante sigue pulsando Enviar. Manténgalo así para todo lo que contacte con su equipo.

Paso 4: Una herramienta de búsqueda de productos con la Store API

La Store API de WooCommerce (/wp-json/wc/store/v1/products) es pública, devuelve los mismos datos que ven los compradores y ya respeta la visibilidad de los productos. Un pequeño script, cargado por su plugin, puede registrar una herramienta de búsqueda sobre ella:

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

Cárguelo desde su plugin con wp_enqueue_script() en las páginas donde tenga sentido, normalmente toda la tienda. La comprobación de la primera línea hace que los navegadores sin WebMCP lo omitan.

Paso 5: Sus propios datos a través de la REST API

Para los datos que la Store API no cubre, como las zonas de entrega o los horarios disponibles de un plugin de reservas, añada una pequeña ruta REST de solo lectura. Defina siempre un permission_callback, valide cada argumento y devuelva solo lo que un cliente puede ver:

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

Paso 6: Las acciones sensibles necesitan al comprador

Añadir al carrito, reservar y enviar formularios cambian algo, así que marque esas herramientas con consequentialHint: true y deje que el comprador confirme. Use la propia sesión del comprador y los nonces de WordPress, nunca una clave de administrador. Deje el pago y la finalización de la compra en manos del comprador. No cree herramientas que enumeren pedidos, clientes o usuarios.

Paso 7: Pruebe y, después, publique

1. Desarrolle primero en una copia de pruebas (staging) de su sitio.
2. Pruebe en una versión reciente de Chrome con WebMCP activado y llame a cada herramienta con entradas correctas e incorrectas.
3. Compruebe que los visitantes normales no notan ningún cambio y que la velocidad de la página no varía.
4. Ejecute el comprobador WebMCP gratuito en la página publicada para confirmar que las herramientas son visibles desde fuera.
5. Registre las llamadas a las herramientas sin datos personales y revíselas tras la publicación.

¿Prefiere que lo hagamos por usted?

Diseñamos, desarrollamos y probamos herramientas WebMCP para WordPress y WooCommerce, empezando con una auditoría de preparación gratuita y un presupuesto cerrado. Conozca nuestro servicio de integración de WebMCP en WordPress, o lea WebMCP frente a MCP para decidir si también necesita un servidor MCP.