Proceso

Cómo gobernar toda su tienda Shopify desde Claude Code: guía de configuración para un comerciante no técnico

Guía paso a paso para que los responsables de una tienda Shopify configuren Claude Code con la Shopify CLI, el Shopify Dev MCP, Nano Banana para imágenes con IA y Google Search Console, y ejecuten actualizaciones de producto, correcciones de SEO y generación de imágenes de forma autónoma.

8 de abril de 2026

Terminal mostrando comandos claude mcp add conectados a un escaparate Shopify

Si lleva una tienda Shopify y ha estado mirando la conversación de la IA desde la barrera preguntándose cuándo se vuelve útil de verdad para usted —no para los desarrolladores, no para un «yo futuro que aprende a programar», sino para el operador real que actualiza productos y redacta descripciones un martes por la tarde— ese momento es ahora.

En los últimos seis meses, han ocurrido tres cosas al mismo tiempo:

Claude Code, de Anthropic (la herramienta de terminal que permite a Claude hacer cosas en su ordenador en lugar de solo hablar de ellas), se ha vuelto lo bastante estable para usarla con seguridad sin ser desarrollador.
Shopify ha publicado un servidor MCP de desarrollo oficial que le da a Claude acceso en vivo a la documentación, los esquemas GraphQL y las buenas prácticas de la API de Shopify.
El ecosistema MCP ha explotado: hay servidores comunitarios para gestionar su tienda Shopify, generar imágenes con Nano Banana de Google, traer datos de Google Search Console, publicar en Klaviyo y un centenar de cosas más, todos hablando el mismo protocolo.

Conéctelos y obtiene una configuración en la que puede escribir «encuentra los 20 productos con el CTR más bajo en Search Console, reescribe sus metadescripciones, genera nuevas imágenes hero de estilo de vida para los 5 mejores y deja todo en borrador para que lo revise antes de publicar» y marcharse mientras se ejecuta.

Esta guía le lleva de cero software instalado a ese flujo exacto. Está escrita para un comerciante Shopify cómodo copiando y pegando comandos pero que no programa. Tiempo total de configuración: unos 60-90 minutos la primera vez. Después, cada nueva automatización lleva minutos.

Qué tendrá al final

Al terminar esta guía tendrá Claude Code corriendo en su ordenador con cuatro superpoderes conectados:

Shopify Dev MCP: documentación oficial de Shopify y conocimiento de la API integrados, para que Claude nunca invente campos falsos ni sintaxis obsoleta.
Un MCP de gestión de tienda Shopify: control real sobre productos, pedidos, clientes, colecciones e imágenes de su tienda en vivo.
Nano Banana MCP: generación y edición de imágenes con Google Gemini (el mismo modelo detrás de algunas de las mejores fotografías de producto con IA que ha visto este año).
Google Search Console MCP: datos SEO en vivo que Claude puede leer y aplicar sin que usted exporte CSV.

Ese es el bucle completo: ver qué falla, arreglarlo, generar los activos, publicarlos en Shopify y verificar en Search Console. Todo desde una sola ventana de chat.

Por qué importa ahora mismo (contexto de abril de 2026)

Algunas cosas que conviene saber antes de empezar, porque el panorama ha cambiado en el último trimestre y la mayoría de los tutoriales online están desactualizados:

Desde el 1 de enero de 2026, las nuevas apps de Shopify se crean en el Dev Dashboard y usan credenciales OAuth (un client ID y un secret) en lugar de los antiguos tokens estáticos shpat_. Si ha seguido un tutorial antiguo y le indica copiar un token shpat_xxxxx, solo funcionará para apps personalizadas legadas. Las nuevas instalaciones usan pares clientId/clientSecret, y el servidor MCP las intercambia por tokens de corta duración de forma automática.
La versión por defecto de la API de Shopify a la que apuntan la mayoría de los MCP es 2026-01. Cualquier tutorial que mencione 2024-04 o anterior está obsoleto.
Nano Banana 2 (Gemini 3.1 Flash Image) es ya el predeterminado para la mayoría de los MCP de imagen: ofrece calidad de nivel Pro a velocidad de Flash y cuesta aproximadamente 0,04-0,05 $ por imagen en resolución estándar, escalando hasta unos 0,15 $ por imagen en 4K.
Hay dos MCP de Shopify y hacen cosas distintas. El Shopify Dev MCP es una herramienta de desarrollo que se ejecuta localmente y da acceso a la documentación y los esquemas de la API de Shopify. No controla su tienda. Para acciones reales (crear productos, actualizar precios, gestionar colecciones) necesita un MCP comunitario separado. Instalaremos los dos.

