HUSKY - WooCommerce Product Filter Professional

Servidor MCP: deja que tus clientes busquen en tu tienda desde Claude y ChatGPT

Servidor MCP: deja que tus clientes busquen en tu tienda desde Claude y ChatGPT

Cada vez más personas empiezan a comprar en una ventana de chat. Le piden a Claude o ChatGPT "botas de senderismo impermeables de la talla 43 por menos de 120 euros" y esperan que el asistente vuelva con productos que puedan comprar. El asistente solo puede recomendar lo que puede leer. Una tienda que es solo un sitio web se rastrea de vez en cuando. Una tienda con su propio servidor MCP se consulta en directo, con sus filtros, precios y existencias reales, cada vez que alguien pregunta.

Desde la versión 3.4.7, HUSKY añade un servidor MCP a tu tienda WooCommerce. MCP (Model Context Protocol) es el estándar con el que los asistentes de IA se conectan a datos externos. Una vez activado, un asistente conectado a tu tienda filtra tu catálogo exactamente igual que tu formulario de filtros de HUSKY y responde con tus productos, precios y enlaces. Después, el cliente abre la página de tu producto y compra en tu sitio, como siempre.

Pruébalo ahora en nuestra tienda de demostración: añade https://demo.products-filter.com/hello-mcp como conector en Claude o ChatGPT y pide algo, por ejemplo "ropa roja por menos de 30 dólares".

Qué obtienes con esto

  • Un asistente de compras para tus clientes, gratis para ti y para ellos. No pagas ningún servicio de IA. Tu cliente usa el asistente que ya tiene, añade una dirección y habla con tu catálogo con sus propias palabras y en su idioma.
  • Los catálogos grandes se vuelven fáciles de buscar. En una tienda con miles de productos y decenas de atributos, la gente abandona los formularios de filtros largos. El asistente lee todos tus filtros, los combina y reduce el resultado paso a paso: "solo en stock", "los más baratos", "lo mismo en azul".
  • Respuestas fiables. El asistente no adivina a partir de una copia antigua de tu sitio. Cada búsqueda pasa por la misma consulta que tu formulario de filtros, así que ve los mismos filtros, la misma lógica (OR, AND, NOT IN), los mismos valores y los mismos recuentos que ve un visitante.
  • Tráfico hacia las páginas de tus productos. Cada resultado enlaza con la página de tu producto. Si la búsqueda ha reducido un producto variable a una sola variación, el enlace lo abre con esa variación ya seleccionada, por ejemplo ?attribute_pa_color=red&attribute_pa_size=42.
  • Tus idiomas y monedas. Con WPML o Polylang, el asistente puede buscar en el idioma del cliente. Con FOX Currency Switcher puede mostrar los precios en la moneda del cliente, y el enlace del producto también se abre en esa moneda.
  • Una invitación visible. Un cuadro en tu sitio avisa a los clientes de que pueden comprar con su asistente de IA, y las herramientas de IA encuentran tu servidor por sí solas mediante archivos de descubrimiento estándar.

¿Es seguro para mi tienda?

El servidor está diseñado para mostrar el catálogo público y nada más.

  • Desactivado por defecto. Hasta que lo actives, el servidor, sus direcciones, los archivos de descubrimiento, el enlace del head, la sección de llms.txt y el cuadro del shortcode no existen en tu sitio.
  • Solo lectura. Las tres herramientas solo leen. A través del servidor no se puede comprar, añadir al carrito, editar ni borrar nada. Nunca se devuelven enlaces de pago.
  • Funciona como un visitante invitado. Nunca devuelve borradores, productos privados, productos protegidos con contraseña ni productos ocultos en el catálogo. Si WooCommerce oculta los artículos agotados, el servidor también los oculta. En el modo "Próximamente" de WooCommerce las herramientas se niegan a responder.
  • Sin cuentas, sin claves, sin datos personales. El servidor no necesita inicio de sesión porque solo lee lo que cualquier visitante puede ver. No establece cookies y no guarda nada sobre quien llama.
  • Límites de peticiones. Cada dirección tiene un límite estricto, por defecto 60 peticiones por minuto con ráfagas de 20. Al superar el límite, quien llama recibe HTTP 429 con los segundos que debe esperar. El bloqueo es temporal y se levanta solo, no hay nada que desbloquear a mano.
  • Un límite aparte para las plataformas de IA. Los clientes que usan claude.ai o ChatGPT llegan a tu tienda desde los servidores del propio asistente, así que muchos clientes comparten unas pocas direcciones. Los rangos de direcciones que Anthropic y OpenAI publican para esto tienen su propio límite, más alto, para que una tienda con mucha demanda no deje fuera a sus propios clientes.
  • Caché. Las búsquedas idénticas repetidas salen de una caché corta (90 segundos por defecto), de modo que la misma pregunta hecha cien veces no ejecuta cien consultas a la base de datos. Cualquier cambio en productos, existencias, precios, términos o ajustes de filtros la vacía.
  • Orígenes del navegador. Si no quieres que clientes MCP basados en navegador de otros sitios web usen tu servidor, indica los orígenes que permites.

