Shopify AI Toolkit: cómo manejar tu tienda completa con Claude Code o Cursor (guía paso a paso)

El 9 de abril de 2026, Shopify hizo algo que nadie esperaba tan rápido: publicó un plugin oficial, gratuito y de código abierto que conecta directamente tu editor de código con cualquier tienda Shopify real. Sin intermediarios. Sin copiar y pegar de la documentación. Con acceso en vivo a las APIs, validación de esquemas y la capacidad de ejecutar cambios en tu tienda desde Claude Code o Cursor.

Si tienes una tienda en Shopify o desarrollas para clientes que la usan, esto te cambia el workflow de forma seria.

¿Qué es el Shopify AI Toolkit?

El Shopify AI Toolkit es un plugin open source bajo licencia MIT que conecta a los agentes de IA con la plataforma Shopify. Básicamente le da a tu IA de programación acceso a:

• La documentación oficial de Shopify, consultada en tiempo real
• Los esquemas de las APIs (Admin GraphQL, Storefront, Functions)
• Validación de código Liquid, queries GraphQL y extensiones de UI
• Control de la tienda mediante el Shopify CLI

Salió el 9 de abril en el Shopify Dev Changelog y el repo ya tiene más de 100 stars en GitHub en sus primeros días.

Herramientas soportadas:

Herramienta	Plugin	Skills	MCP
Claude Code	Si	Si	Si
Cursor	Si (Marketplace)	Si	Si
Gemini CLI	Si	Si	Si
VS Code	Si (preview)	Si	Si
OpenAI Codex CLI	No	Si	Si

Por qué importa esto en México

México está en el top 3 de LATAM en adopción de Shopify, junto con Brasil y Argentina. Hay miles de tiendas locales que corren sobre la plataforma: ropa, calzado, electrónica, artesanías, cosméticos, comida. La mayoría con equipos técnicos pequeños o de una sola persona que tienen que lidiar con el Admin, el código y el soporte al mismo tiempo.

Este toolkit le da a esos devs acceso al mismo contexto que tiene un empleado de Shopify que conoce la plataforma de memoria, pero desde su editor. No más tabs abiertos con la documentación. No más queries GraphQL escritas a mano consultando Stack Overflow. El agente ya sabe qué puede y qué no puede hacer con la API.

Claude Code vs Cursor: ¿cuál usar para esto?

La pregunta natural si ya tienes uno de los dos. La respuesta corta: depende de tu flujo de trabajo.

Como explicamos en nuestra comparativa de Claude Code vs Cursor vs Copilot vs Windsurf, Claude Code es una herramienta de terminal que opera sobre tu repositorio completo con más autonomía. Cursor es un IDE completo con IA integrada.

Para el Shopify AI Toolkit, la diferencia práctica es:

Claude Code es mejor si:

• Eres dev y manejas el proyecto desde la terminal
• Quieres darle al agente control más autónomo sobre el codebase
• Usas Hydrogen (el framework headless de Shopify) o desarrollas apps

Cursor es mejor si:

• Prefieres trabajar en un IDE con autocompletado visual
• Eres menos técnico y necesitas ver el código mientras el agente trabaja
• Instalas todo con un clic desde el Marketplace

Los dos tienen acceso a las mismas 16 skills y el mismo servidor MCP. No hay diferencia funcional en lo que pueden hacer con la tienda.

Instalación paso a paso con Claude Code

El método recomendado es el plugin, porque se actualiza solo:

1. Abre Claude Code en tu proyecto
2. Escribe en el chat:

/plugin marketplace add Shopify/shopify-ai-toolkit

3. Luego ejecuta:

/plugin install shopify-plugin@shopify-ai-toolkit

Listo. Claude Code ya tiene acceso a la documentación de Shopify, los esquemas de la API y las skills para ejecutar cambios en la tienda.

Si prefieres el servidor MCP local (sin autenticación de tienda, solo para desarrollo):

claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest

Necesitas Node.js 18 o superior.

Instalación con Cursor

Aún más sencillo:

1. Abre Cursor
2. Ve al Marketplace (panel lateral)
3. Busca “Shopify”
4. Clic en instalar