¿Lo tiene? Bien. Vamos a la configuración.

Paso 1: instalar la base (Node.js y Claude Code)

Necesita Node.js 18 o superior para casi todo este stack. Si no lo ha instalado nunca:

Vaya a nodejs.org y descargue la versión LTS para su sistema operativo.
Ejecute el instalador con la configuración por defecto.
Abra Terminal (Mac) o Command Prompt / PowerShell (Windows) y escriba node --version. Debería ver algo como v20.x.x o superior.

A continuación, instale Claude Code:

npm install -g @anthropic-ai/claude-code

Luego ejecútelo una vez para iniciar sesión:

claude

Abrirá un navegador, le pedirá iniciar sesión en su cuenta de Anthropic y volverá a la terminal con una sesión de Claude Code en marcha. Escriba /exit para salir por ahora.

Aviso: Claude Code en Windows puede ser caprichoso con los servidores MCP; muchos servidores comunitarios asumen rutas de Mac/Linux. Si está en Windows y es su primera vez, el camino más suave es instalar WSL2 (Windows Subsystem for Linux) y ejecutar todo desde dentro de Ubuntu. Lleva 15 minutos extra y le ahorra horas de depuración.

Paso 2: instalar la Shopify CLI

La Shopify CLI es la herramienta de línea de comandos oficial para trabajar con temas, apps y datos de la tienda. Claude Code la usará por debajo.

npm install -g @shopify/cli@latest

Verifíquelo con shopify version: debería ver un número de versión. Si quiere iniciar sesión en su tienda ahora (opcional pero útil), ejecute shopify auth login y siga el prompt del navegador.

Paso 3: añadir el Shopify Dev MCP oficial

Este es el que da a Claude acceso a la documentación de Shopify, los esquemas GraphQL y la validación de código. No necesita autenticación y se ejecuta enteramente en su máquina.

claude mcp add --scope user shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest

Listo. Reinicie Claude Code (/exit y luego claude de nuevo) y podrá preguntarle al instante cosas como:

«Muéstrame la mutación GraphQL para actualizar el metafield de un producto en la versión de API 2026-01».
«¿Qué scopes necesita mi app para leer pedidos en borrador?».

El Dev MCP incluye una herramienta llamada learn_shopify_api que debe llamarse antes que cualquier otra herramienta de Shopify en una conversación dada: genera un conversationId que las demás necesitan. Claude lo sabe y la llamará automáticamente. Usted no tiene que pensar en ello.

Paso 4: añadir un MCP de gestión de tienda Shopify

Este es el MCP que de verdad hace cosas en su tienda: crea productos, actualiza inventario, procesa pedidos, gestiona colecciones. Hay dos rutas principales.

Opción A: MCP comunitario (gratis, más configuración)

La opción open source más popular es shopify-mcp de GeLi2001. Es un paquete de Node, se ejecuta localmente y admite tanto los tokens de acceso heredados como las nuevas credenciales OAuth.

Para nuevas apps de Shopify (posteriores a enero de 2026):

Desde el admin de Shopify, vaya a Settings > Apps and sales channels > Develop apps (o al nuevo Dev Dashboard si su tienda lo tiene habilitado).
Cree una app personalizada, configure los scopes de API que quiera dar a Claude (empiece con poco: read_products, write_products, read_orders es un trío sensato) y copie el Client ID y el Client Secret.
Añada el MCP a Claude Code:

claude mcp add shopify -- npx shopify-mcp \
  --clientId YOUR_CLIENT_ID \
  --clientSecret YOUR_CLIENT_SECRET \
  --domain your-store.myshopify.com

El servidor intercambiará esas credenciales por tokens de corta duración (válidos durante unas 24 horas) automáticamente.