Requisitos

HUSKY 3.4.7 o posterior, WordPress 6.0 o posterior, WooCommerce, PHP 7.4 a 8.5. En WordPress 6.9 y posteriores, las herramientas también se registran en la Abilities API de WordPress.

1. Actívalo

  1. Abre los ajustes de HUSKY y ve a la pestaña MCP Server.
  2. Cambia Enable MCP server a Yes.
  3. Haz clic en Save changes. Hasta que guardes, la dirección no responde.

Ahora la pestaña muestra Your MCP server address con un botón Copy.

La pestaña MCP Server en los ajustes de HUSKY

2. La dirección de tu servidor

Dirección Cuándo
https://your-shop.com/wp-json/husky/v1/mcp la dirección por defecto, siempre funciona
https://your-shop.com/index.php?rest_route=/husky/v1/mcp la dirección por defecto con enlaces permanentes simples
https://your-shop.com/ai-shop tu propia dirección corta, si la has definido

Tu propia dirección. En Your own address (pretty URL) escribe cualquier ruta libre, por ejemplo ai-shop. El campo la comprueba mientras escribes y te avisa cuando una página, entrada, categoría o archivo ya la usa. Una dirección corta es más fácil de dar a los clientes. La dirección por defecto sigue funcionando, y la server card, llms.txt, el enlace del head y el cuadro del shortcode pasan a usar la corta. Funciona con cualquier estructura de enlaces permanentes, incluida la simple, siempre que el servidor web pase las direcciones desconocidas a WordPress (las reglas estándar de .htaccess y de nginx try_files lo hacen).

Para clientes MCP: transporte Streamable HTTP, sin autenticación, versiones de protocolo 2026-07-28, 2025-11-25 y 2025-06-18 en la misma dirección.

3. Cuéntaselo a tus clientes

Un servidor que nadie conoce no sirve a nadie. HUSKY te da dos formas de anunciarlo: una para las personas y otra para las herramientas de IA.

Un cuadro en tus páginas

Coloca el shortcode [woof_mcp_connect] donde quieras: en una página, en una entrada o en un widget Text o Shortcode de tu barra lateral o pie de página. En el editor de bloques usa el bloque AI assistant connection (HUSKY MCP). El cuadro muestra la dirección de tu servidor con un botón Copy y tres pasos breves para Claude, ChatGPT y otros asistentes.

El cuadro de conexión que ven los clientes en las páginas de la tienda

El título y el texto se definen una sola vez en la pestaña MCP Server, en Box for your shop pages, o en cada uso:

[woof_mcp_connect title="Shop with your AI assistant" text="Add this address to Claude or ChatGPT and just say what you are looking for."]

Los textos se pueden traducir con el campo de traducción de etiquetas de taxonomía de HUSKY, igual que el resto del filtro.

Un buen sitio para el cuadro es la barra lateral de la tienda, el pie de página o una página breve como "Compra con IA" enlazada desde tu menú.

Archivos de descubrimiento para herramientas de IA

Los agentes de IA y los directorios buscan descripciones de un sitio legibles por máquinas. Mientras el servidor está activado, HUSKY las publica por ti:

  • llms.txt. Es un archivo de texto plano en la raíz de tu sitio que indica a las herramientas de IA qué es el sitio y dónde mirar. HUSKY le añade una sección con tu servidor MCP:
  • si Rank Math o el plugin Website LLMs.txt genera tu llms.txt, la sección se añade a su archivo;
  • si tu sitio no tiene llms.txt, HUSKY sirve uno en /llms.txt mientras el servidor está activado;
  • un archivo llms.txt físico nunca se modifica. La pestaña muestra la sección lista para pegarla en él.
  • Server card en <your address>/server-card, con el nombre del servidor, su descripción y sus direcciones.
  • /.well-known/ai-catalog.json, que apunta a la server card.
  • Enlaces en el head de la página (<link rel="ai-catalog"> y <link rel="service-desc">) en todas las páginas.

