MCP Server de Karrito

#Qué 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.

Versión actual: karrito-mcp v4.1.0 — 34 tools + 5 resources.

#Instalación

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 automáticamente y puedes empezar a usarlo en tu siguiente conversación.

#Configurar en Claude Desktop

Abre la configuración de Claude Desktop y agrega el server en la sección 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 configuración es similar. Consulta la documentación de tu editor para la ubicación exacta del archivo de configuración.

#Configurar tu API key

Para usar los tools que requieren autenticación, 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 configuración 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 autenticación.

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

#Tools disponibles (34)

Los tools son acciones que el MCP puede ejecutar. Se agrupan por categoría.

#Publicos (sin API key)

#Tienda

#Tiendas (necesita llave de cuenta)

#Productos

#Categorías

#Pedidos

#Descuentos

#Reseñas

#Clientes

#Analytics

#Envíos

#Ejemplo de flujo completo

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

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

El asistente:

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

Más ejemplos:

• "Lista mis productos" — llama a list_my_products y muestra la tabla
• "Crea un producto Camiseta Negra a $25 en la categoría Ropa" — llama a create_product
• "¿Cuántas ordenes tengo esta semana?" — llama a list_my_orders y filtra
• "Aprueba todas las reseñas pendientes" — llama a list_reviews con filtro pending, luego moderate_review para cada una
• "Dame las estadísticas 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: Introducción a la API
• Blog: Gestiona tu tienda desde Claude, Cursor o cualquier IA