Shopify Multi Store

Dieses Codex-Plugin hält mehrere Shopify-Admin-Stores in einer Aufgabe verfügbar. Jeder Store hat einen eigenen Alias und ein eigenes Zugriffstoken, sodass das Wechseln von Stores einen anderen Store nicht trennt.

Voraussetzungen

• macOS mit Keychain-Zugriff

• Node.js 20 oder neuer

• Ein Shopify-Admin-API-Zugriffstoken für jeden Store

Related MCP server: Shopify Storefront MCP Server

Installation

Klonen Sie das Repository und installieren Sie seine Abhängigkeiten:

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

Installieren Sie das lokale Plugin in Codex mithilfe des geklonten Verzeichnisses. Das Repository enthält das Codex-Plugin-Manifest und die MCP-Server-Konfiguration.

Store hinzufügen

1. Öffnen Sie ein Terminal in diesem Plugin-Verzeichnis.

2. Führen Sie diesen Befehl aus:

npm run configure -- add

3. Geben Sie einen kurzen Store-Alias ein.

4. Geben Sie die permanente *.myshopify.com-Domain ein.

5. Geben Sie das Admin-API-Zugriffstoken ein.

6. Wiederholen Sie den Befehl für jeden Store.

Das Skript speichert jedes Token in der macOS-Keychain unter dem Dienstnamen codex-shopify-multi-store. Die Konfigurationsdatei enthält keine Zugriffstokens.

Vorhandenes Toolkit importieren

Importieren Sie eine kompatible Multi-Store-stores.json-Datei:

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

Der Import speichert jedes Token in der macOS-Keychain. Er ändert beide Konfigurationsdateien auf Zugriff nur für den Eigentümer. Löschen Sie die alte Anmeldedatendatei, wenn Sie sie nicht mehr benötigen.

Verwenden Sie nur die Admin-API-Bereiche, die jede Aufgabe benötigt. Shopify steuert die verfügbaren Daten über diese Bereiche.

Stores verwalten

Listen Sie die konfigurierten Stores auf:

npm run configure -- list

Entfernen Sie einen Store und sein Keychain-Token:

npm run configure -- remove store-alias

Verfügbare Tools

• shopify_list_stores listet die verbundenen Store-Aliasse auf.

• shopify_get_shop_info ruft die Identität eines Stores ab.

• shopify_graphql_query führt eine schreibgeschützte Admin-GraphQL-Abfrage aus.

• shopify_graphql_mutation ändert einen Store nach genauer Autorisierung.

Jede Store-Aktion benötigt einen Store-Alias. Diese Anforderung verringert das Risiko einer Änderung am falschen Store.

Sicherheit

• Committen Sie niemals Zugriffstokens, OAuth-Client-Geheimnisse, .env-Dateien oder stores.json-Dateien mit Anmeldedaten.

• Gewähren Sie nur die Shopify-Admin-API-Bereiche, die für die vorgesehenen Aufgaben erforderlich sind.

• Bestätigen Sie den Ziel-Store, bevor Sie eine Mutation ausführen.

• Siehe SECURITY.md für Anweisungen zur Meldung.

Entwicklung

npm ci
npm test

Lizenz

MIT