Cinco subagentes de Claude Code para Shopify y Shopify Plus, con el MCP oficial de Shopify.
/plugin marketplace add commentemeapp/shopify-agents
/plugin install shopify-agents@shopify-agentsReinicia Claude Code o corre /reload-plugins. Los agentes aparecen en el typeahead de @ como
shopify-agents:shopify-reviewer, y el servidor MCP como shopify-dev. Si ya tenías @shopify/dev-mcp agregado con
claude mcp add, quítalo con claude mcp remove <nombre> para no tener el servidor dos veces.
@shopify-agents:shopify-reviewer revisa lo que acabo de cambiar en sections/ y en extensions/
No hace falta nombrarlos: "antes de hacer el deploy, corre Theme Check y revisa el diff" también delega. Para una
sesión completa con un agente, claude --agent shopify-agents:shopify-integration-architect.
| Agente | Que hace | Skills que precarga | Herramientas del servidor MCP | Modelo |
|---|---|---|---|---|
shopify-explorer |
Mapea un tema, una app o un storefront Hydrogen: sections, blocks, extensiones, scopes, webhooks. | shopify |
learn_shopify_api, search_docs_chunks |
haiku |
shopify-reviewer |
Revisa el diff antes del deploy: secretos, HMAC, scopes, costo de las consultas, contrato de los schemas. | shopify |
learn_shopify_api, search_docs_chunks, validate, validate_theme |
inherit |
shopify-qa |
Corre Theme Check, build, lint y tests, y devuelve solo las fallas con archivo y stack. | shopify |
ninguna, a propósito | sonnet |
shopify-integration-architect |
Diseña y audita integraciones con ERP, OMS y marketplaces, incluido Plus (Functions, B2B, Markets). | shopify |
learn_shopify_api, search_docs_chunks |
opus |
shopify-docs-researcher |
Busca en la documentación de Shopify y cita siempre la fuente. | ninguna, a propósito | learn_shopify_api, search_docs_chunks |
haiku |
El servidor MCP es @shopify/dev-mcp, el oficial de Shopify,
ejecutado con npx -y @shopify/dev-mcp y con OPT_OUT_INSTRUMENTATION=true. No pide credenciales ni toca ninguna
tienda: busca en shopify.dev y valida GraphQL, componentes de extensiones, Functions y Liquid contra los esquemas
reales. Su herramienta feedback queda fuera de todos los agentes, porque solo sirve para reportarle a Shopify.
Ningún agente tiene Write o Edit, y ninguno envía el campo user_prompt al servidor. El razonamiento detrás de
cada decisión está en docs/agentes.md.
Construido sobre la skill oficial shopify del Shopify AI Toolkit,
sin costo y de código abierto. El toolkit trae el conocimiento; este plugin agrega lo que el toolkit no tiene:
subagentes read-only que se quedan con el ruido y devuelven solo la señal.
- Claude Code con soporte de plugins.
- Node
>= 18, para quenpxejecute el servidor MCP y los scripts de la skill. - La skill oficial
shopify, instalada connpx skills add Shopify/Shopify-AI-Toolkit. Sin ella los agentes funcionan, pero degradados: Claude Code omite las skills que no encuentra y conserva el flujo de cada agente, sin la tabla de temas ni las referencias que hacen precisas sus respuestas. Si la instalas como plugin (shopify-ai-toolkit@claude-plugins-official), Claude Code la registra con el nombre del plugin delante; los agentes la siguen encontrando con el toolSkill, pero no como skill precargada. - El Shopify CLI para que
shopify-qacorra Theme Check yshopify app build.
- La
descriptionde cada agente es lo que Claude lee para decidir a quién delegar. Están escritas para que la delegación ocurra sola: "úsalo proactivamente antes de cualquier cambio estructural", "úsalo antes deshopify app deploy". - La skill
shopifyentra completa al contexto del agente al arrancar: es la tabla de temas del toolkit oficial (Admin, Liquid, Functions, Hydrogen, checkout, Polaris, CLI…). Cada agente lee bajo demanda solo el archivo dereferences/del tema que necesita. - El servidor MCP arranca con el plugin. Cada agente declara nombre por nombre las herramientas que usa, con el
prefijo
mcp__plugin_shopify-agents_shopify-dev__, y llama primero alearn_shopify_api, que el servidor exige antes de las demás. Si el servidor no está en la sesión, el agente sigue con lo que tiene y lo dice.
"Que campos tiene ProductVariant en 2026-10?", "valida esta mutación de inventorySetQuantities", "busca como se
declara un app block en una theme app extension".
Las skills y el servidor del toolkit envían telemetría a Shopify por defecto: consultas, código validado y, si el
agente lo entrega, el mensaje literal de quien pregunta. Este plugin la apaga en el servidor MCP con
OPT_OUT_INSTRUMENTATION=true, les prohíbe a los agentes correr los scripts de la skill (que reportan aparte) y les
prohíbe enviar user_prompt.
Para apagarla también en la conversación principal, donde la skill sí corre sus scripts, crea el archivo vacío que el toolkit reconoce en cualquier proceso:
mkdir -p ~/.config/shopify-ai-toolkit && touch ~/.config/shopify-ai-toolkit/opt-outLos cinco agentes también funcionan en Gemini CLI, Codex, GitHub Copilot y Cursor. Cada versión se genera desde los archivos de
Claude Code con scripts/exportar.mjs: cambian el frontmatter y los nombres de las herramientas, el texto es el
mismo. Fuera de Claude Code no hay skills precargadas, así que cada agente empieza diciendo cuales cargar; se instalan
con npx skills add <repositorio> -a <agente>.
| Agente | Instalación |
|---|---|
| Gemini CLI | gemini extensions install https://github.com/commentemeapp/shopify-agents: trae los cinco agentes y el servidor MCP (shopify-dev) |
| Codex | Copia adaptadores/codex/*.toml a ~/.codex/agents/ y agrega el servidor MCP con los comandos de abajo |
| GitHub Copilot | Copia adaptadores/copilot/*.agent.md a ~/.copilot/agents/ o a .github/agents/ del proyecto; el servidor MCP va en ~/.copilot/mcp-config.json, con el mismo mcpServers de .mcp.json |
| Cursor | Copia adaptadores/cursor/*.md a ~/.cursor/agents/ o a .cursor/agents/ del proyecto; el servidor MCP va en ~/.cursor/mcp.json, con el mismo mcpServers |
codex mcp add shopify-dev --env OPT_OUT_INSTRUMENTATION=true -- npx -y @shopify/dev-mcpEn Copilot, las herramientas MCP van como <servidor>/<herramienta>; en Gemini CLI, como mcp_<servidor>_<herramienta>;
en Codex y Cursor, el agente hereda las del servidor configurado. Cursor no tiene lista de herramientas por agente: los
agentes que no escriben van con readonly: true.
| Acción | Comando |
|---|---|
| Actualizar | /plugin marketplace update shopify-agents |
| Desinstalar | /plugin uninstall shopify-agents@shopify-agents |
.claude-plugin/marketplace.json catálogo del marketplace de Claude Code
plugins/shopify-agents/
.claude-plugin/plugin.json manifiesto del plugin; mcpServers apunta a .mcp.json
.mcp.json el servidor MCP shopify-dev: npx -y @shopify/dev-mcp, sin telemetría
agents/ los cinco agentes, uno por archivo
docs/agentes.md por que cada agente es como es
scripts/verificar.sh gate de este repositorio
scripts/probar-mcp.mjs arranca el servidor MCP y comprueba las herramientas que usan los agentes
assets/ header del README
Para desarrollar este repositorio necesitas Node >= 20, según package.json. El requisito de Node >= 18 indicado arriba corresponde a ejecutar el servidor MCP. Las definiciones de los cinco agentes viven en plugins/shopify-agents/agents/ y su conexión MCP en .mcp.json.
git clone https://github.com/commentemeapp/shopify-agents.git
cd shopify-agents
npm ci
./scripts/verificar.sh
node scripts/probar-mcp.mjsscripts/verificar.sh es el gate, el mismo que corre el CI: JSON válido, la misma versión en los tres manifiestos,
la configuración del servidor MCP (incluida la telemetría apagada), el frontmatter de cada agente (nombre igual al
archivo, description, tool Skill presente, sin Write ni Edit, máximo cuatro skills precargadas, prefijo MCP
propio y skills que existen en el Shopify AI Toolkit), claude plugin validate --strict, Prettier, bash -n y una
búsqueda de rastros que no deben llegar a un repositorio público. scripts/probar-mcp.mjs arranca el servidor por
stdio y falla si una herramienta que un agente declara no existe. El CI suma la búsqueda de secretos con gitleaks y el
control del flujo de ramas.
Para probar el plugin sin publicarlo:
claude --plugin-dir ./plugins/shopify-agentsLa versión vive en tres lugares: arriba en .claude-plugin/marketplace.json, en la entrada del plugin del mismo
archivo y en plugins/shopify-agents/.claude-plugin/plugin.json. Súbela en los tres a la vez; sin subirla, Claude
Code no entrega el cambio a quien ya tiene el plugin.
Conventional Commits, rama desde dev y PR contra dev; un agente nuevo tiene que pasar la pregunta de
docs/agentes.md.
MIT.
Hecho por commente.me · hablecon@commente.me
