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 |
|---|
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 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:
PAC URLs that resolve to one of the previously listed proxies