Jedi Collection Sort

Jedi Collection Sort — MCP 服务

首款内置 MCP 服务的 Shopify 集合排序应用。 通过与 Claude 或任何支持 MCP 的客户端聊天，管理 Shopify 集合中商品的排序方式。

Jedi ‑ Collection Sort Pro 可自动对 Shopify 集合中的商品排序：将已售罄和缺货商品下移，让畅销商品和新品优先展示，支持 AI 多参数排序、A/B 测试和分析。此 MCP 服务可让 AI 助手读取并控制你商店的排序。

连接后，你可以这样说：

• “我有哪些集合上周没有排序过？”
• “将‘新品优先’策略分配给夏季集合，并立即排序。”
• “显示我的默认策略的图层配置。”
• “关闭清仓集合的排序。”

工具

工具	功能
list_strategies	列出商店的排序策略（ID、标题、排序频率、图层数量）
get_strategy	获取一个策略，包括其完整图层配置
list_collections	列出由 Collection Sort 管理的集合，以及策略、排序状态和上次排序时间（active_only 筛选器）
get_collection_config	获取一个集合的排序配置：已分配的策略及其图层、状态和任何待处理的排序任务
set_collection_sorting	为集合分配策略和／或启用或停用排序；更改已启用排序的集合所用策略时，会将重新排序任务加入队列
sort_collection_now	将按需排序任务加入队列——操作具有幂等性，排序完成后设有短暂冷却时间
list_sort_jobs	按时间从新到旧列出已排队和正在处理的排序任务

所有工具都绑定到经过身份验证的商店；连接只能查看和管理自己的商店。

要求

1. 从 Shopify App Store 安装 Jedi ‑ Collection Sort Pro。
2. 付费套餐（每月 $2.99 起）——所有付费套餐均包含 MCP 服务和公共 API。

从 claude.ai / Claude Desktop 连接（OAuth）

1. 在应用中打开 设置 → 集成，生成一个连接码（一次性使用，10 分钟后过期）。
2. 在 claude.ai 中：设置 → 连接器 → 添加自定义连接器，粘贴 https://api.collection-sort.jediapps.com/mcp。
3. Claude 会打开授权页面——输入连接码以关联你的商店。

此服务是一个完整的 OAuth 2.1 授权服务器（动态客户端注册、PKCE、刷新令牌轮换），因此任何支持 OAuth 的 MCP 客户端都可以用相同方式连接。

从 Claude Code / 支持请求头的客户端连接（API 密钥）

在设置 → 集成中生成 API 密钥（仅显示一次，以哈希形式存储），然后：

claude mcp add collection-sort --transport http https://api.collection-sort.jediapps.com/mcp \
  --header "Authorization: Bearer jcs_..."

传输与安全

• 使用 Streamable HTTP 传输，无状态——适用于任何支持远程服务的 MCP 客户端。
• OAuth 访问令牌和刷新令牌、API 密钥及连接码均以哈希形式存储，可在应用中撤销；卸载应用时会清理所有内容。
• 设有速率限制（每个密钥每分钟 60 个请求），并通过幂等的排序触发机制，防止 Agent 重试循环重复加入任务。

REST API

相同操作也可通过 REST API（https://api.collection-sort.jediapps.com/public-api/v1）使用 Bearer API 密钥进行身份验证——包括策略、集合、触发排序和任务状态。有关端点和错误代码，请参阅文档。

支持

• 文档与常见问题：jediapps.com/docs
• 应用页面与支持：apps.shopify.com/jedi-collection-sort

---

此代码库介绍由 Jedi Apps 运营、作为 Jedi ‑ Collection Sort Pro 一部分提供的托管 MCP 服务。该服务本身运行在应用的基础设施中——无需从此代码库安装任何内容。