Para apps personalizadas heredadas con un token estático shpat_:

claude mcp add shopify -- npx shopify-mcp \
  --accessToken YOUR_ACCESS_TOKEN \
  --domain your-store.myshopify.com

Importante: asegúrese de estar instalando shopify-mcp y no shopify-mcp-server. Son paquetes distintos con nombres de argumentos diferentes y confundirlos provoca errores.

Opción B: Composio (de pago, casi sin configuración)

Si los comandos de terminal le dan urticaria, Composio ofrece un MCP hospedado que se encarga de todo el OAuth por usted. Inicia sesión una vez en composio.dev, conecta su tienda Shopify desde su UI y le entregan una URL de MCP que añadir a Claude Code. Cuesta dinero, pero ahorra alrededor de una hora de configuración. Para comerciantes con varias tiendas o que no quieren gestionar credenciales, compensa.

En cualquier caso, reinicie Claude Code tras añadir el servidor. Verifíquelo con claude mcp list.

Paso 5: añadir Nano Banana para generación de imágenes con IA

Nano Banana es el nombre amigable de los modelos de generación de imágenes Gemini de Google. Nano Banana 2 (Gemini 3.1 Flash Image) es el predeterminado actual: ofrece salida apta para 4K, consistencia de personaje entre varias generaciones y renderizado de texto nítido dentro de las imágenes, que es la parte que por fin hace utilizable la IA para fotografía de producto real.

Necesitará primero una clave de API de Gemini. Vaya a Google AI Studio (aistudio.google.com), inicie sesión con su cuenta de Google y cree una API key. La generación de imágenes requiere activar facturación: los modelos de texto son gratuitos, pero la generación de imágenes es de pago por uso. No hay mínimo mensual.

Después añada el MCP:

claude mcp add nano-banana \
  --env GEMINI_API_KEY=your_api_key_here \
  -- npx @rafarafarafa/nano-banana-pro-mcp

Reinicie Claude Code y ya podrá pedirle cosas como:

«Genera una imagen hero para la nueva colección de cortinas de lino: luz matinal natural entrando por una ventana, salón escandinavo, tonos beige suaves, ratio 16:9, 4K».
«Coge esta foto de producto y edítala para mostrar la cortina sobre un color de pared distinto».

El MCP admite texto a imagen, edición imagen a imagen e imágenes de referencia para transferir estilo. Expectativa de coste para una tienda en activo: generar 50-100 imágenes al mes para variantes de producto, fotos de estilo de vida y banners hero cuesta aproximadamente 5-15 $.

Paso 6: añadir el MCP de Google Search Console

Aquí se cierra el bucle del SEO. Con Claude Code leyendo sus datos en vivo de Search Console, puede identificar páginas con bajo rendimiento, proponer correcciones, aplicarlas en sus productos y tema de Shopify y volver a enviar URLs para indexar, todo en una sola sesión.

La opción mejor mantenida es mcp-gsc de AminForou. Si tiene uvx instalado (el equivalente Python de npx), la configuración más sencilla es:

claude mcp add gsc -- uvx --from git+https://github.com/AminForou/mcp-gsc mcp-gsc

También necesitará una service account de Google con acceso de lectura a su propiedad de Search Console:

Vaya a la Google Cloud Console, cree un proyecto y active la Search Console API y, opcionalmente, la Web Search Indexing API.
Cree una service account, genere una clave JSON y descárguela.
En Search Console, añada el email de la service account como usuario de su propiedad con al menos acceso restringido.
Defina la ruta a esa clave JSON como variable de entorno al lanzar el MCP.

Si prefiere una ruta no-code, Better Search Console (de Houtini) y el conector hospedado de Windsor.ai ofrecen rutas de configuración más sencillas. Better Search Console es especialmente cómodo porque sincroniza sus datos en una base de datos SQLite local, lo que permite a Claude ejecutar consultas SQL reales contra su histórico en lugar de quedarse limitado al tope de 1.000 filas por petición de la API de Search Console.

Tres flujos de trabajo que puede ejecutar el primer día

La configuración es la parte aburrida. Esto es lo que hace que la hora invertida merezca la pena.

