For AI agents: a documentation index is available at https://www.mongodb.com/docs/llms.txt — markdown versions of all pages are available by appending .md to any URL path.

Troubleshoot Atlas Managed MCP Configurations

Use the information on this page to resolve errors that you encounter when you create or update a MongoDB Atlas Managed MCP Server configuration.

The Atlas UI or the Atlas Administration API returns the following error:

Failed to update the MCP configuration and the partial update could not be fully reverted. The configuration may be in an inconsistent state.

This error means that Atlas applied part of your update and did not apply the rest. One field reflects the value that you requested, while another field keeps its previous value.

To resolve this error, wait a few minutes, then retry the update. If the error persists, contact MongoDB Support.

The Atlas UI reports that it created the MCP configuration without a client secret.

Atlas created the configuration, but did not generate its client secret. The configuration is still usable, and you can generate a client secret for it at any time.

To generate a client secret for an existing configuration:

1

In the Atlas Managed MCP card on the Service Accounts page, click the ellipsis (...) icon in the configuration's row, then click View Details.

2

Click Generate new client secret, then select an expiration.

Important

Atlas displays the client secret only once. Copy it and store it in a secure location.

If secret generation continues to fail, contact MongoDB Support.