MongoDB Atlas (Managed MCP)
MongoDB’s own Atlas Managed MCP Server (https://mcp.mongodb.com), passed through by
Cendriix. MongoDB owns the tool surface — the Atlas control plane plus the database tools — so a
tool MongoDB ships arrives here without a Cendriix release. There is no connection string and no
IP allowlist.
Overview
| Catalog ID | mcp-mongodb-atlas |
| Upstream server | https://mcp.mongodb.com (operated by MongoDB) |
| Transport | MCP JSON-RPC over Streamable HTTP, protocol 2025-11-25 |
| Auth | Browser consent (OAuth 2.1 + PKCE), or an Atlas remote-MCP client ID/secret |
| Access level | Read-only unless writes are enabled for your environment |
| Blast radius | High — can read business data and Atlas configuration |
| Setup time | ~2 minutes with consent, ~10 with client credentials |
| Regions | us-east-1, eu-west-1 |
Which MongoDB integration do I want?
Cendriix has three, and their credentials are not interchangeable.
| Atlas Managed MCP (this page) | MongoDB MCP | MongoDB Atlas connector | |
|---|---|---|---|
| Runs on | MongoDB’s servers | Cendriix’s proxy, native driver | Cendriix ingest |
| Purpose | Atlas control plane and data | Query data on any reachable cluster | Ingests cluster metadata into Cortex |
| Credential | Consent, or remote-MCP client ID/secret | mongodb+srv://… connection string | Atlas Admin API key pair |
| Networking | None to configure | Atlas IP access list required | None |
| Self-managed clusters | No — Atlas only | Yes, if publicly reachable | No |
Pick this page’s integration for Atlas. Use the connection-string MCP for self-managed clusters, or for Atlas clusters you do not want to expose to Atlas’s own delegated-access platform.
Prerequisite: enable AI client access in Atlas
Atlas disables AI client access by default for existing organizations, and for new organizations created by an existing Atlas user. Until an Organization Owner enables it, Atlas rejects the consent request with “This authorization request is invalid” — before it ever looks at Cendriix.
An Organization Owner must:
- Open Organization Settings → App Connections in the Atlas UI.
- Set the access mode: Read (recommended) or Read and write.
- Save.
Notes worth knowing before you enable it:
- The mode applies to the whole organization; Atlas has no per-user, per-cluster, or per-client setting. Enabling it enables every current and future AI client that supports delegated access.
- Effective access is the more restrictive of the org mode and the authorizing user’s own Atlas permissions. The mode can only reduce access, never widen it.
- In Read mode, write tools are not registered at all — the agent cannot see them.
- The authorizing user needs one of
ORG_OWNER,GROUP_OWNER,GROUP_DATA_ACCESS_ADMIN,GROUP_DATA_ACCESS_READ_WRITE,GROUP_DATA_ACCESS_READ_ONLY, orGROUP_STREAM_PROCESSING_OWNER. - Atlas ends delegated access after 7 days of inactivity or 30 days from consent, whichever comes first; Cendriix then asks you to reconnect. An Organization Owner can shorten that maximum lifetime.
- An Organization Owner cannot revoke one user’s connection — only disable AI client access for the whole organization. Individual users revoke their own from Atlas, or from Cendriix.
Setup — browser consent (recommended)
- Go to Settings → Integrations → MCPs → MongoDB Atlas (Managed MCP).
- Choose who the connection is for:
- Just me — every call is attributed to you in the Atlas audit log, bounded by your own Atlas permissions.
- Everyone in this workspace — what schedules, triggers, and unattended agents use, since they cannot open a browser.
- Click Connect with MongoDB. Atlas signs you in and shows a consent screen.
- Authorize. You land back in Cendriix with the connection shown as Connected, including who connected it, when, and when it expires.
Tokens are envelope-encrypted with your tenant key, refreshed automatically five minutes before expiry, and never returned by any API. See Connect an MCP with OAuth for the mechanics, per-user vs workspace precedence, and error reasons.
Setup — Atlas remote-MCP client credentials
Use this when you want a non-interactive service identity, or your organization has not enabled App Connections. Requires Atlas CLI 1.58.0 or later.
atlas auth login
# One organization (or use createGroupMcpConfig for a single project).
# Scope roles read-only — that Atlas grant, not Cendriix, is the real ceiling.
atlas api remoteMcpConfigurations createOrgMcpConfig
# Atlas returns the secret ONCE. Lose it and you generate a new one.
atlas api remoteMcpConfigurations createOrgMcpSecret \
--secretExpiresAfterHours 8760Paste the pair into the install panel as MDB_MCP_API_CLIENT_ID and
MDB_MCP_API_CLIENT_SECRET. Cendriix exchanges them for a short-lived Atlas access token per
call and never stores a token.
Precedence: when both exist, a grant wins — your own first, then the workspace-wide one, then the pasted client credentials. This is deliberate: user-delegated calls are attributed to a human in Atlas’s audit log, which a shared service account cannot do.
Tools
MongoDB owns this list; Cendriix passes it through. Run a connect tool first — the database tools
operate on a connectionId, not a pasted URI.
| Group | Tools |
|---|---|
| Connect | remote-atlas-connect |
| Data | find, aggregate, aggregate-db, count, list-databases, list-collections |
| Schema & storage | collection-schema, collection-indexes, collection-storage-size, db-stats, mongodb-logs |
| Atlas control plane | atlas-list-orgs, atlas-list-projects, atlas-list-clusters, atlas-inspect-cluster, atlas-inspect-access-list, atlas-list-db-users, atlas-list-alerts, atlas-get-performance-advisor |
| Knowledge | search-knowledge (MongoDB Assistant knowledge base) |
Tool names are MongoDB’s hyphenated names, so anything written for the official server works here unchanged.
Read-only enforcement
Two independent layers, plus Atlas’s own:
- Cendriix refuses any tool outside the read set with
403 write_disabledand makes zero outbound requests, unless writes are enabled for the environment. - Atlas registers only read tools when the organization’s access mode is Read.
- Your Atlas roles bound everything above — scope the remote-MCP configuration, or the authorizing user, to read-only roles.
MongoDB labels
aggregate,aggregate-db, andexportas read tools even though a$outor$mergestage in a pipeline writes. Read-only Atlas roles are the only hard guarantee.
Rotation and revocation
| Action | How |
|---|---|
| Disconnect a consent-based connection | Disconnect in the install panel — the grant is deleted locally and revoked at Atlas |
| Reconnect after expiry | The panel shows Re-authentication needed; click Reconnect |
| Rotate client credentials | Generate a new Atlas MCP secret, then submit the new pair |
| Kill all AI client access org-wide | Atlas → Organization Settings → App Connections → Disabled |
Every tool invocation is recorded in the Cendriix Audit Log, and Atlas records its own audit events attributed to the authorizing user.
Troubleshooting
| Message | Cause | Fix |
|---|---|---|
| ”This authorization request is invalid” (Atlas page) | AI client access is disabled for the organization | An Organization Owner enables App Connections in Read mode |
| Atlas 404s the App Connections page | You are not an Organization Owner | Find one under Organization → Access Manager |
401 reauth_needed on a tool call (409 from the OAuth routes) | The grant expired (7d idle / 30d max) or was revoked | Reconnect |
403 write_disabled | A non-read tool was called | Expected — enable writes for the environment only if intended |
503 feature_disabled | Managed Atlas MCP is off for this environment | Contact Cendriix support |
400 naming an expected credential shape | A connection string or Admin API key pair was pasted | This MCP takes a remote-MCP client ID/secret, or consent |
| Tools missing that Atlas documents | The org access mode hides write tools, or your Atlas role is narrower | Expected — widen only if intended |
| Self-managed cluster not listed | Atlas-only server | Use the MongoDB MCP or BYO MCP with cendriix-mcp-tunnel |
Further reading
- Connect an MCP with OAuth — the shared consent capability
- MongoDB MCP — the connection-string integration
- MongoDB Remote MCP Server — MongoDB’s docs
- Atlas App Connections — MongoDB’s delegated-access platform