Shopify Multi Store

Este plugin de Codex mantiene varias tiendas de Shopify Admin disponibles en una sola tarea. Cada tienda tiene un alias y un token de acceso separados, por lo que cambiar de tienda no desconecta otra tienda.

Requisitos

• macOS con acceso a Keychain

• Node.js 20 o más reciente

• Un token de acceso a la API de Shopify Admin para cada tienda

Related MCP server: Shopify Storefront MCP Server

Instalación

Clona el repositorio e instala sus dependencias:

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

Instala el plugin local en Codex usando el directorio clonado. El repositorio incluye el manifiesto del plugin de Codex y la configuración del servidor MCP.

Añadir una tienda

1. Abre una terminal en este directorio del plugin.

2. Ejecuta este comando:

npm run configure -- add

3. Introduce un alias corto para la tienda.

4. Introduce el dominio permanente *.myshopify.com.

5. Introduce el token de acceso a la API de Admin.

6. Repite el comando para cada tienda.

El script guarda cada token en el llavero de macOS bajo el nombre de servicio codex-shopify-multi-store. El archivo de configuración no contiene tokens de acceso.

Importar un kit de herramientas existente

Importa un archivo stores.json compatible con varias tiendas:

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

La importación guarda cada token en el llavero de macOS. Cambia ambos archivos de configuración a acceso solo para el propietario. Elimina el archivo de credenciales heredado cuando ya no lo necesites.

Usa solo los alcances de la API de Admin que cada tarea necesite. Shopify controla los datos disponibles a través de estos alcances.

Gestionar tiendas

Lista las tiendas configuradas:

npm run configure -- list

Elimina una tienda y su token de Keychain:

npm run configure -- remove store-alias

Herramientas disponibles

• shopify_list_stores lista los alias de las tiendas conectadas.

• shopify_get_shop_info obtiene la identidad de una tienda.

• shopify_graphql_query ejecuta una consulta de GraphQL de Admin de solo lectura.

• shopify_graphql_mutation cambia una tienda después de una autorización exacta.

Cada acción de tienda necesita un alias de tienda. Este requisito reduce el riesgo de un cambio en la tienda equivocada.

Seguridad

• Nunca confirmes tokens de acceso, secretos de cliente de OAuth, archivos .env o archivos stores.json con credenciales.

• Otorga solo los alcances de la API de Shopify Admin necesarios para las tareas previstas.

• Confirma la tienda de destino antes de ejecutar una mutación.

• Consulta SECURITY.md para obtener instrucciones de notificación.

Desarrollo

npm ci
npm test

Licencia

MIT