# Required: Store domain (without protocol)
SHOPIFY_STORE_URL=your-store.myshopify.com
# Required: Admin API access token (from custom app)
# Create in: Shopify Admin > Settings > Apps and development channels > Develop apps
SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Optional: Storefront API access token (for customer-facing operations)
# Enables: product browsing, cart management, customer queries via storefront
SHOPIFY_STOREFRONT_ACCESS_TOKEN=
# Optional: Customer Account API access token
# Enables: customer account operations (orders, addresses, etc.)
SHOPIFY_CUSTOMER_ACCESS_TOKEN=
# Optional: API version (defaults to 2025-01)
SHOPIFY_API_VERSION=2025-01
# ============================================
# Bug Reporting (for development/debugging)
# ============================================
# Enable bug reporting tool (allows agents to report issues)
# Set to "true" to enable the report_bug tool
SHOPIFY_MCP_BUG_REPORTS=false
# Custom directory for bug reports (optional)
# Default: ./.bug-reports/{store-domain}_{hash}_{session}/
# SHOPIFY_MCP_BUG_REPORT_DIR=/path/to/bug-reports
# ============================================
# Database & Logging
# ============================================
# SQLite database path for operation logging and configuration
# Default: file:./mcp.db (relative to project root)
DATABASE_URL=file:./mcp.db
# Enable operation logging (default: true)
MCP_LOG_OPERATIONS=true
# Auto-cleanup logs older than N days (default: 30)
MCP_LOG_RETENTION_DAYS=30
# ============================================
# Rate Limiting
# ============================================
# Shopify tier for rate limiting (auto-detected from shop plan if not set)
# Options: STANDARD, ADVANCED, PLUS, ENTERPRISE
# SHOPIFY_TIER=STANDARD
