Servidor MCP para WooCommerce: asistente de IA para tu tienda

Edita en masa, analiza y exporta — en una sola conversación

Edita en masa productos de WooCommerce

Entiende qué está pasando en tu tienda

Exporta productos de WooCommerce a CSV

Crea productos de WooCommerce

Fotos de producto, directamente desde tu ordenador

Variaciones de productos que ya tienes

Categorías, etiquetas, marcas y atributos

Pedidos, reembolsos y pedidos manuales

Cupones

Rellena una tienda de pruebas con productos

Qué es un servidor MCP de WordPress, en pocas palabras

Dile una vez cómo te gustan las cosas

Qué asistentes de IA se pueden conectar a WooCommerce

• Claude — en el navegador, en la aplicación de escritorio y en Claude Code
• ChatGPT — sus conectores personalizados actualmente esperan un flujo de inicio de sesión (OAuth) en lugar de una clave en una cabecera, así que puede que una conexión directa no esté disponible todavía. Algunas versiones ofrecen un campo de clave API; si la tuya lo tiene, la clave va ahí.
• Cursor, Windsurf, Zed y otros asistentes de programación
• Tu propio agente — cualquier cosa que hable MCP, incluido algo que hayas escrito tú mismo

Cómo conectar un asistente de IA a tu tienda de WooCommerce

Activa el servidor MCP

Encuentra tu clave MCP en BEAR

Añade el conector en Claude

• Nombre de cabecera: Authorization
• Valor: Bearer, un espacio y luego tu clave

claude mcp add --transport http bear https://yourshop.com/wp-json/woobe/v1/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Un error 403 al añadir el conector es normal

Claude pregunta antes de usar cada herramienta por primera vez

Por qué la clave nunca va en la dirección

Conexión MCP en dos pasos

1. Inicias una conversación. El asistente pide un token a la tienda y te lo muestra.
2. Lo pegas en Confirm assistant connection en los ajustes de BEAR y pulsas Confirm connection. Para la clave de toda la tienda esto solo lo puede hacer un administrador con la sesión iniciada; un gestor de la tienda con clave personal confirma su propio token en sus propios ajustes.
3. Le dices al asistente que ya está hecho, y este funciona como siempre, enviando el token con cada petición.

Acceso MCP para los gestores de la tienda

Dale acceso a un usuario

Lo que ve el usuario

La conexión en dos pasos siempre está activada para las claves personales

1. El gestor inicia una conversación. El asistente pide un token a la tienda y se lo muestra.
2. Lo pega en Confirm assistant connection dentro de su propio bloque Tu acceso MCP y pulsa Confirm connection. Hace esto él mismo, con su propia sesión iniciada: el administrador nunca tiene que hacer de intermediario con los tokens.
3. Le dice al asistente que ya está hecho, y el trabajo empieza.

El asistente trabaja como esa persona, y nada más

Quitar el acceso

• Elimina al usuario de la lista y guarda. Su clave y su sesión se eliminan, y la siguiente petición se rechaza de inmediato, incluso si su asistente está en mitad de un trabajo. Una edición masiva larga se ejecuta en porciones, una petición cada vez: la porción que ya se está escribiendo termina, la siguiente se rechaza, y todo lo escrito hasta ese momento está en Historial y se puede revertir.
• Cambia su rol para que ya no pueda gestionar WooCommerce, o elimina la cuenta. La clave deja de funcionar al instante, no hay que regenerar nada.
• ¿Puede haberse filtrado la clave? El usuario pulsa Regenerate key. La clave antigua y la sesión que la usaba dejan de funcionar de inmediato; él pone la clave nueva en su asistente.

Cerrar partes de la tienda para un usuario concreto

• products — buscar, leer, editar, editar en masa, crear, generar, eliminar y restaurar productos
• variations — añadir y quitar variaciones, cambiar sus ejes de atributos
• taxonomy — categorías, etiquetas, marcas y atributos y sus valores
• media — la biblioteca de medios, imágenes de producto, importación de imágenes y enlaces de subida
• coupons — listar, crear, editar, eliminar y restaurar cupones
• orders — la lista de pedidos, un pedido concreto, pedidos manuales, cambios de estado, notas
• refunds — reembolsar pedidos y los informes de reembolsos
• reports — ventas, mejores clientes, margen, stock frente a ritmo de venta, desgloses de pago y envío, uso de cupones
• export — exportación CSV y su enlace de descarga
• history — leer el historial de ediciones y revertir ediciones masivas
• maintenance — vaciar cachés, recontar términos, reconstruir tablas de búsqueda, limpiezas
• memory — las notas permanentes sobre cómo te gusta que se hagan las cosas

