Jedi Collection Sort

Jedi Collection Sort — MCP サーバー

ネイティブの MCP サーバーを備えた、初の Shopify コレクション並べ替えアプリです。 Claude や、MCP 対応クライアントとのチャットで、Shopify コレクション内の商品表示順を管理できます。

Jedi ‑ Collection Sort Pro は、Shopify コレクション内の商品を自動で並べ替えます。売り切れや在庫切れの商品を下位に移動し、ベストセラーや新着商品を目立たせるほか、AI による複数パラメーターでの並べ替え、A/B テスト、分析にも対応しています。この MCP サーバーを使うと、AI アシスタントがストアの並べ替え設定を読み取り、操作できます。

接続すると、次のようなことを頼めます。

• 「先週並べ替えが行われていないコレクションはどれですか？」
• 「Summer コレクションに『新着商品を先頭に』の戦略を割り当てて、今すぐ並べ替えてください。」
• 「Default 戦略のレイヤー設定を見せてください。」
• 「Clearance コレクションの並べ替えをオフにしてください。」

ツール

ツール	機能
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. アプリで Settings → Integrations を開き、connect code を生成します（一度のみ使用可能で、有効期限は 10 分です）。
2. claude.ai で Settings → Connectors → Add custom connector を選び、https://api.collection-sort.jediapps.com/mcp を貼り付けます。
3. Claude に同意ページが表示されたら、connect code を入力してストアをリンクします。

このサーバーは OAuth 2.1 認可サーバーの全機能（動的クライアント登録、PKCE、リフレッシュトークンのローテーション）を備えているため、OAuth 対応の MCP クライアントならどれでも同じ方法で接続できます。

Claude Code ／ ヘッダー対応クライアントから接続する（API キー）

Settings → Integrations で API キーを生成し（一度のみ表示され、ハッシュ化して保存されます）、次のように設定します。

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

トランスポートとセキュリティ

• Streamable HTTP トランスポートを使用するステートレス方式です。リモートサーバーに対応する MCP クライアントならどれでも利用できます。
• OAuth アクセストークンとリフレッシュトークン、API キー、connect code はハッシュ化して保存され、アプリから失効させることができます。アプリのアンインストール時にはすべて削除されます。
• レート制限（キーごとに毎分 60 リクエスト）があり、並べ替えのトリガーは冪等です。そのため、エージェントの再試行ループによって重複した処理がキューに追加されることはありません。

REST API

同じ操作を REST API（https://api.collection-sort.jediapps.com/public-api/v1）からも利用できます。Bearer API キー認証に対応し、戦略、コレクション、並べ替えの実行、ジョブのステータスを扱えます。エンドポイントとエラーコードについては、ドキュメントをご覧ください。

サポート

• ドキュメントと FAQ：jediapps.com/docs
• アプリの掲載ページとサポート：apps.shopify.com/jedi-collection-sort

---

このリポジトリでは、Jedi ‑ Collection Sort Pro の一部として Jedi Apps が運用するホスト型 MCP サーバーについて説明しています。サーバーはアプリのインフラストラクチャの一部として稼働するため、このリポジトリからインストールするものはありません。