Proxy Support

1MCP supports trust proxy configuration for deployment behind load balancers and reverse proxies like nginx, Apache, or Cloudflare.

Overview

When 1MCP runs behind a proxy, it needs to be configured to trust the proxy in order to correctly identify the client's IP address and the protocol (HTTP/HTTPS). This is essential for security features like rate limiting and for accurate logging.

Configuration

Trust proxy settings can be configured via the --trust-proxy command-line flag or the ONE_MCP_TRUST_PROXY environment variable.

For detailed information on the available options and how to configure them in your JSON file, CLI, or environment, please see the Configuration Deep Dive.

For a complete cloud-hosted Admin Console and local CLI target workflow using Caddy, see Cloud Deployment with Caddy.

For specific examples and security considerations, refer to the Trust Proxy Reference.