Puedes desactivar la sección de llms.txt y el enlace del head en la pestaña, en Discovery.

4. Cómo se conecta un cliente

La pestaña muestra cada fragmento de abajo con tu dirección ya rellenada y un botón Copy junto a cada uno. Sustituye https://your-shop.com/ai-shop por tu propia dirección.

Claude (claude.ai, Claude Desktop)

  1. Abre Customize → Connectors (claude.ai/customize/connectors).
  2. Haz clic en Add custom connector y pega la dirección.
  3. Deja vacíos los campos de OAuth y haz clic en Add.

En un chat, activa el conector en el menú de herramientas y pregunta, por ejemplo: "Busca zapatillas rojas de la talla 42 por menos de 150 euros."

ChatGPT

  1. Abre chatgpt.com/plugins, pulsa + y elige Add custom MCP server.
  2. Introduce un nombre, pega la dirección como Server URL y elige No authentication.
  3. Confirma, elige Create as a plugin, escribe @ en un chat y selecciónalo.

Qué planes y qué roles del espacio de trabajo pueden añadir conectores personalizados lo deciden Anthropic, OpenAI y el administrador del espacio de trabajo, no tu tienda.

Claude Code

claude mcp add --transport http my-shop https://your-shop.com/ai-shop

Cursor

.cursor/mcp.json en un proyecto, o ~/.cursor/mcp.json para todos los proyectos:

{
    "mcpServers": {
        "my-shop": {
            "url": "https://your-shop.com/ai-shop"
        }
    }
}

VS Code (GitHub Copilot)

.vscode/mcp.json, o el comando MCP: Add Server → HTTP:

{
    "servers": {
        "my-shop": {
            "type": "http",
            "url": "https://your-shop.com/ai-shop"
        }
    }
}

Cualquier otro cliente MCP

Añádelo como servidor remoto: Streamable HTTP, sin autenticación. Para comprobar el servidor desde un terminal:

npx @modelcontextprotocol/inspector --cli https://your-shop.com/ai-shop --transport http --method tools/list

5. Qué puede hacer el asistente

Herramienta Qué hace
husky_get_filter_schema Lista los filtros de tu formulario en su orden: categorías, atributos, marcas, precio, stock, en oferta, campos meta, búsqueda de texto, etc., cada uno con sus valores, recuentos de productos y lógica, además de los criterios de ordenación, idiomas y monedas.
husky_search_products Busca con cualquier combinación de esos filtros. Devuelve la página de productos con nombre, precio, precio rebajado, stock, imagen, valoración, atributos y enlace, y los recuentos de los valores restantes para que el asistente pueda acotar la búsqueda. Cuando no encuentra nada, indica qué filtro quitar y sugiere las alternativas más cercanas.
husky_get_product Un producto por ID, URL o SKU: descripción, galería, categorías, atributos, variaciones con precios y stock, y el enlace.

Peticiones que pueden hacer tus clientes:

  • "Portátiles con 16 GB de RAM por menos de 800, en stock."
  • "Algo como esta chaqueta, pero impermeable y en azul."
  • "Los auriculares más baratos en oferta, con enlace."
  • "Gibt es diese Schuhe in Größe 42? Preise bitte in Euro."

Instructions for agents. Cada asistente recibe un texto breve sobre cómo usar las herramientas: llamar primero al esquema, usar solo valores de filtro reales y dar enlaces. Puedes editarlo en la pestaña, en Instructions for agents, por ejemplo para añadir tu política de devoluciones o el tono que quieres. Reset to default recupera el texto de tu versión de HUSKY. Mientras mantengas el texto por defecto, recibes sus mejoras con las actualizaciones.

El nombre, el título y la descripción que ven los agentes se toman del título de tu sitio y se pueden cambiar en la pestaña.

