Shopify Multi Store

이 Codex 플러그인은 하나의 태스크에서 여러 Shopify Admin 스토어를 유지합니다. 각 스토어는 별도의 별칭과 액세스 토큰을 가지므로, 스토어를 전환해도 다른 스토어의 연결이 끊기지 않습니다.

요구 사항

• 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

하나의 스토어와 해당 Keychain 토큰을 제거합니다:

npm run configure -- remove store-alias

사용 가능한 도구

• shopify_list_stores는 연결된 스토어 별칭을 나열합니다.

• shopify_get_shop_info는 하나의 스토어의 신원을 가져옵니다.

• shopify_graphql_query는 읽기 전용 Admin GraphQL 쿼리를 실행합니다.

• shopify_graphql_mutation은 정확한 승인 후 하나의 스토어를 변경합니다.

모든 스토어 작업에는 스토어 별칭이 필요합니다. 이 요구 사항은 잘못된 스토어에 변경이 가해질 위험을 줄입니다.

보안

• 액세스 토큰, OAuth 클라이언트 시크릿, .env 파일 또는 자격 증명이 포함된 stores.json 파일을 커밋하지 마세요.

• 의도한 태스크에 필요한 Shopify Admin API 범위만 부여하세요.

• 뮤테이션을 실행하기 전에 대상 스토어를 확인하세요.

• 신고 방법은 SECURITY.md를 참조하세요.

개발

npm ci
npm test

라이선스

MIT