Shopify Multi Store

この Codex プラグインは、複数の Shopify Admin ストアを 1 つのタスク内で保持します。各ストアには個別のエイリアスとアクセストークンがあるため、ストアを切り替えても別のストアが切断されることはありません。

要件

• Keychain アクセスを備えた macOS

• Node.js 20 以降

• 各ストアの Shopify Admin API アクセストークン

Related MCP server: Shopify Storefront MCP Server

インストール

リポジトリをクローンし、依存関係をインストールします:

git clone https://github.com/alex-brecher/shopify-multi-store.git
cd shopify-multi-store
npm ci
npm run build

クローンしたディレクトリを使用して、Codex にローカルプラグインをインストールします。リポジトリには Codex プラグインマニフェストと MCP サーバー設定が含まれています。

ストアを追加する

1. このプラグインディレクトリでターミナルを開きます。

2. 次のコマンドを実行します:

npm run configure -- add

3. 短いストアエイリアスを入力します。

4. 永続的な *.myshopify.com ドメインを入力します。

5. Admin API アクセストークンを入力します。

6. 各ストアについてコマンドを繰り返します。

このスクリプトは各トークンを macOS Keychain のサービス名 codex-shopify-multi-store の下に保存します。設定ファイルにはアクセストークンは含まれません。

既存のツールキットをインポートする

互換性のあるマルチストア stores.json ファイルをインポートします:

npm run import-legacy -- /absolute/path/to/stores.json

インポートすると、各トークンが macOS Keychain に保存されます。両方の設定ファイルが所有者のみアクセス可能に変更されます。レガシー資格情報ファイルが不要になったら削除してください。

各タスクに必要な Admin API スコープのみを使用してください。Shopify はこれらのスコープを通じて利用可能なデータを制御します。

ストアを管理する

設定済みのストアを一覧表示します:

npm run configure -- list

1 つのストアとその Keychain トークンを削除します:

npm run configure -- remove store-alias

利用可能なツール

• shopify_list_stores は接続済みのストアエイリアスを一覧表示します。

• shopify_get_shop_info は 1 つのストアの ID を取得します。

• shopify_graphql_query は読み取り専用の Admin GraphQL クエリを実行します。

• shopify_graphql_mutation は正確な認可後に 1 つのストアを変更します。

すべてのストア操作にはストアエイリアスが必要です。この要件により、誤ったストアへの変更リスクが軽減されます。

セキュリティ

• アクセストークン、OAuth クライアントシークレット、.env ファイル、または資格情報を含む stores.json ファイルをコミットしないでください。

• 意図したタスクに必要な Shopify Admin API スコープのみを付与してください。

• ミューテーションを実行する前に、対象ストアを確認してください。

• 報告手順については SECURITY.md を参照してください。

開発

npm ci
npm test

ライセンス

MIT