程式庫預設設定適合簡單的單一執行個體部署：控制平面可以使用 SQLite，程序內狀態則可使用 Memory provider。
正式對外服務前，請明確設定外部 URL、密鑰與持久化儲存位置。
公開 MCP URL
把 MCP_PUBLIC_ENDPOINT 設成 MCP 用戶端真正能連到、且包含 /mcp 的 URL：
MCP_PUBLIC_ENDPOINT=https://sql-agent.example.com/mcp不要假設它一定和管理介面使用相同來源（origin）；反向代理可能把兩者配置在不同主機、連接埠或路徑。
密鑰與憑證
把範例中的 HMAC / JWT 密鑰換成彼此獨立、至少 32 bytes 的唯一值。資料庫憑證、SMTP 憑證、OIDC 用戶端密鑰、webhook 簽章密鑰與 Redis 連線字串都不應提交到版本控制。
持久保存控制平面狀態
預設 SQLite 管理資料庫位於 /app/data。如果使用內嵌的本機控制平面，容器被替換後仍必須保留這些資料。
如果 OIDC / TOTP 或其他受保護狀態使用 ASP.NET Core data protection，也要持久保存 DATA_PROTECTION_KEY_PATH；遺失金鑰資料可能讓既有 MFA 或登入狀態無法讀取。
可觀測性
Prometheus 可以在獨立監聽端點啟用；範例使用 9000，和主要 API 連接埠分開。也可以透過 OTLP_ENDPOINT 設定 OpenTelemetry Collector，並使用 OTEL_SERVICE_NAME 指定服務名稱。
若要部署多個執行個體，請改看 分散式部署。