MCP WooCommerce MCP Server

MCP WooCommerce

Servidor MCP + Bot de Telegram para gestionar tu tienda WooCommerce con IA.

Dos modos de uso:

• MCP Server — Conectá directamente desde Claude Desktop o Claude Code
• Bot de Telegram — Gestioná tu tienda desde Telegram con lenguaje natural y voz

Features

• 13 herramientas para gestionar productos, pedidos, clientes y reportes
• Dual LLM — Un modelo para consultas (rápido/barato) y otro para edición (preciso)
• Soporte de voz — Enviá audios por Telegram, se transcriben con Whisper
• Multi-proveedor — Soporta Claude, OpenAI (GPT) y Gemini como LLM
• Deploy en Cloudflare Workers — Gratis, siempre activo, sin servidor

Herramientas disponibles

Requisitos previos

• Node.js 18+
• Cuenta de WooCommerce con API REST habilitada
• Para Telegram: Bot token de @BotFather
• Para deploy: Cuenta de Cloudflare (gratis)
• API key de al menos un proveedor LLM (OpenAI, Anthropic o Google)

Instalación

git clone https://github.com/tu-usuario/mcp-woocommerce.git
cd mcp-woocommerce
npm install

Obtener credenciales de WooCommerce

1. En tu panel de WordPress: WooCommerce → Ajustes → Avanzado → REST API
2. Click en "Agregar clave"
3. Descripción: MCP Bot
4. Permisos: Lectura/Escritura
5. Click en "Generar clave API"
6. Guardá el Consumer Key (ck_...) y Consumer Secret (cs_...)

Modo 1: MCP Server (Claude Desktop / Claude Code)

Conectá las herramientas de WooCommerce directamente a Claude sin intermediarios.

Configuración en Claude Desktop

Editá tu archivo de configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": ["tsx", "src/mcp-server.ts"],
      "cwd": "/ruta/a/mcp-woocommerce",
      "env": {
        "WC_URL": "https://tu-tienda.com",
        "WC_CONSUMER_KEY": "ck_xxxxxxxxxxxxxxxxxxxxx",
        "WC_CONSUMER_SECRET": "cs_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Configuración en Claude Code

claude mcp add woocommerce \
  -e WC_URL=https://tu-tienda.com \
  -e WC_CONSUMER_KEY=ck_xxxxxxxxxxxxxxxxxxxxx \
  -e WC_CONSUMER_SECRET=cs_xxxxxxxxxxxxxxxxxxxxx \
  -- npx tsx src/mcp-server.ts

Probar localmente

WC_URL=https://tu-tienda.com \
WC_CONSUMER_KEY=ck_xxx \
WC_CONSUMER_SECRET=cs_xxx \
npm run mcp

Modo 2: Bot de Telegram

Bot interactivo que responde mensajes de texto y voz usando IA.

Arquitectura

Telegram (vos) → Cloudflare Worker (webhook) → LLM (tool calling) → WooCommerce API
       ← respuesta formateada ← datos/confirmación ←

Crear bot de Telegram

1. Abrí @BotFather en Telegram
2. Enviá /newbot y seguí las instrucciones
3. Guardá el token que te da
4. Mandá un mensaje a tu bot nuevo (un "hola")
5. Visitá https://api.telegram.org/bot<TOKEN>/getUpdates para obtener tu Chat ID

Variables de entorno

Copiá el archivo de ejemplo:

cp .dev.vars.example .dev.vars

Editá .dev.vars con tus credenciales:

# Telegram
TELEGRAM_BOT_TOKEN=tu-token
TELEGRAM_CHAT_ID=tu-chat-id

# WooCommerce
WC_URL=https://tu-tienda.com
WC_CONSUMER_KEY=ck_xxx
WC_CONSUMER_SECRET=cs_xxx

# LLM - Modo simple (un solo proveedor)
LLM_PROVIDER=openai
LLM_API_KEY=sk-xxx

# LLM - Modo dual (recomendado)
LLM_QUERY_PROVIDER=openai      # Para consultas: rápido y barato
LLM_QUERY_API_KEY=sk-xxx
LLM_EDIT_PROVIDER=claude       # Para edición: preciso y confiable
LLM_EDIT_API_KEY=sk-ant-xxx

Sistema Dual LLM

El bot puede usar dos LLMs diferentes según el tipo de operación:

El routing es automático: detecta si tu mensaje contiene palabras como "crear", "editar", "cambiar precio", etc.

Si configurás solo LLM_PROVIDER y LLM_API_KEY, usa un único modelo para todo.

Soporte de voz (Whisper)

Enviá un mensaje de voz a