Shopify AI Toolkit con Claude Code: programa tu tienda con un agente de IA

Si desarrollas para Shopify, sabes que una parte del tiempo se va en buscar en la documentación: qué campo tiene tal objeto de la Admin API, qué versión de API usar, por qué falla tu consulta GraphQL. El Shopify AI Toolkit ataca justo eso: le da a tu agente de IA acceso directo a la información oficial de Shopify para que trabaje con datos actuales y no con lo que recuerda de su entrenamiento.

En la Spring ‘26 Edition (17 de junio de 2026) Shopify anunció que el toolkit ya está disponible de forma general (GA): un plugin que le da a tu editor (Cursor, Claude Code, Codex, VS Code y otros) acceso directo a las guías de referencia de Shopify, a datos de la tienda y a herramientas de administración. Aquí te muestro cómo usarlo con este último.

¿Qué incluye?

Según la documentación de Shopify en shopify.dev, el toolkit conecta a tu agente con:

• Documentación y esquemas de las APIs, siempre actualizados.
• Validación de código: revisa consultas GraphQL, plantillas Liquid y extensiones contra los esquemas de Shopify.
• Gestión de tienda: prepara y ejecuta tareas de administración compatibles a través del contexto autenticado de Shopify CLI, y tú decides cuándo se ejecutan.

Según Shopify, el toolkit agrupa un conjunto de skills junto con Shopify CLI: los skills le enseñan al agente cómo construir y la CLI ejecuta los comandos correspondientes.

Requisitos

• Node.js 18 o superior.
• Una herramienta de IA compatible. Claude Code es una de ellas; la documentación también lista Codex, Antigravity CLI, Cursor y Visual Studio Code, entre otras.
• Claude Code instalado.

Instalación

La forma recomendada es como plugin: reúne todo en una sola instalación y se actualiza automáticamente cuando salen nuevas capacidades. En tu terminal:

claude plugin install shopify-ai-toolkit@claude-plugins-official

Si tu herramienta no soporta plugins, o prefieres administrar los skills tú mismo, puedes instalar el skill shopify, que cubre todas las superficies de desarrollo (Admin GraphQL API, Shopify Functions, Polaris, Liquid, Hydrogen y Shopify CLI):

npx skills add Shopify/shopify-ai-toolkit

Ojo: instalado así no se actualiza solo; para tener las versiones más recientes corre npx skills update. Además, los skills individuales de versiones anteriores (shopify-admin, shopify-liquid, etc.) están deprecados y ya no reciben actualizaciones; si los tenías, Shopify recomienda quitarlos y usar el skill shopify.

La tercera opción es MCP, con el Dev MCP server de Shopify, que corre de forma local y no requiere autenticación:

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

Después de cualquiera de las dos, reinicia Claude Code para que cargue la configuración. Si quieres entender qué hace ese comando, lo explico en cómo conectar servidores MCP a Claude Code.

Qué puedes pedirle

Con el toolkit instalado, tu herramienta consulta automáticamente los recursos de desarrollo de Shopify cuando le haces preguntas sobre Shopify. Algunos ejemplos que Shopify da en su documentación:

• “Usa Shopify CLI para crear una nueva app de Shopify.”
• “Explícame qué son las superficies de las apps de Shopify y ayúdame a elegir la correcta.”
• “Explora las APIs de Shopify y encuentra la adecuada para mi caso.”
• “Revisa mi app contra los requisitos del App Store de Shopify.”

Ejemplo: migrar extensiones

Shopify destaca un caso concreto: las extensiones de checkout y de cuentas de cliente que usan versiones de API anteriores a 2025-10 deben adoptar los componentes web de Polaris al pasar a versiones más nuevas. Esa migración implica tareas repetitivas y llenas de detalles, como actualizar la versión de API en shopify.extension.toml, convertir código de React a Preact donde se requiera, reemplazar componentes antiguos por componentes web de Polaris y actualizar las importaciones. Con el toolkit puedes pedirle al agente algo como:

Migra la extensión extensions/my-checkout-extension a la versión de API 2026-04.

Shopify aclara que el toolkit no elimina la necesidad de revisar y probar el resultado: automatiza la mayor parte del trabajo para que dediques más tiempo a validar el comportamiento y preparar la extensión para publicarla.

Flujo de trabajo que recomiendo

1. Empieza por el problema, no por el código. Descríbele qué quieres lograr (por ejemplo, “mostrar un metafield en la ficha de producto”) y deja que consulte la documentación.
2. Pídele que valide antes de darla por buena. El toolkit valida consultas GraphQL, plantillas Liquid y extensiones contra los esquemas de Shopify para detectar problemas antes; aprovéchalo.
3. Revisa el diff. Sea cual sea el agente, tú eres quien despliega. Lee lo que cambió en tu tema o tu app antes de publicar.
4. Trabaja primero en una tienda de desarrollo o un tema duplicado. Sobre todo cuando le des acceso a herramientas que modifican datos de la tienda.

Cuidado con el acceso a la tienda

La parte de gestión de tienda usa el contexto autenticado de Shopify CLI, así que puede tocar datos reales. Shopify indica que tú eliges cuándo se ejecutan esas tareas. Mi recomendación, que es un consejo mío y no algo que exija la documentación, es experimentar primero en una tienda de desarrollo y revisar cada comando que modifique datos antes de aprobarlo.

Conclusión

El AI Toolkit no reemplaza saber Shopify: le da a tu agente documentación y esquemas actuales y validación de código, y la responsabilidad de revisar y probar sigue siendo tuya. Si ya usas Claude Code, instalarlo es un solo comando.

Fuentes

• Shopify AI Toolkit (shopify.dev)
• Agentic commerce for every developer: The Spring ‘26 Edition