WooCommerce 11.3 y el MCP Adapter: qué cambió hoy

En pocas palabras: Desde WooCommerce 11.3 (21 de octubre de 2026) el endpoint /wp-json/woocommerce/mcp y la autenticación X-MCP-API-Key quedan eliminados y devuelven HTTP 410. Para conectar asistentes de IA hay que instalar el plugin WordPress MCP Adapter 0.7.0 y usar una application password de WordPress.

WooCommerce 11.3 eliminó el endpoint /wp-json/woocommerce/mcp y ahora exige el plugin WordPress MCP Adapter activo para conectar cualquier asistente de IA a la tienda. Según el anuncio oficial de WooCommerce del 21 de octubre de 2026, las claves REST API con el header X-MCP-API-Key dejan de funcionar y el endpoint viejo responde HTTP 410.

El WordPress MCP Adapter es un plugin publicado en WordPress.org en su versión 0.7.0 que implementa el Model Context Protocol para que asistentes como Claude o ChatGPT puedan listar, crear y actualizar productos y pedidos de una tienda WooCommerce a través de la Abilities API de WordPress, respetando los permisos de usuario que ya existen en el sitio.

¿Qué cambia exactamente en WooCommerce 11.3 para las conexiones MCP?

Las abilities de producto y pedido pasan a estar habilitadas por defecto en WooCommerce 11.3, pero establecer una conexión MCP real ahora depende de tener el plugin WordPress MCP Adapter activo en el sitio. Sin ese plugin, no hay conexión posible, por más que las abilities estén registradas en el core.

El cambio de fondo lo explica Darren Ethier en el anuncio del equipo de WooCommerce: la versión 0.7.0 del MCP Adapter es la primera que se publica como plugin de WordPress.org, y a partir de ahí se deprecó distribuirlo como librería Composer. Tiene sentido: con un adaptador compartido por sitio, mantener un endpoint paralelo de WooCommerce con su propia autenticación y su propio set de herramientas «a medida» solo sumaba configuración y confusión (son palabras textuales del propio anuncio).

Ahora las abilities purpose-built de WooCommerce reemplazan a las que se derivaban de la REST API, y el servidor por defecto del adaptador ya las expone junto con las que registren otros plugins del sitio.

¿Qué endpoints y funciones deja de funcionar a partir de esta versión?

El endpoint /wp-json/woocommerce/mcp deja de responder con datos y ahora devuelve HTTP 410 junto con un error JSON-RPC que explica cómo conectarse por el MCP Adapter. Lo mismo pasa con la autenticación vía X-MCP-API-Key, que queda sin efecto.

También desaparece la feature mcp_integration que vivía en WooCommerce > Settings > Advanced > Features. La función FeaturesUtil::feature_is_enabled('mcp_integration') ahora siempre devuelve false, así que cualquier código que la consulte para decidir algo va a tomar el camino del «apagado» sin excepción.

Las abilities REST-derivadas que solo usaba el endpoint viejo también se van: woocommerce/products-list, products-get, products-create, products-update, products-delete, orders-list, orders-get, orders-create y orders-update. Y tres filtros quedan sin efecto: woocommerce_mcp_include_ability, woocommerce_mcp_allow_insecure_transport y woocommerce_check_rest_ability_permissions_for_method. Si tu código colgaba callbacks de esos filtros, simplemente dejan de ejecutarse.

¿Cómo saber si tu tienda o extensión está afectada por el cambio?

Estás afectado si tu cliente MCP se conecta al endpoint viejo con una API key de WooCommerce, o si tu extensión registra abilities que esperaba ver en ese endpoint. Son dos escenarios bien distintos y conviene chequear los dos por separado antes de actualizar.

Según la documentación de desarrolladores de WooCommerce, los casos concretos son estos:

• Un cliente MCP conecta con la API key vieja. Si tu asistente apunta a /wp-json/woocommerce/mcp con una clave REST de WooCommerce, se va a romper apenas actualices.
• Tu extensión depende del namespace woocommerce/ o de expose_in_deprecated_woocommerce_mcp. Esas abilities no aparecen más en ningún endpoint automáticamente.
• Tu código engancha los filtros deprecados. woocommerce_mcp_include_ability, woocommerce_mcp_allow_insecure_transport o woocommerce_check_rest_ability_permissions_for_method ya no disparan nada.
• Tu código usa clases WP\MCP\* asumiendo que WooCommerce las carga. Eso dejó de ser así.
• Tu código llama a MCPAdapterProvider, WooCommerceRestTransport, AbilitiesRestBridge o RestAbilityFactory. Siguen existiendo como clases, pero no hacen nada.

