Docs Menu
Docs Home
/ /

Connect with Proxy

The MongoDB MCP server supports connections to MongoDB deployments and Atlas clusters through proxies.

To establish a connection with proxy configurations, use the following variables when configuring environment variables for the MCP server:

Variable
Description
Example

MONGODB_PROXY

Proxy connections to mongodb:// and mongodb+srv:// URLs, such as database clusters.

The following example sets the MONGODB_PROXY environment variable to proxy all MongoDB connections through a CONNECT proxy located at example.com:8080 with TLS enabled.

export MONGODB_PROXY=socks5://example.com:8080

HTTP_PROXY

Proxy connections to http:// URLs. HTTP connections are mostly used for OIDC authentication.

If you also set HTTPS_PROXY, the value of HTTPS_PROXY takes precedence for all requests.

The following example sets the HTTP_PROXY environment variable to proxy HTTP connections through a HTTP proxy located at example.com:8080:

export HTTP_PROXY=http://example.com:8080

HTTPS_PROXY

Proxy connections to https:// URLs. HTTPS connections are mostly used for OIDC authentication.

If you also set HTTP_PROXY, the value of HTTPS_PROXY takes precedence for all requests.

The following example sets the HTTPS_PROXY environment variable to proxy all HTTPS connections through a HTTPS proxy located at localhost:8080 without TLS:

export HTTPS_PROXY=http://localhost:8080

ALL_PROXY

Proxy all connections to the specified URL.

The following example sets the ALL_PROXY environment variable to proxy all outbound network connections through a Socks5 proxy located at example.com:1234 with credentials included in the URL:

export ALL_PROXY=socks5://username:password@example.com:1234

NO_PROXY

Comma-separated list of hostnames that should be excluded from proxying.

The following example sets the NO_PROXY environment variable to bypass the proxy for connections to localhost and internal-db.example.com.

export NO_PROXY=localhost,internal-db.example.com

Note

The MongoDB MCP Server supports the following proxy types:

  • Socks5 proxies

  • HTTP proxies

  • CONNECT proxies

  • PAC URLs that resolve to one of the previously listed proxies

Back

x.509

On this page