01 Qué es el Shopify AI Toolkit
Es el paquete oficial de Shopify para agentes de programación como Claude Code. Le da al agente tres capacidades: consultar la documentación y los esquemas de la API de Shopify, validar consultas GraphQL, plantillas Liquid y extensiones, y gestionar una tienda mediante la CLI de Shopify. La última es la que interesa a quien vende: Claude puede leer productos, pedidos o inventario y, si tú lo autorizas expresamente, modificarlos.
Documentación y esquemas
Claude trabaja con la referencia actual de Shopify en lugar de su memoria, lo que reduce errores con campos o APIs que han cambiado.
Validación de código
Comprueba GraphQL, Liquid y extensiones contra los esquemas antes de aplicar nada.
Gestión de la tienda
Ejecuta operaciones de la Admin API mediante la CLI, en el contexto autenticado de tu tienda y cuando tú lo decides.
02 Instalación
-
1
Comprueba Node.js
Ejecuta node --version. Necesitas la versión 18 o superior.
-
2
Instala el plugin
Es la vía recomendada: agrupa todo y se actualiza solo.
-
3
Instala la CLI de Shopify
Es la que ejecuta las operaciones sobre la tienda.
-
4
Reinicia Claude Code
Abre una sesión nueva para que cargue el plugin.
claude plugin install shopify-ai-toolkit@claude-plugins-official
npm install -g @shopify/cli@latestAlternativas: puedes instalar solo las skills con npx skills add Shopify/shopify-ai-toolkit (no se actualizan solas; usa npx skills update) o conectar únicamente el MCP de documentación, que no requiere autenticación pero tampoco toca tu tienda: claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest.
03 Conectar la tienda con permisos mínimos
La conexión se hace con shopify store auth, indicando la tienda y los permisos (scopes) de la Admin API. La regla es sencilla: empieza solo con lectura y amplía permisos cuando una tarea concreta lo requiera. Si el token caduca o necesitas más permisos, vuelves a ejecutar el comando.
shopify store auth --store mi-tienda.myshopify.com --scopes read_products,read_inventory,read_ordersDespués, Claude ejecuta las operaciones con shopify store execute. Las mutaciones (cualquier cambio de datos) están desactivadas por defecto: solo se ejecutan si se añade el flag --allow-mutations. Esa es tu barrera de seguridad, así que pide a Claude que te enseñe siempre el plan antes de usarlo.
04 Operaciones habituales con prompts
Revisa mi tienda mi-tienda.myshopify.com sin modificar nada. Quiero un informe con: productos sin imagen, sin descripción o con descripciones muy cortas; productos agotados o con menos de 5 unidades; productos que no pertenecen a ninguna colección; descuentos activos y su fecha de fin; pedidos pendientes de preparar con más de 48 horas. Ordena los hallazgos por impacto en ventas y propón una acción para cada uno.Quiero aplicar esta regla: [por ejemplo, subir un 8 % los productos de la colección Invierno y redondear a ,95]. Primero, solo lectura: genera una tabla con producto, variante, precio actual y precio nuevo para todos los afectados. Señala los casos raros (precio cero, subidas de más del 20 %). No ejecutes ninguna mutación hasta que yo escriba «aplicar». Cuando lo haga, aplica solo lo de la tabla y confírmame cuántas variantes se han actualizado.Lee los 20 productos más vendidos de los últimos 90 días. Para cada uno propón un título SEO de menos de 60 caracteres y una meta descripción de menos de 155, en español de España, sin inventar características que no aparezcan en la ficha. Preséntalo en una tabla con lo actual y lo propuesto. No cambies nada hasta que lo apruebe.- ✓Altas de productos en lote a partir de una lista o un CSV.
- ✓Avisos de stock bajo con propuesta de reposición.
- ✓Creación de códigos de descuento con fecha de caducidad.
- ✓Resumen semanal de pedidos, devoluciones y productos estrella.
- ✓Revisión de colecciones y etiquetas para ordenar el catálogo.
05 Buenas prácticas de seguridad
- ✓Empieza siempre en lectura y amplía permisos solo para la operación concreta.
- ✓Exige una tabla previa con el antes y el después de cada cambio.
- ✓Para cambios masivos, prueba primero con dos o tres productos.
- ✓Exporta productos o precios antes de una modificación grande para poder volver atrás.
- ✓No des permisos sobre clientes o pagos si la tarea no los necesita.
- ✓Escribe tus reglas (moneda, tono, redondeos, permisos) en el CLAUDE.md de la carpeta de trabajo.
Preguntas frecuentes
No para las tareas de gestión: hablas con Claude en español y él prepara las consultas. Sí conviene entender qué permisos concedes y revisar siempre las tablas previas.
Las mutaciones requieren el flag --allow-mutations y los permisos de escritura correspondientes. Si conectas solo con permisos de lectura, no puede modificar nada.
El MCP de documentación solo consulta la referencia de Shopify. El plugin incluye documentación, validación de código y la gestión de la tienda mediante la CLI.
Sí. Shopify publica instaladores para Codex, Cursor, VS Code y otros agentes; los pasos de conexión de la tienda son los mismos.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.