name: shopify-dev-mcp description: > Use when user wants to work with Shopify Admin API, Storefront API, validate Liquid code, explore GraphQL schemas, build Shopify apps, or inspect Shopify documentation and MCP tools. version: "1.0.0"

Shopify Development MCP (shopify-dev-mcp)

Provides a workflow to interact with Shopify's development ecosystem via the shopify-dev MCP server. It enables searching documentation, introspecting GraphQL schemas, validating Liquid/theme code, and building Shopify extensions while avoiding hallucinations.

Trigger Scenarios

• "How do I create a product using the Admin API?"
• "Show me the fields on the Order GraphQL type."
• "Validate this Liquid snippet for a theme."
• "I need to explore the Storefront API schema."
• "Help me build a Shopify app that uses Polaris components."
• "Debug a GraphQL error from Shopify."

Core Workflow

1. Initialize – Call learn_shopify_api for the required technology (admin, storefront-graphql, liquid, polaris) and capture the returned conversationId.
2. Search Documentation – Use search_docs_chunks for semantic search or fetch_full_docs for full pages.
3. Introspect Schema – Run introspect_graphql_schema with the conversationId to get up‑to‑date types and fields.
4. Validate Code – Depending on the content:
5. GraphQL: validate_graphql_codeblocks
6. Polaris UI: validate_component_codeblocks
7. Liquid/theme: validate_theme
8. Present Result – Return the validated code or documentation excerpt to the user.

Best Practices

• Always start with step 1 and reuse the same conversationId for subsequent calls.
• Wrap MCP CLI commands in single quotes when invoking via shell ('shopify-dev.tool(...)').
• Prefer a local installation of @shopify/dev-mcp over npx for reliability.
• Use absolute paths in the MCP configuration to avoid path resolution issues.
• Validate any generated code before showing it to the user.

Usage Examples

# 1. Initialize for Admin GraphQL
learn_shopify_api tech:admin
# ⇒ returns conversationId=abc123

# 2. Search docs for "product creation"
search_docs_chunks query:"product creation" conversationId:abc123

# 3. Introspect the schema
introspect_graphql_schema conversationId:abc123

# 4. Validate a GraphQL mutation
validate_graphql_codeblocks conversationId:abc123 codeblocks:[{content:"mutation { productCreate(input:{title:\"New\"}) { product { id } userErrors { field message } } }"}]

# 5. Validate a Liquid snippet
validate_theme conversationId:abc123 path:"/tmp/theme" files:["snippets/header.liquid"]

References

• See references/api-guide.md for full API details, GraphQL schema listings, Liquid validation options, and MCP server setup.

Created by Simon Cai · More e-commerce skills: github.com/simoncai519/open-accio-skill

这个 Skill 质量中等偏上。文档编写规范，工作流程清晰易懂，最佳实践建议实用，能够帮助开发者避免常见错误。但文件数量偏少，仅有说明文档而没有实际代码或示例可参考，缺少配置文件。功能依赖外部工具，没有独立的代码实现。对于需要与 Shopify API 交互的开发者来说有一定帮助，但深度和完整性还有提升空间。