Flujo 1: reescritura SEO masiva de productos con bajo rendimiento

Abra Claude Code y escriba:

«Usa el MCP de GSC para encontrar las 20 páginas de producto de mi tienda con más impresiones y menor CTR en los últimos 28 días. Para cada una, trae el title y la metadescripción actuales desde Shopify, mira las consultas reales por las que aparecen y reescribe el title y la metadescripción para encajar mejor con la intención de búsqueda. No publiques nada: deja todos los cambios en una lista para que los revise».

Qué pasa por detrás: Claude llama al MCP de GSC para extraer la analítica de búsqueda, llama al MCP de Shopify para traer los campos SEO actuales de cada producto, usa su razonamiento para redactar versiones mejoradas y las imprime en una tabla para su aprobación. Cuando usted dice «todo bien, aplícalas», las empuja a través del MCP de Shopify.

Este es el tipo de tarea que a un SEO humano le lleva una tarde entera. Claude lo hace en unos 4 minutos. Coste: aproximadamente 0,30-0,80 $ en uso de la API de Claude para 20 productos.

Flujo 2: generar imágenes hero de estilo de vida para una nueva colección

«Acabo de crear una nueva colección llamada «Spring Linen». Trae los 8 productos desde Shopify, lee las descripciones, y genera una imagen hero de estilo de vida por producto usando Nano Banana: luz matinal natural, interior escandinavo, estilo visual consistente en los 8 para que parezcan una campaña. Guárdalas en una carpeta local y prepara un borrador para subirlas como imagen principal de producto, pero no publiques hasta que confirme».

Claude lee sus productos a través del MCP de Shopify, redacta prompts descriptivos usando los atributos reales (color, material, dimensiones), genera las imágenes con Nano Banana siguiendo instrucciones de estilo consistentes, las guarda localmente y prepara la subida. Coste total para 8 imágenes en alta resolución: aproximadamente 0,30-1,20 $ según el nivel de resolución.

Lo que antes era imposible —mantener un estilo visual consistente en un set multiproducto— es justo aquello para lo que se construyó la consistencia de personaje/objeto de Nano Banana 2. Ahí es donde se nota en la cuenta de resultados.

Flujo 3: chequeo diario de salud SEO

Añada una instrucción guardada en su proyecto de Claude Code —un archivo CLAUDE.md en la carpeta del proyecto— que diga:

«Cada mañana cuando abra este proyecto, ejecuta un chequeo de salud de Search Console: trae los clics de ayer frente a la media de los 7 días anteriores, marca cualquier página que haya bajado más de un 30 %, comprueba el estado de indexación de los productos nuevos añadidos en las últimas 48 horas y avísame si ha fallado algún envío de sitemap. Después propón correcciones concretas».

Ahora cada vez que abra una sesión de Claude Code, lo hará automáticamente. Es lo más parecido a tener un SEO júnior que nunca olvida ni se toma un día libre.

Expectativas de coste (realistas, no marketing)

Para una tienda Shopify pequeña o mediana ejecutando este stack de forma activa:

Uso de Claude Code (Anthropic): 20-80 $/mes según la frecuencia. La mayoría de los comerciantes se quedan en 30-50 $.
Nano Banana (API de Gemini): 5-25 $/mes para necesidades típicas de fotografía de producto.
MCP de Google Search Console: gratis (usa su cuenta de Google).
Shopify Dev MCP: gratis.
MCP de tienda Shopify: gratis si está autohospedado; ~20-50 $/mes si usa Composio.

Total: entre 25 y 150 $ al mes, todo incluido, para sustituir tareas que antes consumían 10-20 horas semanales de trabajo manual o un asistente virtual a tiempo parcial de 600-1.200 €/mes.

Consejos de seguridad (léalos antes de ejecutar nada)

Algunas reglas aprendidas a base de golpes trabajando con comerciantes en este stack:

