Que es CommerceHub MCP?

CommerceHub es un servidor MCP (Model Context Protocol) que permite a agentes de IA gestionar operaciones de e-commerce en multiples plataformas simultaneamente.

En lugar de alternar entre dashboards de Shopify, WooCommerce, Stripe y MercadoLibre, simplemente habla con tu agente de IA:

"Muestrame las ventas de hoy comparadas con ayer"

"Que productos necesito reabastecer esta semana?"

"Sincroniza el catalogo de Shopify a WooCommerce"

"Procesa el reembolso de la orden #1234 porque el cliente recibio el producto danado"

Planes y precios

Comprar Pro - $45.000 CLP/mes | Comprar Business - $185.000 CLP/mes | Pro Lifetime - $275.000 CLP

Plataformas soportadas

Clientes de IA compatibles

CommerceHub usa el protocolo MCP estandar (stdio), por lo que es compatible con cualquier cliente que soporte Model Context Protocol.

Arquitectura

  +----------+  +----------+  +----------+  +----------+
  |  Claude  |  | ChatGPT  |  |  Gemini  |  |  Cursor  |  ...
  | Desktop  |  | Open Web |  |  Studio  |  |   IDE    |
  +----+-----+  +----+-----+  +----+-----+  +----+-----+
       |              |              |              |
       +--------------+--------------+--------------+
                             |
                      MCP Protocol (stdio)
                             |
                    +--------+---------+
                    |   CommerceHub    |
                    |   MCP Server     |
                    +--------+---------+
                             |
         +-------------------+-------------------+
         |              |              |              |
   +-----+----+  +-----+----+  +------+-----+  +-----+------+
   |  Shopify |  |   Woo    |  |   Stripe   |  | MercadoLibre|
   |  Admin   |  | Commerce |  |    API     |  |    API      |
   +----------+  +----------+  +------------+  +-------------+

Instalacion

Requisitos previos

• Node.js 20 o superior
• npm 9 o superior
• Credenciales de al menos una plataforma (Shopify, WooCommerce, Stripe o MercadoLibre)

1. Clonar e instalar

git clone https://github.com/tu-usuario/commercehub-mcp.git
cd commercehub-mcp
npm install
npm run build

2. Configurar credenciales

cp .env.example .env
# Edita .env con tus credenciales

3. Conectar con tu cliente de IA

CommerceHub es compatible con todos los clientes MCP:

{
  "mcpServers": {
    "commercehub": {
      "command": "node",
      "args": ["/ruta/a/commercehub-mcp/dist/index.js"],
      "env": {
        "SHOPIFY_STORE_URL": "https://tu-tienda.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx"
      }
    }
  }
}

claude mcp add commercehub node /ruta/a/commercehub-mcp/dist/index.js

{
  "mcpServers": {
    "commercehub": {
      "command": "node",
      "args": ["/ruta/a/commercehub-mcp/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "commercehub": {
      "command": "node",
      "args": ["/ruta/a/commercehub-mcp/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "commercehub": {
      "command": "node",
      "args": ["/ruta/a/commercehub-mcp/dist/index.js"]
    }
  }
}

mcpServers:
  - name: commercehub
    command: node
    args:
      - /ruta/a/commercehub-mcp/dist/index.js

{
  "commercehub": {
    "command": "node",
    "args": ["/ruta/a/commercehub-mcp/dist/index.js"]
  }
}

{
  "mcpServers": {
    "commercehub": {
      "command": "node",
      "args": ["/ruta/a/commercehub-mcp/dist/index.js"]
    }
  }
}

Guia Rapida

Una vez conectado, prueba estos comandos:

"Lista mis productos de Shopify"
"Muestrame las ordenes pendientes de enviar"
"Cual es el revenue de esta semana?"
"Que productos tienen stock bajo?"
"Dame un reporte ejecutivo del dia"

Herramientas

CommerceHub incluye 37 herramientas organizadas en 5 categorias:

Productos (9 herramientas)

Ordenes (8 herramientas)

Inventario (6 herramientas)

Clientes (6 herramientas)

Analytics (8 herramientas)

Recursos MCP (3)

Prompts Predefinidos (3)

Caracteristicas Tecnicas

• Multi-plataforma: Conecta simultaneamente a Shopify, WooCommerce, Stripe y MercadoLibre
• Cache inteligente: Cache LRU con TTL configurable para respuestas rapidas
• Rate limiting: Respeta los limites de cada API automaticamente
• Retry automatico: Reintentos con backoff exponencial para resiliencia
• Validacion estricta: Todos los inputs validados con Zod
• TypeScript strict: Tipado completo sin any
• Logs estructurados: Logging JSON con pino para observabilidad
• Extensible: Patron adaptador para agregar proveedores facilmente

Stack Tecnologico

Agregar un nuevo proveedor

CommerceHub usa el patron adaptador. Para agregar un nuevo proveedor:

1. Crea una carpeta en src/providers/tu-proveedor/
2. Implementa la clase extendiendo BaseProvider
3. Implementa el mapper para traducir datos
4. Registra el proveedor en server.ts

// src/providers/amazon/amazon.provider.ts
import { BaseProvider } from '../base.provider.js';

export class AmazonProvider extends BaseProvider {
  readonly name = 'amazon' as const;

  protected buildUrl(path: string): string {
    return `https://sellingpartnerapi.amazon.com${path}`;
  }

  protected buildHeaders(): Record<string, string> {
    return { Authorization: `Bearer ${this.config.accessToken}` };
  }

  // Implementar metodos...
}

Consulta docs/PROVIDERS.md para la guia completa.

Documentacion

Contribuir

1. Fork el repositorio
2. Crea tu rama: git checkout -b feature/mi-feature
3. Commit: git commit -m 'Agrega mi feature'
4. Push: git push origin feature/mi-feature
5. Crea un Pull Request

Licencia

MIT License - ver LICENSE para detalles.

npm install commercehub-mcp

{
  "mcpServers": {
    "commercehub": {
      "command": "npx",
      "args": ["commercehub-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "https://your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx"
      }
    }
  }
}