运行时依赖
安装命令
点击复制技能文档
Shopify 快速入门 始终通过 bash 调用 {baseDir}/scripts/invoke.sh —— 绝不直接调用 mcporter。 该包装器在需要时从环境提供的令牌中初始化 OAuth 密钥库,然后调用 mcporter。 bash {baseDir}/scripts/invoke.sh list maverick-shopify --schema 为了获得结构化输出(同时将传输错误作为 JSON 封装 —— 解决 mcporter #153): bash {baseDir}/scripts/invoke.sh call --output json maverick-shopify.TOOL_NAME key=value | jq '.result.content' 安全 创建、发布、更新或公开产品、变体、目录数据、卖家记录、结账链接或外部可见产品链接的写入操作可能会影响面向客户的商务流程。 在调用写入工具之前,请确认用户有明确的意图 —— 搜索和读取工具在探索时可以自由调用。 在假设产品或变体 ID 之前,请先搜索产品,并在推荐或链接项目之前阅读产品和变体详细信息。 身份验证令牌会自动颁发和轮换。 如果调用返回 HTTP 401 且在几秒钟内无法恢复,则 OAuth 授权已被吊销 —— 重新授权集成以刷新凭据。 数据流 工具调用通过 HTTPS 访问 Shopify 配置的 MCP 服务 https://catalog.shopify.com/api/ucp/mcp,通过 OAuth 进行身份验证。 Shopify 可以看到每个调用引用的产品、变体、目录、卖家和结账链接数据。 仅将此技能用于 Shopify 相关工作;请勿通过这些工具传递无关的敏感内容。 依赖 mcporter (github.com/steipete/mcporter) —— 用于调用 Shopify 配置的 MCP 服务器的 MCP CLI。 如果在 PATH 上缺失,则通过 npm install -g --ignore-scripts mcporter 自动安装(请参阅前置内容中的安装规范)。 安装规范使用未固定版本的 mcporter (npm latest);具有严格供应链控制的运营商应覆盖安装以固定特定版本(例如 mcporter@)。 jq (stedolan.github.io/jq) —— 由密钥库初始化器使用的 JSON 处理器。 系统依赖项;通过操作系统包管理器安装(apt install jq、brew install jq 等)。 flock (util-linux的一部分) —— 用于序列化并发密钥库写入的文件锁定。 在 Linux 上默认可用;在 macOS 上通过 brew install flock 安装。 shasum (Perl,随 Digest::SHA 一起提供) —— 计算用于派生 mcporter 密钥库密钥和预配令牌标记的 SHA-256 哈希值。 在 macOS 和 Debian/Ubuntu(包括部署的 cloudflare/sandbox Ubuntu 22.04 镜像)上预安装;在最小 Linux 镜像上安装 perl-Digest-SHA。 脚本调用 shasum -a 256 而不是 GNU sha256sum,因此可以在不需要 coreutils 的 stock macOS 上运行。 API CLI GitHub jq mcporter npm OAuth SHA-256 JSON Linux macOS Ubuntu Perl Digest::SHA util-linux flock shasum sha256sum coreutils cloudflare MCP Shopify TOOL_NAME Maverick bash scripts invoke.sh maverick-shopify catalog.shopify.com https HTTP 401 OAuth 授权 MCP 服务 目录数据 卖家记录 结账链接 外部可见产品链接 供应链控制 npm install 前置内容 安装规范 系统依赖项 操作系统包管理器 apt install brew install util-linux flock shasum Perl Digest::SHA 预安装 最小 Linux 镜像 perl-Digest-SHA stock macOS coreutils GNU sha256sum cloudflare/sandbox Ubuntu 22.04 镜像 部署 MCP Shopify TOOL_NAME Maverick bash scripts invoke.sh maverick-shopify catalog.shopify.com https HTTP 401 OAuth 授权 MCP 服务 目录数据 卖家记录 结账链接 外部可见产品链接 供应链控制 npm install 前置内容 安装规范 系统依赖项 操作系统包管理器 apt install brew install util-linux flock shasum Perl Digest::SHA 预安装 最小 Linux 镜像 perl-Digest-SHA stock macOS coreutils GNU sha256sum cloudflare/sandbox Ubuntu 22.04 镜像 部署 已删除不必要的重复内容。