Nunca dé a un MCP scopes de escritura que no daría a un becario el primer día. Empiece con solo lectura, observe lo que hace Claude y luego amplíe permisos a medida que construya confianza. Siempre puede añadir scopes después. No puede des-borrar una colección de productos.
Use staging o modo borrador durante las primeras semanas. Diga explícitamente a Claude que «deje todo en borrador y me lo enseñe antes de publicar». La mayoría de los recursos de Shopify admite estados de borrador.
Mantenga una copia exportada de sus productos. Ejecute la exportación nativa de productos de Shopify cada semana. Cinco minutos de seguro contra un mal prompt.
Use un archivo CLAUDE.md en la carpeta del proyecto para documentar su voz de marca, sus temas vetados, sus reglas de precio y cualquier restricción. Claude lo lee al iniciar cada sesión. Sin él, obtendrá resultados inconsistentes que se desvían de su marca con el tiempo.
Audite los MCP que instale. Se ejecutan en su máquina con acceso a su tienda. Quédese con proyectos mantenidos activamente por autores creíbles. Mire las estrellas en GitHub, la fecha del último commit y si el mantenedor responde a las issues.

Qué cambia esto de verdad en su tienda

El argumento honesto no es «la IA sustituye a su equipo». Es que el aburrido 70 % de llevar una tienda online —las actualizaciones de SEO, los refrescos de imágenes, las revisiones de inventario, las reescrituras de descripciones— pasa a ser algo que usted supervisa en lugar de algo que hace. Recupera los fines de semana, y las partes del negocio que sí necesitan a una persona (posicionamiento, relaciones con proveedores, empatía con el cliente, decisiones de marca) reciben más atención porque no las desplaza el trabajo de mantenimiento.

Eso no es una predicción sobre el futuro del trabajo. Es un stack que puede instalar esta tarde.

Preguntas frecuentes

¿Necesito saber programar? No. Todo en esta guía usa comandos de terminal copiados y pegados. Solo tiene que estar cómodo abriendo una terminal y pegando una línea. Claude Code se encarga de las partes técnicas.

¿Cuánto cuesta el stack completo al mes? Entre 25 y 150 $ según el uso. La mayoría de las tiendas Shopify pequeñas se quedan en torno a 50-80 $/mes. Eso sustituye 10-20 horas de trabajo manual a la semana.

¿Es seguro dar a Claude Code acceso a mi tienda en producción? Sí, con precauciones. Empiece con scopes de solo lectura, use modo borrador para todos los cambios y conserve copias semanales de los productos. Amplíe permisos gradualmente a medida que gane confianza.

¿Qué plan de Shopify necesito? Cualquiera que soporte apps personalizadas, es decir, todos los planes de pago. El Dev MCP funciona con cualquier plan. El MCP de gestión de tienda necesita la funcionalidad de apps personalizadas.

¿Puedo usarlo con varias tiendas Shopify? Sí. Añada una instancia de MCP separada para cada tienda con credenciales distintas. Claude Code puede cambiar entre ellas en la misma sesión.

¿Y si un servidor MCP deja de funcionar? Los servidores MCP los mantiene la comunidad. Si uno se rompe tras una actualización de la API de Shopify, puede retirarlo temporalmente con claude mcp remove [nombre] y volver a añadirlo cuando se actualice. El Shopify Dev MCP es oficial y lo mantiene Shopify.

¿Necesita ayuda para configurarlo?

Si ha llegado a la mitad de esta guía y se ha topado con un muro —problemas de rutas en Windows, dolores de OAuth, servidores MCP que no cargan—, es normal. La primera instalación es la más dura.

En areza.digital configuramos exactamente este stack para comerciantes Shopify europeos como servicio productizado. Nos encargamos de la autenticación, la rotación de credenciales, la configuración del CLAUDE.md de marca y los tres primeros flujos de automatización adaptados a su tienda. Usted se lleva un sistema funcionando y una llamada de formación de 30 minutos para operarlo por su cuenta.

Reserve una llamada de descubrimiento de 30 minutos →

Escrito por Nikita Janockin, fundador de areza.digital. Fuentes: documentación oficial de Shopify Dev, documentación de Anthropic Claude Code, Google AI Studio, AminForou/mcp-gsc, GeLi2001/shopify-mcp, ConechoAI/Nano-Banana-MCP, Composio y pruebas directas en tiendas Shopify en producción. Última actualización: 8 de abril de 2026.