get_store_info nombre, plan, dominio
┌─ store.live ──────────────┐
│ │
│ products 86 │
│ orders 247 │
│ customers 423 │
│ revenue $12.4M │
│ │
│ ▌ ↑ +18% mom │
│ │
├─ top_seller ───────────────┤
│ │
│ camiseta_negra_L │
│ 47 uds · $1.84M │
│ ▤▤▤▤▤▤▤▤▤▤ 62% │
│ │
├─ stock_alert ──────────────┤
│ │
│ ⚠ bolso_lona 8u │
│ ⚠ pin_edt_lim 4u │
│ ⚠ stcks_pck 18u │
│ │
└────────────────────────────┘ Conecta Komercia con Claude y conversa con tu tienda como si le preguntaras a tu mejor vendedor. Respuestas reales, en segundos.
11 herramientas MCP. Todas de solo lectura.
get_store_info nombre, plan, dominio
export_products csv · json · shopify · woo
export_orders historial completo de ventas
export_customers contactos + direcciones
export_categories árbol de jerarquía
list_payment_gateways métodos configurados
export_inventory_movements movimientos de stock
export_theme_config colores, fuentes, tema
download_media_archive zip de imágenes
suggest_alternative_platforms plataformas para migrar
validate_komercia_apis health check de api
Así se ve en la práctica. 6 casos reales, datos reales.
Tres pasos. Cinco minutos. Sin código.
Inicia sesión con tus credenciales de Komercia. Token de solo lectura, válido 6 meses.
/sign-in →Elige uno. Claude Code es el más simple — un solo comando.
claude mcp add --transport sse komercia https://api-mcp.komercia.co/sse --header "Authorization: Bearer <TOKEN>" También funciona con Claude.ai, Claude Desktop y ChatGPT.
Abre un chat de Claude. Pregunta en lenguaje natural. Claude llama a las herramientas MCP y responde con tus datos reales.
¿Usas otro cliente? MCP funciona en:
¿Listo?
obtener_token →Es gratis. 30 segundos. Tú guardas el token.
Claude Code corre en tu terminal. Un solo comando registra el MCP y queda disponible en todas tus sesiones.
Instala Claude Code (si no lo tienes)
npm i -g @anthropic-ai/claude-code Registra el servidor MCP con tu token
claude mcp add --transport sse komercia \
https://api-mcp.komercia.co/sse \
--header "Authorization: Bearer TU_TOKEN" Verifica que quedó registrado
claude mcp list tip · Agrega --scope project al final para limitarlo a un solo proyecto en lugar de globalmente.
Funciona directamente en claude.ai. Sin instalar nada — solo pega la URL y tu token en la interfaz.
Abre Claude.ai → Configuración → Integraciones
Click en "Add custom integration" → "MCP Server"
Pega la URL del servidor
https://api-mcp.komercia.co/sse En Authorization pega: Bearer TU_TOKEN
Guarda y abre un chat nuevo
Claude Desktop usa stdio internamente. Necesitas el puente mcp-remote para conectarse a servidores http/sse.
Instala el puente mcp-remote
npm install -g mcp-remote Abre el archivo de configuración
# macOS
~/Library/Application Support/Claude/claude_desktop_config.json
# Windows
%APPDATA%\Claude\claude_desktop_config.json Agrega esta entrada dentro de "mcpServers"
{
"mcpServers": {
"komercia": {
"command": "mcp-remote",
"args": [
"https://api-mcp.komercia.co/sse",
"--header",
"Authorization: Bearer TU_TOKEN"
]
}
}
} Reinicia Claude Desktop
ChatGPT soporta conectores MCP remotos en planes Plus y Pro. Se configuran desde Settings → Connectors.
Abre ChatGPT → Settings → Connectors
Add custom connector → MCP Server
Pega la URL del servidor
https://api-mcp.komercia.co/sse Authentication: Bearer · pega tu token
Habilita el conector en cada chat donde lo necesites
tip · La interfaz puede variar — si no ves "Connectors", busca "Actions" o "Tools" dentro de Settings.
> ¿Cuál fue mi producto más vendido el mes pasado? Top 5 con totales.
export_ordersexport_products > Compara mis ventas de este mes vs el anterior. ¿Qué productos crecieron y cuáles cayeron?
export_ordersexport_products > ¿Quiénes son mis 10 mejores clientes por monto comprado en los últimos 6 meses?
export_customersexport_orders > ¿Qué método de pago usan más mis clientes? Dame el porcentaje por cada uno.
export_orderslist_payment_gateways > Identifica productos que venden bien pero tienen poco stock. Lista los que se van a quedar sin inventario en menos de 30 días.
export_productsexport_inventory_movements > Exporta todas las órdenes pagadas del último trimestre como CSV. Incluye nombre del cliente, ciudad, total y método de pago.
export_orders > Dame mi catálogo completo en formato Shopify, listo para importar.
export_products > Genera un JSON con todos mis clientes, sus direcciones y total comprado.
export_customersexport_orders > Resume mi inventario por categoría. Cuántos productos hay y cuál es el stock total de cada categoría.
export_categoriesexport_products > Backup completo de mi tienda en JSON: productos, órdenes, clientes, categorías, imágenes.
export_productsexport_ordersexport_customersexport_categoriesdownload_media_archive > Detecta productos sin imagen, sin descripción, o sin precio. Lista los que necesitan atención.
export_products > ¿Qué clientes me compraron más de una vez en los últimos 3 meses? Dame nombres y emails.
export_customersexport_orders > Productos creados o modificados este mes — ¿cuáles son?
export_products > ¿Cuántas órdenes hubo entre $100.000 y $500.000 COP el mes pasado? ¿Y promedio por método de pago?
export_orders > Prepara un export completo en formato Tiendanube, con productos, variantes, categorías y precios.
export_productsexport_categories > ¿A qué plataforma me conviene migrar mi tienda según mi catálogo y tipo de productos?
suggest_alternative_platformsget_store_infoexport_products > ¿Mis APIs de Komercia están funcionando? Hazme un health check.
validate_komercia_apis > Datos generales de mi tienda: nombre, plan, dominio, estado. Resúmemelo.
get_store_info