Sazabi
Sandbox CLIs

MongoDB Atlas

Give the Sazabi agent the MongoDB Atlas CLI (atlas) in its sandbox to manage Atlas clusters, databases, and projects.

About

This CLI connection makes the MongoDB Atlas CLI (atlas) available in the Sazabi agent's sandbox. The agent can manage Atlas clusters, databases, and projects using an Atlas API key pair. The tool is baked into the sandbox image; connecting it authenticates the already-installed CLI.

Prerequisites

  • A Sazabi project.
  • A MongoDB Atlas public API key (MONGODB_ATLAS_PUBLIC_API_KEY) and private API key (MONGODB_ATLAS_PRIVATE_API_KEY).

Set up in the dashboard

Configure the sandbox in the dashboard under Settings > Sandbox CLIs.

Find MongoDB Atlas in the catalog

In Settings > Sandbox CLIs, find MongoDB Atlas under Browse sandbox CLIs and choose to connect it.

Provide credentials

Enter the required values: MONGODB_ATLAS_PUBLIC_API_KEY — your Atlas API public key; MONGODB_ATLAS_PRIVATE_API_KEY — your Atlas API private key. Optionally set MONGODB_ATLAS_ORG_ID to default to a specific organization and MONGODB_ATLAS_PROJECT_ID to default to a specific project. Save to store them securely; Sazabi injects them into the sandbox when the agent runs.

Set up with the CLI

You can also configure the MongoDB Atlas CLI connection with the Sazabi CLI (installed and authenticated — see CLI reference).

sazabi sandbox-clis set --type atlas --env MONGODB_ATLAS_PUBLIC_API_KEY=<your-public-key> --env MONGODB_ATLAS_PRIVATE_API_KEY=<your-private-key>

To validate the credentials without saving, run the same command with test in place of set (the test command also requires the --env flags).

Verify

Ask the agent, in a thread, to run the atlas CLI (for example atlas projects list) and confirm it returns real output from your account. If the command is not found, the CLI connection may not be enabled; if it runs unauthenticated, recheck the credentials.

Troubleshooting

Command not found — Confirm the MongoDB Atlas CLI connection is enabled for the project under Settings > Sandbox CLIs.

Authentication fails — Recheck the credential values; a rotated or revoked token must be re-entered under Settings > Sandbox CLIs or with sazabi sandbox-clis set --type atlas.

Further reading