¿Y si ninguno de estos puntos te suena? Entonces probablemente no tengas nada que tocar, salvo instalar el MCP Adapter si querés seguir usando MCP.

Pasos para migrar al MCP Adapter antes de actualizar a 11.3

Migrar implica instalar el plugin MCP Adapter, crear una application password de WordPress y repuntar el cliente al nuevo endpoint, en ese orden. Hacerlo antes de actualizar a 11.3 evita que el asistente quede colgado el día que subís la versión nueva.

Aspecto	Endpoint deprecado	MCP Adapter plugin
URL	/wp-json/woocommerce/mcp	/wp-json/mcp/mcp-adapter-default-server
Autenticación	API key REST de WooCommerce (X-MCP-API-Key)	Application password de WordPress
Estado desde WooCommerce 11.3	HTTP 410, sin uso	Activo, requiere instalación manual
Abilities expuestas	REST-derivadas (products-list, orders-get, etc.)	Purpose-built (woocommerce/products-query, order-notes-query, etc.)

En la práctica, los pasos son:

• Instalar y activar el plugin. Con WP-CLI alcanza wp plugin install mcp-adapter --activate.
• Crear una application password. Desde Usuarios > Perfil, para un usuario con solo las capacidades que el cliente necesita, nunca con la contraseña de la cuenta.
• Apuntar el cliente MCP al nuevo endpoint. /wp-json/mcp/mcp-adapter-default-server, con ese usuario y esa application password.
• Revocar las API keys viejas. Una vez confirmada la conexión nueva, no hay motivo para dejarlas activas.

Si en lugar del MCP Adapter oficial usás un conector de terceros como MCP for WooCommerce de w7s, vale la pena revisar su propia documentación de requisitos antes de poner el asistente a trabajar de forma permanente. Ese es un plugin distinto, con su propio set de pantallas y abilities, así que lo que diga su documentación no necesariamente aplica al MCP Adapter oficial. Si vas a mantener cualquier conector activo todo el día, conviene correrlo sobre un hosting WordPress con margen de recursos como el de Donweb, en vez de un plan pensado para un blog chico.

¿Qué deben hacer los desarrolladores de extensiones para no romper sus abilities?

Los desarrolladores tienen que registrar sus abilities a través de la Abilities API de WordPress y agregar la metadata 'mcp' => array('public' => true, 'type' => 'tool') para que el MCP Adapter las exponga. Sin esa metadata, la ability existe pero el adaptador la ignora.

Las abilities custom que aparecían en el endpoint viejo no se migran solas. Antes de la versión 10.9 bastaba con estar en el namespace woocommerce/; desde 10.9 hacía falta el flag expose_in_deprecated_woocommerce_mcp en true; y el filtro woocommerce_mcp_include_ability podía sumar o sacar abilities en cualquiera de las dos versiones. Ninguno de esos tres mecanismos afecta al servidor por defecto del MCP Adapter, que solo expone una ability si meta.mcp.public es true (o, si eso no está seteado, cae al meta.public de nivel superior).

Las clases removidas no rompen el sitio, eso es lo bueno. MCPAdapterProvider, WooCommerceRestTransport, AbilitiesRestBridge y RestAbilityFactory siguen existiendo, pero sus métodos no hacen nada, solo disparan un aviso de «called incorrectly» con la guía de migración. El patrón recomendado para no depender ciegamente del MCP Adapter es chequear la clase antes de usarla:

Esto se conecta con MCP Adapter en WooCommerce, donde explicamos cómo editar tu tienda de forma segura con agentes de IA.

• Verificar en runtime antes de registrar un servidor. if ( class_exists( 'WP\MCP\Core\McpAdapter' ) ) { /* registrar server o tools */ }
• Declarar la dependencia si la extensión no puede vivir sin MCP. Agregando Requires Plugins: mcp-adapter en el header del plugin.

Errores comunes al migrar al MCP Adapter