6. Idiomas y monedas

  • WPML y Polylang. El asistente puede indicar un idioma. Entonces los resultados, recuentos, nombres y enlaces están en ese idioma, y solo se devuelven productos de ese idioma. Sin idioma, se usa el idioma por defecto.
  • FOX Currency Switcher. Los precios están en tu moneda base salvo que el asistente pida otra. La moneda elegida por el cliente, la geolocalización por IP y las cookies nunca afectan al servidor. Cuando se solicita una moneda, FOX convierte los precios exactamente como en tu tienda, incluidos los precios fijos por moneda, y los enlaces de producto llevan la moneda (?currency=EUR), de modo que la página del producto se abre con el mismo precio que citó el asistente.

Un enlace de producto abierto por el asistente: idioma alemán, precios en euros, variación preseleccionada

7. Ajustes de límite de peticiones y caché

Ajuste Valor por defecto
Por dirección IP 60 peticiones por minuto, ráfagas de 20
Plataformas de IA (cada rango publicado) 1200 peticiones por minuto, ráfagas de 300
Caché para búsquedas idénticas 90 segundos
Máximo de productos por página 50 (puedes fijar de 1 a 100)
  • La lista por defecto de plataformas de IA contiene solo rangos que los proveedores publican en su propia documentación: Anthropic (Claude) y OpenAI (conectores de ChatGPT). Mientras mantengas la lista por defecto, sigue las actualizaciones de HUSKY. Si la editas, se conserva tu lista, y Reset to default carga la lista de tu versión de HUSKY.
  • 0 desactiva un límite. Rate limit: Off los desactiva todos.
  • Los contadores se guardan en tu caché de objetos persistente (Redis, Memcached) o en APCu si está disponible; si no, en la base de datos.

8. Solución de problemas

Síntoma Qué comprobar
La dirección responde 404 El servidor está desactivado, o los ajustes no se guardaron después de activarlo.
La dirección corta responde 404 Otra página o archivo la usa (la pestaña muestra el conflicto), o el servidor web no pasa las direcciones desconocidas a WordPress. La dirección por defecto sigue funcionando.
/.well-known/ai-catalog.json no se encuentra WordPress está instalado en una subcarpeta y no puede responder en la raíz del dominio. La server card y el enlace del head siguen funcionando.
/.well-known/ai-catalog.json responde 403 La configuración de tu nginx bloquea todas las direcciones que empiezan por un punto. Añade location ^~ /.well-known/ { try_files $uri $uri/ /index.php?$args; } antes de esa regla.
Abrir la dirección en un navegador o pegarla en un chat da 405 Es lo esperado. La dirección no es una página web: solo responde a peticiones MCP. Añádela al asistente como conector (sección 4).
El asistente dice "too many requests" Se alcanzó el límite de peticiones. Sube las cifras en la pestaña o añade el rango publicado de la plataforma.
Los precios están en la moneda base Es lo esperado. Pide al asistente otra moneda ("en euros").
Un cortafuegos o un plugin de seguridad bloquea al asistente Permite la dirección MCP para peticiones que no vengan de un navegador. claude.ai y ChatGPT llaman desde sus propios servidores.
Los resultados difieren de lo que ves en la tienda Los productos protegidos con contraseña nunca aparecen en los resultados de MCP. Comprueba también que has cerrado sesión: algunos productos solo los ven los usuarios con sesión iniciada.

9. Para desarrolladores

Filtro Finalidad
woof_mcp_filters Cambia la lista de filtros que se entrega a los agentes
woof_mcp_product_card Cambia una tarjeta de producto en los resultados de búsqueda
woof_mcp_product_details Cambia la respuesta de husky_get_product
woof_mcp_product_is_public Decide si un producto puede mostrarse
woof_mcp_server_card Cambia la server card
woof_mcp_llms_txt Cambia la sección de llms.txt
woof_mcp_default_ai_ranges Cambia los rangos de plataformas de IA por defecto
woof_mcp_client_ip Indica a HUSKY la IP real de quien llama detrás de un proxy
woof_mcp_respect_coming_soon Permite las herramientas en el modo "Próximamente"

En WordPress 6.9 y posteriores, las mismas tres operaciones están registradas en la Abilities API de WordPress (husky/get-filter-schema, husky/search-products, husky/get-product), de modo que el WordPress MCP Adapter también puede exponerlas.