# Crea apps y temas de Shopify con IA

> Las APIs de Shopify cambian a menudo y los agentes inventan campos.

Esta configuración es para desarrolladores que crean apps, extensiones o temas de Shopify con un agente de programación. El servidor Dev MCP de Shopify da a Cursor o Claude Code la documentación y los esquemas GraphQL actuales, y el servidor de GitHub permite al agente trabajar con ramas y pull requests. Al final tienes código comprobado contra las API reales de Shopify, no contra campos que el modelo recuerda de versiones antiguas.

## Pasos

1. **Añade Shopify Dev MCP**: Añade el servidor Shopify Dev MCP a Cursor o Claude Code con el comando npx -y @shopify/dev-mcp@latest. Necesita Node y no requiere iniciar sesión en Shopify, porque sirve documentación y esquemas públicos. Pide al agente que busque en la documentación un tema conocido, como los webhooks, para comprobar que funciona.
   Consejo: Anota en el proyecto la versión de la API que usas para que el agente consulte el esquema correcto.
2. **Conecta GitHub**: Añade el servidor MCP de GitHub, en su versión alojada o en local con un token de acceso personal detallado limitado al repositorio de tu app. Dale permiso para leer código, crear ramas y abrir pull requests. Protege la rama principal para que todo cambio pase por revisión.
   Consejo: Un token detallado limitado a un repositorio reduce el daño si se filtra.
3. **Construye con esquemas reales**: Describe la funcionalidad, por ejemplo añade un metafield de producto y muéstralo en un bloque de extensión de tema. Pide al agente que inspeccione el esquema GraphQL de Admin y valide sus consultas antes de escribir código. Ejecuta la app en local con Shopify CLI en una tienda de desarrollo y revisa el pull request.
   Consejo: Indica al agente qué superficie usas (Admin API, Storefront API, Functions o Liquid) para que busque en la documentación correcta.

## Prompts para probar

- Busca en la documentación de Shopify cómo registrar un webhook orders/create en una app Remix y enséñame el código.
- Escribe una mutación GraphQL de Admin para asignar un metafield personalizado a un producto y valídala contra el esquema.
- Añade un bloque de extensión de tema que muestre el metafield de instrucciones de cuidado del producto.
- Revisa todas las consultas GraphQL de este repositorio contra el esquema actual de Admin API y lista los campos obsoletos.
- Crea una rama, implementa la Function de descuento descrita en docs/discount.md y abre un pull request.

## Qué necesitas

- Node.js instalado para usar npx
- Una cuenta de Shopify Partner y una tienda de desarrollo
- Cursor o Claude Code
- Un repositorio de GitHub y un token con permisos limitados

## Límites

- Que los campos del esquema sean válidos no garantiza que la lógica de negocio sea correcta; sigues necesitando pruebas y revisión.
- El agente no puede navegar por el admin de Shopify ni ver cómo queda un tema; esas pruebas te tocan a ti.
- Las búsquedas devuelven fragmentos de la documentación, así que en temas complejos quizá tengas que leer la guía completa.

## Notas de seguridad

- Dev MCP solo lee documentación y esquemas: no toca tu tienda.
- Revisa los pull requests antes de desplegar.

## Servidores MCP

- [Shopify Dev MCP Server](https://shopify.dev/docs/apps/build/devmcp): docs-read, api-schema-read
- [GitHub MCP Server](https://github.com/github/github-mcp-server): repository-read, issue-write, pull-request-write

## Preguntas frecuentes

**¿Puede el servidor Dev MCP cambiar mi tienda?**

No. Solo busca en la documentación y lee esquemas de la API. Los cambios en una tienda vienen del código de tu app, que ejecutas con Shopify CLI y tus propias credenciales.

**¿Tiene algún coste?**

El servidor Shopify Dev MCP es gratuito y se ejecuta en local con npx. Para probar apps necesitas una cuenta de Shopify Partner y una tienda de desarrollo, que Shopify ofrece sin coste.

**¿Qué editores sirven?**

Cursor, Claude Code y otros clientes MCP que ejecuten servidores locales. Claude Desktop también funciona, pero aporta menos sin acceso a tu código.

**¿Y los temas Liquid?**

El servidor cubre la documentación de temas y Liquid además de las API. Prueba los cambios de tema con shopify theme dev en una tienda de desarrollo antes de publicarlos.

## Herramientas

- **[Shopify](https://suiteintent.com/t/shopify?m=ES)**: Crea y gestiona una tienda online. · Ideal para: Marcas que venden online, en tienda y en redes · Precio bajo consulta · 1
- **[GitHub](https://suiteintent.com/t/github?m=ES)**: Alojamiento de código, incidencias y pull requests. · Ideal para: Equipos que revisan código con pull requests · Plan gratis · 10000
