Shopify MCP vs WooCommerce MCP: Comparación para Desarrolladores

Visión General de la Arquitectura

Autenticación

Shopify: OAuth 2.0 con Auto-Refresh

// Refresh de token con backoff exponencial (shopify-oauth.service.ts)
for (let attempt = 0; attempt < 3; attempt++) {
  const delay = 2000 * Math.pow(2, attempt); // 2s, 4s, 8s
  const result = await refreshToken(store.refreshToken);
  if (result.ok) return result;
  await sleep(delay);
}
// Fallo permanente (401/403): activar flag needsReauth

WooCommerce: HTTP Basic Auth

Obtención de Datos

Shopify: GraphQL Admin API (2024-10)

query {
  products(first: 100, after: $cursor, sortKey: UPDATED_AT) {
    edges {
      node {
        id title descriptionHtml handle vendor productType tags status
        priceRangeV2 { minVariantPrice { amount currencyCode } }
        variants(first: 100) {
          edges { node { id title price sku inventoryQuantity availableForSale } }
        }
        images(first: 20) { edges { node { url altText } } }
      }
    }
    pageInfo { hasNextPage endCursor }
  }
}

WooCommerce: REST API v3

// Llamadas REST API de WooCommerce (class-catalog-sync.php)
GET /wp-json/wc/v3/products?page=1&per_page=100
GET /wp-json/wc/v3/products/categories

// Cada producto incluye datos de variantes inline (sin consulta separada)
// Las categorías requieren un join entre product.categories[] y categorías obtenidas

Mecanismos de Sincronización

• 1
  Shopify: Solo sync completo — paginación por cursor a través de todo el catálogo, normaliza cada producto, persiste con flag de completitud. Sin sync incremental (podría usar filtro por updatedAt pero no está implementado). Webhooks planeados pero aún no activos.
• 2
  WooCommerce: Completo + Incremental — sync completo inicial en lotes paginados (100 productos), luego actualizaciones en tiempo real vía hooks de WordPress (on_product_save, on_stock_change, on_product_delete). Los cambios se envían a /api/v1/plugin/catalog/sync inmediatamente.

Rate Limiting

Integración con Herramientas MCP

Cobertura de Tests

• 1
  Shopify: ~1,015 líneas de tests en 2 archivos. Cubre intercambio de token OAuth, verificación HMAC, validación de estado, parsing de callback, flujos de onboarding vs reauth, estado del token y métricas de salud.
• 2
  WooCommerce: ~200+ líneas de tests E2E con Playwright. Cubre activación del plugin, UI de settings, API REST del carrito, validación de API key, firmas de webhook de billing y enforcement del dominio del merchant.

Proceso de Setup

Setup Shopify (3 pasos)

• 1
  El merchant ingresa el dominio de la tienda en el dashboard de AgenticMCPStores
• 2
  Redirect OAuth → pantalla de consentimiento de Shopify → autorizar
• 3
  Intercambio de token + creación de tienda + auto-sync (automático)

Setup WooCommerce (5 pasos)

• 1
  Instalar el plugin AgenticMCPStores desde el admin de WordPress
• 2
  Generar Consumer Key + Consumer Secret en los settings de WooCommerce
• 3
  Ingresar la API key en la página de settings del plugin
• 4
  Probar la conexión para verificar acceso a la API
• 5
  Disparar sync completo inicial (actualizaciones incrementales comienzan automáticamente)

Tabla Comparativa

Cuándo Usar Cuál

• 1
  Elige Shopify si quieres el onboarding más simple (OAuth de 3 clics), gestión automática de tokens y eficiencia GraphQL. Ideal para merchants que ya están en Shopify y quieren conectividad con agentes sin mantenimiento.
• 2
  Elige WooCommerce si necesitas sync incremental en tiempo real (sin lag de re-sync completo), ejecutas tu propia infraestructura WordPress, o quieres control total sobre el código del plugin. Ideal para merchants self-hosted que valoran la soberanía de datos.

Limitaciones Conocidas

• 1
  Shopify: Variantes limitadas a 100 por producto (hardcoded en GraphQL). Sin sync incremental aún. Webhooks planeados pero no activos. La búsqueda global de productos requiere credenciales separadas de la Storefront API.
• 2
  WooCommerce: Sin registro automático de webhooks (estrategia de dedup diseñada pero no implementada). Mínimo WooCommerce 3.5+. HTTPS obligatorio. El cart bridge es grande (~9,800 líneas) — área de superficie potencial para mantenimiento.

Qué Viene