.env.example

# Environment variables for MagicTunnel
# Copy this file to .env and set your actual values
# 
# IMPORTANT: Most configuration should be done in config.yaml files
# Use environment variables only for secrets and environment-specific overrides
# 
# Precedence: .env < config.yaml < environment variables < CLI arguments

# ======================================================================
# REQUIRED: LLM API KEYS
# ======================================================================

# OpenAI API Key for Smart Discovery (REQUIRED)
OPENAI_API_KEY=sk-your-openai-key-here

# Alternative LLM providers (uncomment to use)
# ANTHROPIC_API_KEY=sk-ant-your-anthropic-key-here
# OLLAMA_BASE_URL=http://localhost:11434

# ======================================================================
# OPTIONAL: Environment-Specific Overrides
# ======================================================================

# Override log level if needed (config.yaml takes precedence)
# MCP_LOG_LEVEL=debug

# Override server port if needed (config.yaml takes precedence)
# MCP_PORT=3001

# Override TLS mode if needed (config.yaml takes precedence)
# MCP_TLS_MODE=disabled

# ======================================================================
# SECURITY: TLS Certificates (if using TLS)
# ======================================================================

# TLS certificate paths (only if using TLS)
# MCP_TLS_CERT_FILE=/path/to/cert.pem
# MCP_TLS_KEY_FILE=/path/to/key.pem
# MCP_TLS_CA_FILE=/path/to/ca.pem

# ======================================================================
# USAGE EXAMPLES
# ======================================================================

# Example 1: Basic setup (minimal)
# OPENAI_API_KEY=sk-your-key

# Example 2: With different LLM
# OPENAI_API_KEY=sk-your-key
# ANTHROPIC_API_KEY=sk-ant-your-key

# Example 3: With port override
# OPENAI_API_KEY=sk-your-key
# MCP_PORT=3001

# ======================================================================
# FULL CONFIGURATION REFERENCE
# ======================================================================

# For complete configuration options, see:
# - config.yaml or magictunnel-config.yaml files
# - ENV_SETUP.md for environment-specific setup
# - Documentation for all available environment variables

# All environment variables (commented out - use config.yaml instead):
# MCP_HOST=127.0.0.1
# MCP_PORT=3000
# MCP_WEBSOCKET=true
# MCP_TIMEOUT=30
# MCP_TLS_MODE=disabled
# MCP_LOG_LEVEL=info
# MCP_LOG_FORMAT=text
# MCP_LOG_FILE=./logs/magictunnel.log
# MCP_REGISTRY_TYPE=file
# MCP_REGISTRY_PATHS=./capabilities,./data
# MCP_HOT_RELOAD=true
# EXTERNAL_MCP_ENABLED=false
# EXTERNAL_MCP_REFRESH_INTERVAL=60
# CONTAINER_RUNTIME=docker
# CONFLICT_RESOLUTION_STRATEGY=prefix
# CONFLICT_RESOLUTION_LOCAL_PREFIX=local_
# CONFLICT_RESOLUTION_PROXY_PREFIX_FORMAT={proxy_name}_
# CONFLICT_RESOLUTION_LOG_CONFLICTS=true
# CONFLICT_RESOLUTION_INCLUDE_METADATA=true