Shopify

Conectar Shopify AI Toolkit a Claude Code desde Claude Desktop

Conecta el AI Toolkit oficial de Shopify a Claude Code directamente desde la app de Claude Desktop — sin tocar la terminal. Accede a la documentación actualizada de Shopify, valida código contra los esquemas de la API y ejecuta operaciones en tu tienda.

3 de mayo de 20255 min read
ShopifyClaude DesktopMCPAutomatización

Qué vas a lograr: Conectar el AI Toolkit oficial de Shopify a Claude Code directamente desde la app de Claude Desktop — sin tocar la terminal. Le pasas el repo a Claude desde la pestaña Code, y él se encarga de instalar y configurar todo. Una vez conectado, Claude tendrá acceso a la documentación actualizada de Shopify, validación de código contra los esquemas de la API, y la capacidad de ejecutar operaciones en tu tienda.

Requisitos previos

  • Claude Desktop instalado en tu Mac o PC (descárgalo aquí si aún no lo tienes)
  • Node.js 18 o superior instalado en tu sistema (Claude lo verifica por ti, pero si te falta lo puedes descargar en nodejs.org)
  • Una tienda Shopify activa o de desarrollo (sólo si vas a ejecutar operaciones)

Paso 1 — Abre Claude Desktop y ve a la pestaña Code

Abre la app de Claude Desktop, selecciona la pestaña Code en el menú lateral, e inicia una nueva sesión.

A partir de aquí, todo se hace conversando con Claude — sin terminal, sin comandos manuales.

Paso 2 — Pásale el repo a Claude

Copia y pega este prompt en la sesión de Code:

Quiero conectar el Shopify AI Toolkit oficial a esta sesión de Claude Code. El repositorio está en: https://github.com/Shopify/Shopify-AI-Toolkit

Por favor:

  1. Revisa el repo y entiende qué hace el plugin
  2. Verifica que tengo los requisitos (Node.js 18+)
  3. Instala el plugin usando el método recomendado de Shopify
  4. Una vez instalado, hazme una prueba para confirmar que el toolkit está activo (por ejemplo, búscame la mutación GraphQL para actualizar el título de un producto en la Admin API)
  5. Avísame si necesitas que autorice algún paso

Claude leerá el repositorio, identificará el método de instalación recomendado y ejecutará el proceso por ti dentro de la app.

Paso 3 — Autoriza las acciones cuando Claude las pida

Durante la instalación, Claude te pedirá permiso para ejecutar ciertas acciones. En la pestaña Code verás botones para Aprobar o Rechazar cada una.

ℹ️

Lee qué te está pidiendo antes de aprobar. Para esta instalación, todas las acciones son seguras — son lecturas del repo de Shopify y comandos /plugin estándar.

Paso 4 — Confirma que funciona

Cuando Claude termine, te devolverá una respuesta con la mutation GraphQL real validada contra el schema actual de Shopify — no inventada desde su training data.

Si ves algo como esto, todo está bien:

mutation productUpdate($input: ProductInput!) {
  productUpdate(input: $input) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}

A partir de aquí, cualquier pregunta sobre Shopify que le hagas a Claude en la pestaña Code va a usar el toolkit automáticamente.

Paso 5 — Conectar tu tienda (opcional)

Si sólo quieres usar el toolkit para documentación y validación de código, ya terminaste.

Si quieres que Claude ejecute operaciones reales en tu tienda (crear productos, modificar themes, gestionar metafields), simplemente pídeselo:

Quiero que también puedas ejecutar operaciones en mi tienda Shopify. Ayúdame a configurar Shopify CLI y autenticar mi tienda de desarrollo.

Claude te guiará paso a paso desde la misma ventana — incluso puede abrir la URL de autenticación de Shopify en tu navegador cuando sea necesario.

Cosas importantes que debes saber

No hay borrador ni deshacer

Las operaciones en tienda se ejecutan inmediatamente sobre tu Shopify en vivo. No hay preview, no hay draft, no hay deshacer.

⚠️

Antes de pedirle a Claude que ejecute mutations, dile: "primero muéstrame qué vas a hacer y espera mi confirmación". Siempre prueba en una tienda de desarrollo antes de tocar producción.

Telemetría activada por defecto

Por defecto, las validaciones envían tu código a Shopify. Si trabajas con código propietario o de cliente:

ℹ️

Antes de instalar el toolkit, indícale a Claude: "Configura OPT_OUT_INSTRUMENTATION=true para que mi código no se envíe en las validaciones."

El plugin queda instalado entre sesiones

Una vez instalado, el toolkit queda disponible en futuras sesiones de Code dentro de Claude Desktop. No necesitas reinstalarlo cada vez.

Casos de uso típicos

Una vez conectado, le puedes pedir cosas como:

  • "Genérame la mutation para crear un producto con variantes y metafields"
  • "Crea una theme section de testimonios con los slots correctos de Liquid"
  • "Scaffold una app de Shopify embebida con Remix"
  • "Valida este código contra el schema actual de la Admin API"
  • "Configúrame la estructura de metafields para un catálogo de hoteles"

Recursos

Si algo falla

Si Claude tiene algún problema durante la instalación, dile en la misma ventana:

No funcionó. Diagnostica qué pasó, revisa los logs y propón una solución.

Claude tiene contexto de toda la sesión y puede leer archivos de configuración, revisar la versión de Node, y reintentar la instalación con un método alternativo si es necesario.

Guía creada por Goran AI · goranai.mx