@anton.andrusenko/shopify-mcp-admin 2.0.2 → 2.1.0

package/README.md

@@ -100,6 +100,8 @@ SHOPIFY_CLIENT_SECRET=xxxxx
 
 Tokens are automatically refreshed every 24 hours.
 
+> **Remote mode note (multi-tenant):** Shops connected via OAuth now support **expiring offline tokens with automatic refresh** (Shopify Dec 2025 refresh tokens). See `docs/TOKEN-REFRESH-IMPLEMENTATION.md`.
+
 ### Which Should I Use?
 
 | Scenario | Method |
@@ -428,6 +430,52 @@ cd ~/LibreChat && git pull && docker compose pull && docker compose up -d
 
 > 📄 **Advanced Configuration:** See `librechat.yaml.example` for multi-store setups, role presets, and HTTP/SSE transport modes.
 
+### Production Deployment (Admin-Only Access)
+
+LibreChat can be deployed alongside your production MCP server with admin-only access. The deployment is integrated into the main workflow:
+
+1. **Configure LibreChat** in your `.env.deploy` file:
+   ```bash
+   LIBRECHAT_ADMIN_EMAILS=admin@example.com,admin2@example.com
+   LIBRECHAT_DOMAIN=chat.shopify-mcp.com
+   ```
+
+2. **Deploy with the main script** — LibreChat is automatically configured:
+   ```bash
+   ./DEPLOY-NOW.sh
+   ```
+
+The integrated deployment will:
+- ✅ Configure admin-only access (email whitelist)
+- ✅ Set up MCP server connection with your production API key
+- ✅ Configure AI model endpoints (OpenAI, Anthropic, Google, Groq)
+- ✅ Users provide their own LLM API keys in the UI
+
+📖 **Full Guide**: See [LibreChat Production Deployment](./docs/LIBRECHAT-PRODUCTION-DEPLOYMENT.md)  
+📖 **Model Setup**: See [LibreChat Models Setup](./docs/LIBRECHAT-MODELS-SETUP.md)
+
+### Testing with Remote Production Server
+
+To connect LibreChat to your **remote production MCP server** (instead of running locally):
+
+1. **Get API Key**: Visit your production dashboard (e.g., `https://shopify-mcp.com/app`) → Settings → API Keys
+2. **Configure LibreChat**: Update `librechat.yaml` with production server URL:
+
+```yaml
+mcpServers:
+  shopify-mcp-production:
+    type: streamable-http
+    url: https://shopify-mcp.com/mcp
+    headers:
+      Authorization: "Bearer sk_live_YOUR_API_KEY_HERE"
+    timeout: 60000
+    serverInstructions: true
+```
+
+3. **Restart LibreChat**: `docker compose restart api`
+
+📖 **Full Guide**: See [LibreChat Production Testing Guide](docs/LIBRECHAT-PRODUCTION-TESTING.md) for detailed instructions, troubleshooting, and security best practices.
+
 ---
 
 ## 🌐 OpenAI/ChatGPT Integration
@@ -1270,6 +1318,14 @@ SERVER_MODE=remote npm start
 - **Forms:** React Hook Form + Zod validation
 - **Auth:** Session cookies with automatic expiry handling
 
+### Shopify Token Refresh (Remote Mode)
+
+When shops are connected via OAuth in remote mode, the server stores **expiring offline tokens** (access + refresh token) and refreshes access tokens automatically before they expire.
+
+- **Legacy compatibility:** Existing non-expiring tokens continue to work; shops upgrade to refreshable tokens on reconnect.
+- **DB migration required:** Ensure Prisma migrations are deployed in production before rolling out the server.
+- **Details:** See `docs/TOKEN-REFRESH-IMPLEMENTATION.md`.
+
 ---
 
 ## 🤝 Contributing
@@ -1354,6 +1410,9 @@ The guide includes:
 - **Database Setup**: Prisma migrations and backup strategy
 - **Staging Environment**: Separate staging deployment configuration
 - **Monitoring**: Sentry error tracking and uptime monitoring setup
+- **LibreChat Integration**: Automatically deployed with admin-only access (optional)
+
+**Quick Deploy**: Run `./DEPLOY-NOW.sh` - LibreChat is included automatically if configured in `.env.deploy`
 
 ### Production URLs
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anton.andrusenko/shopify-mcp-admin",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "MCP server for Shopify Admin API - enables AI agents to manage Shopify stores with 79 tools for products, inventory, collections, content, SEO, metafields, markets & translations",
   "type": "module",
   "main": "./dist/index.js",