Cada sector detallado

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map['products']    = 'full';
        $map['variations']  = 'full';
        $map['taxonomy']    = 'full';
        $map['media']       = 'full';
        $map['coupons']     = 'full';
        $map['orders']      = 'full';
        $map['refunds']     = 'full';
        $map['reports']     = 'full';
        $map['export']      = 'full';
        $map['history']     = 'full';
        $map['maintenance'] = 'full';
        $map['memory']      = 'full';
    }
    return $map;
}, 10, 2 );

Cierra una o dos cosas, deja el resto

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map['orders'] = 'read';
        $map['export'] = 'none';
    }
    return $map;
}, 10, 2 );

Todo abierto, el dinero cerrado

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map['*']       = 'full';
        $map['orders']  = 'none';
        $map['refunds'] = 'none';
        $map['coupons'] = 'none';
        $map['reports'] = 'none';
    }
    return $map;
}, 10, 2 );

Mirar todo, no cambiar nada

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map = array( '*' => 'read' );
    }
    return $map;
}, 10, 2 );

Cerrado por defecto, solo lo que abres

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map = array(
            '*'          => 'none',
            'products'   => 'full',
            'variations' => 'full',
            'media'      => 'full',
            'taxonomy'   => 'read',
        );
    }
    return $map;
}, 10, 2 );

Varios usuarios, reglas distintas

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    switch ( (int) $user_id ) {
        case 57: // catalogue manager
            $map['*']       = 'full';
            $map['orders']  = 'none';
            $map['refunds'] = 'none';
            break;
        case 64: // order desk
            $map = array(
                '*'        => 'none',
                'orders'   => 'full',
                'refunds'  => 'full',
                'products' => 'read',
            );
            break;
        case 71: // accountant
            $map = array( '*' => 'read' );
            break;
    }
    return $map;
}, 10, 2 );

Quién cambió qué

Ejemplos: gestionar una tienda de WooCommerce por chat

Edición masiva de precios: una subida de precios de temporada

Programa una oferta con fecha de inicio y fin

Encuentra la variación de producto que más se devuelve

Sabe cuándo reponer: stock frente a ritmo de venta

Exporta una lista de precios de WooCommerce como CSV

Ventas de WooCommerce por mes

Crea un producto variable con todas sus variaciones

Reembolsa un artículo y devuélvelo al estante

Cierra un lote de pedidos

Gráficos en el chat: pedir una imagen, no solo un número

• Muéstrame las ventas por mes como columnas, y déjame cambiar a una línea.
• Los reembolsos del año como una ola, y una segunda vista con el porcentaje de los ingresos.
• Los diez productos principales por unidades y por ingresos, uno al lado del otro — quiero ver dónde cambia el orden.
• Divide los métodos de envío como cuotas, con los porcentajes en la leyenda.
• La lista de stock como tabla con búsqueda y paginación, ordenada por días de cobertura.
• El mismo gráfico, pero solo el último trimestre.

Doce preguntas ya preparadas sobre tu tienda

• How the shop is doing (Cómo va la tienda) — ingresos por mes con los productos que los sostienen
• Show me the numbers (Muéstrame los números) — un período desde tres ángulos, listo para cambiar entre tipos de gráfico
• What is left in stock (Qué queda en stock) — stock frente a ritmo de venta, ordenado por días de cobertura
• When to buy more (Cuándo comprar más) — la lista de reposición, lo más urgente primero
• What sells fastest (Qué se vende más rápido) — unidades al día, para que el volumen barato no quede oculto detrás de una gran oferta
• What is not moving (Qué no se mueve) — productos que no vendieron nada, con lo que queda en el estante
• What sold and what came back (Qué se vendió y qué volvió) — los más vendidos junto a los reembolsos por tasa
• What comes back (Qué vuelve) — reembolsos por variación
• Where the money is (Dónde está el dinero) — margen bruto por producto, el peor primero
• What the discounts cost (Cuánto cuestan los descuentos) — cada cupón, cuántas veces se usó, cuánto se regaló
• How people pay and get it (Cómo paga y recibe la gente) — cuota de pedidos por método de envío y pasarela
• Plan a sale with an end date (Planea una oferta con fecha de fin) — calcula los precios y te devuelve el cambio para que lo apruebes