Si prefieres la ruta MCP manual, agrega esto a tu configuración JSON de MCPs en Cursor:

{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"]
    }
  }
}

Las 16 skills: las que más te van a servir

El toolkit tiene 16 skills especializadas. Las más relevantes para el día a día:

• shopify-admin-execution: ejecuta cambios en la tienda (productos, inventario, configuración) sin tocar el Admin panel
• shopify-admin: acceso a toda la GraphQL Admin API
• shopify-functions: personalización del checkout
• shopify-liquid: validación de templates Liquid
• shopify-hydrogen: para tiendas headless con el framework de Shopify
• shopify-storefront-api: para queries al storefront desde apps o frontends custom

Puedes instalar todas de un jalón:

npx skills add Shopify/shopify-ai-toolkit

O solo una específica si no necesitas todo:

npx skills add Shopify/shopify-ai-toolkit --skill shopify-admin

Si te interesa explorar el ecosistema de herramientas MCP más a fondo, tenemos una guía completa para correr tu propia IA local con Ollama y LM Studio donde explicamos cómo funciona el protocolo por debajo.

Casos de uso concretos para tiendas mexicanas

Esto no es teoría. Aquí lo que puedes hacer hoy con el toolkit instalado:

Gestión de catálogo masiva: tienes 500 productos y necesitas actualizar las descripciones para una temporada nueva. Le pides a Claude Code que lea el catálogo, reescriba las descripciones con un tono específico y las suba via la Admin API. Lo que antes tomaba horas, en minutos.

Validar que tu Liquid no tiene errores antes de publicar: el agente valida tus templates contra el esquema real de Shopify, no solo contra lo que tú recuerdas de la documentación.

Personalizar el checkout: con la skill de Shopify Functions puedes pedirle al agente que te construya reglas de descuento, validaciones de envío a ciertas regiones (muy útil para zonas donde Shopify Payments no está disponible y necesitas lógica custom) o restricciones de productos.

Debuguear queries GraphQL sin sufrir: solo le dices qué datos necesitas y el agente escribe y valida la query contra el esquema real de la API.

Construir apps de Shopify: si estás desarrollando una app para publicar en el App Store de Shopify, el agente ya conoce los patrones de autenticación OAuth, los webhooks disponibles y los límites de la API.

El pedo que nadie te dice: sin undo

Ojo con esto porque es importante y la mayoría de los posts que encontré no lo mencionan: la skill shopify-admin-execution, la que ejecuta cambios en tu tienda, no tiene mecanismo de reversión. Los cambios son permanentes al momento de ejecutarse.

No hay modo preview, no hay staging, no hay rollback automático.

La recomendación obvia pero necesaria: siempre prueba primero en una tienda de desarrollo antes de soltar el agente en producción. Shopify te da tiendas de desarrollo gratuitas si tienes cuenta de Partners. Úsalas. Aprende el comportamiento del agente antes de darle acceso a la tienda real de tu cliente.

Gratis, open source y ya funciona

El Shopify AI Toolkit no tiene costo. Es MIT. El único gasto es lo que ya pagas por Claude Pro, Cursor o el plan de Shopify que ya tengas.

Lo interesante de esto no es solo el toolkit en sí. Es lo que señala: las plataformas de e-commerce ya están construyendo con la asunción de que vas a tener un agente de IA en tu workflow. Shopify no está esperando a ver qué pasa con la IA. Está empujando para que sus devs adopten estas herramientas ahora.

Si manejas una tienda en México o desarrollas para clientes que la usan, instalar esto hoy no te cuesta nada y te ahorra tiempo real desde la primera sesión de trabajo.

¿Ya lo probaste? ¿Qué skill te parece más útil para el contexto mexicano? Cuéntanos abajo.

Fuentes

• GitHub: Shopify/shopify-ai-toolkit
• Shopify Dev Changelog: AI Toolkit Launch
• Documentación oficial del Shopify AI Toolkit
• Weaverse Blog: Shopify AI Toolkit, Dev MCP & Hydrogen 2026
• Power Commerce: Shopify AI Toolkit Released
• Tenten.co: What It Actually Does & How to Install It