.env.example•2.63 kB
###############################################
# Amazon Ads MCP — .env example (complete)
# Copy to .env and customize for your setup
###############################################
# ------------------------
# Server/runtime settings
# ------------------------
# These are consumed by docker-compose to pass CLI args to the server.
# The server reads LOG_LEVEL directly; PORT is also used for OAuth redirect.
TRANSPORT=http # stdio | http | streamable-http
HOST=0.0.0.0
PORT=9080
LOG_LEVEL=INFO # DEBUG | INFO | WARNING | ERROR | CRITICAL
# OpenAPI parser mode (automatically set by server, but can be overridden)
# FASTMCP_EXPERIMENTAL_ENABLE_NEW_OPENAPI_PARSER=true
# ------------------------
# Authentication selection
# ------------------------
# Choose one provider: direct (BYOA) or openbridge
AUTH_METHOD=direct # direct | openbridge
# Direct Amazon Ads API authentication (BYOA)
# Supply all three to enable direct auth. You may also set a default
# profile scope for API requests.
#
# AMAZON_AD_API_CLIENT_ID=amzn1.application-oa2-client.xxxxx
# AMAZON_AD_API_CLIENT_SECRET=xxxxxxxxxxxxxxxx
# AMAZON_AD_API_REFRESH_TOKEN=Atzr|IwEBxxxxxxxxxxxxxxxx
# Optional default scope/profile id (also accepts AD_API_PROFILE_ID or AMAZON_ADS_PROFILE_ID)
# AMAZON_AD_API_PROFILE_ID=1234567890
# OpenBridge authentication
# Provide a refresh token in key:secret format. Optionally set a default
# remote identity id to auto-select after startup.
# OPENBRIDGE_REFRESH_TOKEN=xxxxxx
# ------------------------
# Region & API base
# ------------------------
# Regional routing for direct auth; OpenBridge routes per identity at runtime.
# AMAZON_ADS_REGION=na # na | eu | fe (sets a default region on startup)
# ------------------------
# Amnazon Ads API resources control
# ------------------------
# Restrict loaded API namespaces via allowlist. Accepts comma-separated namespaces
# Examples: "ads-accounts,profiles" or alias groups like "sponsored"
# AMAZON_AD_API_PACKAGES="ads-accounts,profiles"
# ------------------------
# Token persistence
# ------------------------
# Enable persistent refresh token storage (recommended). Change cache dir for Docker.
AMAZON_ADS_TOKEN_PERSIST=true
# Docker typical: /app/.cache/amazon-ads-mcp; Local default: ~/.amazon-ads-mcp/tokens.json
# AMAZON_ADS_CACHE_DIR=/app/.cache/amazon-ads-mcp
# ------------------------
# Downloads (exports/reports)
# ------------------------
# Base directory for downloaded exports/reports. Defaults to ./data when unset.
# For Docker, mount a volume and point this there.
# AMAZON_ADS_DOWNLOAD_DIR=/app/data