Cómo BEAR evita que rompas tu tienda

Nada se escribe sin una vista previa

Avisos que no deducirías de los números

• Productos cuyo precio de oferta WooCommerce eliminará en silencio porque el nuevo precio normal quedó por debajo de él
• Padres variables, donde escribir un precio no cambia nada que el cliente vea
• Campos vacíos, donde un cambio porcentual da cero
• Fechas de oferta fijadas sin un precio de oferta, que se guardan sin problema y no hacen nada
• Productos ya rebajados con un descuento mayor que la oferta que estás planeando
• Sustituir los valores de un atributo en un producto variable, donde las variaciones construidas sobre los valores antiguos se quedarían en la tienda pero ya no se podrían elegir
• Pedidos y reembolsos de artículos que no controlan el stock, donde nada se moverá en el estante

Cosas que se rechazan en lugar de solo avisar

• Escribir un atributo directamente en una variación, en masa o de una en una. Borraría los demás atributos de la variación, así que el asistente se dirige a las herramientas de variaciones en su lugar.
• Fijar una cantidad de stock en un producto que no controla el stock. WooCommerce no la guardaría, y una escritura que en silencio no hace nada es peor que un claro "activa primero el control de stock".
• Campos que son de solo lectura en todas las versiones, como el ID del producto y el autor. El asistente dice que se cambian en wp-admin en lugar de intentarlo.

Un número que tienes que confirmar

Cada cambio queda en tu historial

• El administrador ve cada entrada de cada usuario y puede revertir o eliminar cualquiera de ellas.
• Un gestor de la tienda ve solo sus propias entradas, hechas a mano o mediante su asistente, y solo puede revertir esas. Se aplica la misma regla a su asistente: no puede ver ni deshacer los cambios de nadie más.

Elimina en masa productos de WooCommerce

Restaurar productos eliminados de la papelera

Exportar productos y listas de precios de WooCommerce

• Qué productos — cualquier filtro que puedas describir, o todo el catálogo
• Qué columnas, y en qué orden — una lista de precios empieza con el SKU, una hoja de inventario no necesita descripciones
• Qué separador — un punto y coma para hojas de cálculo europeas
• Con o sin variaciones — activado por defecto, ya que ahí es donde viven el precio y el stock

Tiendas multidivisa: informes en tu moneda base

Gratis y de pago: qué permite la versión gratuita

Qué campos se pueden editar en masa

Cuántos productos por media hora

Cómo es una edición masiva larga

Dónde está realmente el límite

Cuánto historial se conserva

Encargarle un trabajo largo a tu propio agente

Requisitos

• WooCommerce 6.0 o más reciente
• HTTPS en tu tienda
• El servidor MCP activado en los ajustes de BEAR
• Para acceso personal: un usuario que pueda gestionar WooCommerce (el rol Gestor de la tienda (Shop manager) o equivalente) y que esté en la lista Acceso MCP para usuarios
• Un cliente de IA compatible con MCP
• Para informes de ventas, reembolsos y margen: WooCommerce Análisis (Analytics) activado, con su importación histórica terminada

Problemas comunes y cómo solucionarlos

Aparece un error 403 al añadir el conector

El asistente ofrece un flujo de inicio de sesión en lugar de un campo de cabecera

La conexión se rechaza

El asistente me pide confirmar un token

El asistente dice que una herramienta no está disponible para mí

Un gestor no puede ver cambios en Historial

Claude sigue pidiendo permiso para las herramientas

Las herramientas nuevas no aparecen después de una actualización

La tienda muestra algo que no está ahí

Un informe está vacío aunque haya pedidos

¿Por qué mi margen está vacío?