Connect with Proxy

For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

Connect with Proxy

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

MCP Environment Variables

To establish a connection with proxy configurations, use the following variables when [configuring environment variables](https://www.mongodb.com/docs/mcp-server/local-mcp/configuration/methods.md#std-label-mcp-server-configuration-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 (proxy auto-config) URLs that resolve to one of the previously listed proxies