MCP Server de Karrito

#Que es el MCP Server

MCP (Model Context Protocol) es un estandar abierto que permite a herramientas de IA acceder a datos y ejecutar acciones en servicios externos. Karrito tiene su propio MCP server que te permite gestionar tu tienda completa directamente desde asistentes de IA como Claude, Cursor o Windsurf.

En lugar de abrir el panel de admin, puedes decirle a tu asistente "lista mis productos" o "crea un descuento VERANO20 del 15%" y el MCP se encarga del resto.

Version actual: karrito-mcp v2.0.0 — 25 tools + 5 resources.

#Instalacion

El MCP server se instala con un solo comando:

npx karrito-mcp

No necesitas clonar repositorios ni configurar nada manualmente. El paquete esta publicado en npm y se ejecuta directamente.

#Configurar en Claude Code

claude mcp add karrito -- npx karrito-mcp

Listo. Claude Code detecta el server automaticamente y puedes empezar a usarlo en tu siguiente conversacion.

#Configurar en Claude Desktop

Abre la configuracion de Claude Desktop y agrega el server en la seccion mcpServers:

{
  "mcpServers": {
    "karrito": {
      "command": "npx",
      "args": ["karrito-mcp"],
      "env": {
        "KARRITO_API_KEY": "krt_live_tu_api_key_aqui"
      }
    }
  }
}

#Configurar en Cursor

En tu settings.json de Cursor, agrega:

{
  "mcp.servers": {
    "karrito": {
      "command": "npx",
      "args": ["karrito-mcp"],
      "env": {
        "KARRITO_API_KEY": "krt_live_tu_api_key_aqui"
      }
    }
  }
}

Para Windsurf y otros editores compatibles con MCP, la configuracion es similar. Consulta la documentacion de tu editor para la ubicacion exacta del archivo de configuracion.

#Configurar tu API key

Para usar los tools que requieren autenticacion, necesitas una API key. Generala desde Admin > Cuenta > API Keys y exportala como variable de entorno:

export KARRITO_API_KEY=krt_live_tu_api_key_aqui

O incluyela directamente en la configuracion del MCP server (como se muestra en los ejemplos de Claude Desktop y Cursor arriba).

Tip: Nunca compartas tu API key ni la incluyas en repositorios publicos. Si crees que fue comprometida, rotala desde el panel de admin.

#Resources disponibles

Los resources son datos de solo lectura que el MCP expone al asistente de IA. No requieren autenticacion.

Resource	URI	Descripcion
Pricing	karrito://pricing	Planes, precios y comisiones de Karrito
Features	karrito://features	Lista completa de funcionalidades por plan
Niches	karrito://niches	50 nichos de mercado LATAM con descripcion detallada
Competitors	karrito://competitors	19 comparativas detalladas con competidores
Currencies	karrito://currencies	6 monedas soportadas con formato y simbolo

Estos resources permiten que el asistente responda preguntas como "que plan me conviene?" o "como se compara Karrito con Shopify?" sin necesidad de buscar en la web.

#Tools disponibles (25)

Los tools son acciones que el MCP puede ejecutar. Se agrupan por categoria.

#Publicos (sin API key)

Tool	Descripcion
search_catalogs	Buscar catalogos publicos por query
get_niche_info	Info de un nicho especifico (50 nichos disponibles)

#Tienda

Tool	Descripcion
get_my_store	Info de tu tienda (nombre, slug, moneda, stats)
update_store	Actualizar configuracion (nombre, WhatsApp, moneda, template, descripcion)
toggle_publish	Publicar o despublicar tu catalogo

#Productos

Tool	Descripcion
list_my_products	Listar productos con paginacion
create_product	Crear producto (nombre, precio, descripcion, categoria, imagen)
update_product	Actualizar producto (parcial)
delete_product	Eliminar producto (soft delete)

#Categorias

Tool	Descripcion
list_categories	Listar categorias
create_category	Crear categoria
update_category	Actualizar categoria
delete_category	Eliminar categoria

#Pedidos

Tool	Descripcion
list_my_orders	Listar pedidos con paginacion
get_order	Detalle de un pedido
update_order_status	Cambiar estado (pending, confirmed, shipped, delivered, cancelled)

#Descuentos

Tool	Descripcion
list_discounts	Listar descuentos
create_discount	Crear descuento (codigo, tipo, valor, fecha expiracion)
update_discount	Actualizar descuento
delete_discount	Eliminar descuento

#Resenas

Tool	Descripcion
list_reviews	Listar resenas (filtrar por estado)
moderate_review	Aprobar o rechazar resena
delete_review	Eliminar resena

#Clientes

Tool	Descripcion
list_customers	Listar clientes
get_customer	Detalle de cliente con historial

#Analytics

Tool	Descripcion
get_analytics	Estadisticas (ordenes, revenue, productos populares, conversion)

#Envios

Tool	Descripcion
list_shipping_options	Listar opciones de envio
create_shipping_option	Crear opcion de envio
update_shipping_option	Actualizar opcion de envio
delete_shipping_option	Eliminar opcion de envio

#Ejemplo de flujo completo

Una vez configurado, puedes interactuar con tu tienda de forma natural. Aqui un flujo real:

Tu: "Crea un descuento VERANO20 del 15% que expire en julio"

El asistente:

1. Llama a create_discount con codigo VERANO20, tipo percentage, valor 15, expiracion 2026-07-31
2. Te confirma: "Descuento VERANO20 creado. 15% de descuento, valido hasta el 31 de julio de 2026."

Mas ejemplos:

• "Lista mis productos" — llama a list_my_products y muestra la tabla
• "Crea un producto Camiseta Negra a $25 en la categoria Ropa" — llama a create_product
• "Cuantas ordenes tengo esta semana?" — llama a list_my_orders y filtra
• "Aprueba todas las resenas pendientes" — llama a list_reviews con filtro pending, luego moderate_review para cada una
• "Dame las estadisticas del mes" — llama a get_analytics
• "Despublica mi tienda" — llama a toggle_publish
• "Agrega envio express a $150 con entrega en 24h" — llama a create_shipping_option

El asistente combina los resources (para contexto) con los tools (para acciones) y te da respuestas completas sin que salgas de tu editor o terminal.

#Links

• npm: npmjs.com/package/karrito-mcp
• Repositorio: github.com/curetcore/karrito-mcp
• API REST: Introduccion a la API
• Blog: Gestiona tu tienda desde Claude, Cursor o cualquier IA