• Dejar la API key vieja esperando que «zafe» un poco más. No zafa: desde 11.3 el endpoint devuelve 410 directo, no hay período de gracia.
• Usar la contraseña real del usuario de WordPress en vez de una application password. La documentación oficial es clara en esto: nunca la contraseña de la cuenta, siempre una application password dedicada y revocable.
• Confundir el MCP Adapter oficial con «MCP for WooCommerce» de w7s. Son cosas distintas. El MCP Adapter es el plugin de WordPress.org que implementa el protocolo a nivel core; «MCP for WooCommerce» es un plugin de terceros que agrega una pantalla de configuración, tool packs y gestión de keys por arriba de esa base. Si instalaste uno pensando que era el otro, revisá bien cuál tenés activo.
• No revisar si las abilities custom tienen la metadata mcp.public. Sin ese flag, la ability queda registrada pero invisible para cualquier asistente, y el error no es obvio hasta que alguien pregunta por qué el cliente «no ve» ese producto o pedido.

Preguntas Frecuentes

¿Qué cambia en WooCommerce 11.3 respecto al MCP Adapter?

WooCommerce 11.3 habilita por defecto las abilities de producto y pedido, pero exige tener el plugin WordPress MCP Adapter activo para que cualquier cliente MCP pueda usarlas. También elimina el endpoint /wp-json/woocommerce/mcp y las abilities REST-derivadas que dependían de él.

¿Por qué se eliminó el endpoint /wp-json/woocommerce/mcp?

Porque mantener un endpoint propio de WooCommerce con su autenticación y sus abilities derivadas de la REST API sumaba configuración duplicada frente al adaptador MCP compartido que ya usa el resto de WordPress. Según el anuncio oficial, esa duplicación «solo añadía configuración y confusión».

¿Cómo conecto mi tienda WooCommerce a un asistente de IA ahora?

Instalando el plugin MCP Adapter (wp plugin install mcp-adapter --activate), creando una application password de WordPress para un usuario con permisos acotados, y apuntando el cliente al endpoint /wp-json/mcp/mcp-adapter-default-server en vez del endpoint viejo de WooCommerce.

¿Qué es el WordPress MCP Adapter plugin?

Es el plugin oficial publicado en WordPress.org, en su versión 0.7.0, que implementa el Model Context Protocol sobre la Abilities API de WordPress. Reemplaza a la antigua distribución como librería Composer y es el único camino soportado para conectar asistentes de IA a una tienda WooCommerce desde la versión 11.3.

¿Mis claves REST API de WooCommerce dejan de funcionar con MCP?

Sí. Las claves REST de WooCommerce autenticadas con el header X-MCP-API-Key dejan de servir para MCP a partir de la versión 11.3: cualquier request al endpoint viejo devuelve HTTP 410.

Conclusión

Lo que cambia en el fondo con WooCommerce 11.3 es dónde vive la lógica de MCP: antes estaba duplicada dentro de WooCommerce con su propio endpoint y su propia autenticación, ahora pasa a depender por completo del adaptador compartido de WordPress. Si tenés un asistente conectado hoy con la API key vieja, no actualices sin migrar primero: instalá el MCP Adapter, generá una application password y probá la conexión nueva antes de subir la versión a producción. Si mantenés una extensión con abilities custom, revisá la metadata mcp.public ahora, no después de que un cliente te avise que «el asistente no ve nada».

¿Qué es MCP en WooCommerce?

MCP (Model Context Protocol) es el protocolo que le permite a asistentes de IA como Claude o ChatGPT conectarse a tu tienda WooCommerce para leer y gestionar productos y pedidos. Lo implementa el plugin WordPress MCP Adapter, que expone esas funciones respetando los permisos de usuario que ya tenés configurados en el sitio.

¿El plugin MCP Adapter es gratis?

Sí, el WordPress MCP Adapter se descarga gratis desde el repositorio oficial de WordPress.org, igual que cualquier otro plugin del directorio. No necesitás licencia ni pago adicional para instalarlo y usarlo junto con WooCommerce.

¿Tengo que instalar el MCP Adapter si no uso IA en mi tienda?

No, si no conectás ningún asistente de IA a tu catálogo podés actualizar a WooCommerce 11.3 sin instalar el MCP Adapter. El cambio solo te afecta si usabas el endpoint viejo de MCP o pensás usar herramientas como Claude o ChatGPT con tu tienda.

Fuentes

• WooCommerce 11.3 MCP Adaptor updates – anuncio oficial de WooCommerce (21 de octubre de 2026)
• Model Context Protocol (MCP) Integration – documentación para desarrolladores de WooCommerce
• MCP for WooCommerce – documentación del conector de terceros w7s