Skip to content
GitHub (opens in a new tab)

MongoDB-compatible · Integration guide

How to connect Firestore with MongoDB compatibility to any AI IDE (Claude/Codex/Cursor/VS Code/Antigravity)

Before you start, install GateRook and connect it to your AI development environment: Claude Desktop, Codex, Cursor, Antigravity or VS Code.

Connect your AI app

Firestore with MongoDB compatibility uses GateRook’s MongoDB connector. With the database's connection string and its credentials.

The screenshots show GateRook 2.0.0: the Firestore with MongoDB compatibility form, the endpoint selector, and this connector’s actual tool preview. The form and preview have not been saved. Select a screenshot to open it at full size.

1. Create a connection and enter the settings

In GateRook, open Connections, select Add connection, search for Firestore with MongoDB compatibility, choose its card and select Continue to configure.

Use a Firestore database created with MongoDB compatibility. Copy its base MongoDB connection string from the database's Explorer panel; the database UID in the hostname differs from the database ID in the path.

Create a database user credential under Security and give its principal the required database access. Save the generated password when it is shown. This setup uses SCRAM credentials, rather than an interactive Google sign-in.

Enter a Name, for example firestore-mongodb-demo. Your AI app uses this name to choose the connection.

Choose Connection string under Connect using. Paste the credential-free base URI, preserving port 443, the database-ID path and loadBalanced=true&tls=true&retryWrites=false.

Enter the generated User and Password. In Advanced, choose SCRAM-SHA-256 for Mechanism and set Auth database to the database ID from the connection string. Do not add authMechanism to the URI; GateRook has a separate field for it.

Select TLS for Connection type, then use Load databases and select the intended Databases. Restrict Collections the agent may read to the required collections.

Choose Development, Staging or Production to match the service. Review the connector’s limit and access settings before continuing.

GateRook 2.0.0 Configure Firestore with MongoDB compatibility form before saving.
The Firestore with MongoDB compatibility configuration form. Enter your own connection settings before testing.

2. Test the connection and add it to an endpoint

Select Continue to test. GateRook checks the settings from your computer. Review the result and resolve any connection, certificate or permission error before continuing.

Check the database UID, location and database ID independently if the endpoint cannot be reached. Authentication and permission errors can have different causes: a generated user credential also needs an IAM grant on the intended database.

After the test passes, select Continue to add to an endpoint. Choose the endpoint your AI app uses, review its tool modes, then select Save connection. GateRook offers default as the starter endpoint.

GateRook endpoint selector with default selected; no connector tool list is shown.
Choose the endpoint your AI app uses. This selector is shared across connector types; the next screenshot shows this connector’s own tools.

3. Use the connection from your AI IDE

After saving Firestore with MongoDB compatibility on the endpoint and passing its connection test, ask your AI app to use firestore-mongodb-demo, or the name you chose. If its tools are missing, confirm the endpoint assignment and refresh the MCP connection or start a new chat.

The preview below shows this connector’s default tools before saving. The table explains what each tool can do; connection settings, credentials and endpoint policies can restrict access further.

Firestore with MongoDB compatibility connector tool names and default modes in the GateRook 2.0.0 endpoint preview.
Firestore with MongoDB compatibility tools in the Development endpoint preview. This is an unsaved preview, not a successful service call.

Start with a small read request. Replace example resource names with existing resources your connection may access. Open Activity after the call to inspect its connection, tool, arguments, policy decision and result metadata.

Ask your AI, for example

  • “List the permitted databases and collections without changing anything.”
  • “Inspect the fields and indexes of the orders collection, if it exists.”
  • “Show at most 10 recent order documents, returning only status and creation time.”
Tools your AI gets
ToolWhat it doesStarts as
mongo_findFind documents with a filter and a projection.Read only
mongo_aggregateRun an aggregation pipeline. $out and $merge are refused.Read only
mongo_updateUpdate the first document matching a filter. Supports update operators or an update pipeline; upsert is optional.Approval
mongo_update_manyUpdate all documents matching a filter. The read document limit does not cap updates. Supports update operators or an update pipeline; upsert is optional.Approval

You can change each tool’s mode on the endpoint. Every call your AI makes appears in Activity.

Service documentation

Keep exploring

MongoDB

Connect MongoDB to Claude, Codex, Cursor, VS Code or Antigravity in three steps. Your AI finds and aggregates documents; updates need your approval.

MongoDB Atlas

Connect MongoDB Atlas to Claude, Codex, Cursor, VS Code or Antigravity with GateRook. Follow setup, connection testing and tool access with screenshots.

Amazon DocumentDB

Connect Amazon DocumentDB to Claude, Codex, Cursor, VS Code or Antigravity with GateRook. Follow setup, connection testing and tool access with screenshots.

Browse all integration guides

Your local MCP gateway and firewall.

Connect Firestore with MongoDB compatibility to your AI IDE.

Choose a connector. Start with read-only access. Approve changes and inspect the audit trail.

Read the getting started guide

Get GateRook

Download GateRook 2.0.0 for your Mac, or get the Windows app from Microsoft Store.

macOS

Version 2.0.0 for Apple Silicon (arm64). This download does not support Intel Macs.

Open the DMG and drag GateRook to Applications.

Windows

Available for free from Microsoft Store. Install GateRook and receive updates through the Store.

macOS release notes and checksums (opens in a new tab)