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.
16 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
lookup_komercia_store busca cualquier tienda
export_store_snapshot backup total · 10 endpoints
export_blog_posts posts en json o markdown
get_store_marketing_setup ga · gtm · pixel · ids
browse_komercia_store_products productos públicos de cualquier tienda
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 pegar token — OAuth maneja la autorización automáticamente.
Abre Claude.ai → Settings → Connectors
Click "Add Integration" → "MCP Server" y pega esta URL
https://api-mcp.komercia.co/sse Click Connect → te llevará al login → autoriza acceso
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.
Navegador detectado: —
Firefox no soporta instalar PWA en desktop. Abre este sitio en Chrome, Edge, Brave o Safari para instalarlo como app.
En la barra de direcciones, haz click en el ícono de instalar ⊕ del lado derecho
O abre el menú (⋮) → "Instalar Komercia MCP"
La app se abre en su propia ventana con el ícono de Komercia en tu Dock
Abre el menú Archivo (File)
Haz click en "Añadir al Dock…" / "Add to Dock…"
Confirma. La app aparece en el Dock y en Launchpad
En la barra de direcciones, haz click en el ícono de instalar ⊕ del lado derecho
O abre el menú (⋮) → "Instalar Komercia MCP"
La app se abre en su propia ventana con un acceso directo en el menú Inicio
Pulsa el botón Compartir (cuadrado con flecha hacia arriba)
Desplázate y pulsa "Añadir a pantalla de inicio" / "Add to Home Screen"
Confirma. La app aparece en tu pantalla de inicio
Pulsa el menú (⋮) en la esquina superior derecha
Pulsa "Instalar app" o "Añadir a pantalla de inicio"
Confirma. El ícono de la app aparece en tu pantalla de inicio
En la barra de direcciones, haz click en el ícono de instalar ⊕ del lado derecho
O abre el menú (⋮) → "Instalar Komercia MCP"
La app se lanza como ventana propia vía tu entorno de escritorio
> ¿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 > Necesito un backup completo de mi tienda antes que cierre Komercia. Guárdame todo lo que puedas.
export_store_snapshot > Verifica que altatekmarket.com es mi tienda y dame su info pública.
lookup_komercia_storeget_store_info > Exporta todos los posts de mi blog en Markdown para subirlos a Ghost.
export_blog_posts > Lista los productos publicados de la tienda altatekmarket.com — quiero comparar precios con mi catálogo.
browse_komercia_store_products