用途:本技能把 Shopify 的 AI Toolkit MCP 服务器配置到 Claude Code 中,让开发者无需离开编辑器即可进行 GraphQL 架构校验、Liquid 模板 lint 和 Shopify 官方文档实时检索。
主要能力:1) GraphQL 架构校验:MCP 会内省商店的实时架构,可捕获已废弃字段(如 priceRange 应改为 priceRangeV2)、mutation 输入类型不匹配、必填字段缺失和错误的枚举值。2) Liquid 模板 lint:检查语法错误、已废弃过滤器(如 img_url: '800x' 应改为 image_url: width: 800)、作用域泄漏(如 {% include 'card' %} 应改为 {% render 'card', product: product %})以及无限制循环。3) 文档搜索:通过 MCP 查询 Shopify 官方文档,例如查询 Product 对象字段、companyCreate mutation 输入结构、B2B 所需 scope、2024-10 API 版本变化。
使用方式:需 Node.js 18+ 与 npm/pnpm,一个带自定义应用或 API 访问令牌的 Shopify 商店,以及合适的访问权限(最低 read_products、read_themes),并启用 MCP 支持的 Claude Code。在项目根目录创建或更新 .mcp.json,配置 mcpServers.shopify,command 为 npx,args 为 -y @shopify/ai-toolkit-mcp,env 中设置 SHOPIFY_ACCESS_TOKEN 与 SHOPIFY_STORE_URL。随后设置环境变量:export SHOPIFY_ACCESS_TOKEN="shpat_xxxxxxxxxxxxxxxxxxxx" 与 export SHOPIFY_STORE_URL="https://your-store.myshopify.com"。注意包名 @shopify/ai-toolkit-mcp 可能变化,应以 shopify.dev/docs 最新官方信息为准。
适用场景:验证 GraphQL mutation 后再执行、为团队项目在项目、用户、全局层级配置 MCP、将 MCP 校验与其他 shopify-pack 技能(如 B2B、结算扩展)串联使用。
限制:具体价格、收费模式、平台兼容范围等资料暂未提供;实际能力受 API 权限与速率限制影响,错误处理与高级配置需参考官方文档。