Devin mit MongoDB verbinden

​

Zwei Ebenen, zwei Identitäten

• Ein Dienstkonto, das Datenbanknutzer anlegen darf (GROUP_OWNER, GROUP_DATABASE_ACCESS_ADMIN), kann sich selbst eine Identität auf der Datenebene ausstellen. Genau das macht der MongoDB-MCP-Server, wenn er eine Verbindung zu einem Cluster herstellen soll (Option B).
• Slow-Query-Daten enthalten die tatsächlichen Werte aus den Abfragen.

​

Verbindungsart für Devin wählen

​

Warum Devin mit MongoDB verbinden?

• Das Schema steckt in den Dokumenten. MongoDB hat kein information_schema, und Mongoose- oder Prisma-Modelle weichen mit der Zeit von den tatsächlich gespeicherten Daten ab. Devin zieht Stichproben aus den Live-Collections und arbeitet mit der realen Struktur.
• Langsame Abfragen werden in einer einzigen Sitzung vollständig behoben. Devin liest den Performance Advisor und das Slow-Query-Log, führt explain() auf der echten Collection aus, findet den Code, der die Abfrage absetzt, und öffnet einen PR mit dem Fix und dem vorgeschlagenen Index.
• Die Rollen des Datenbanknutzers bestimmen, worauf Devin zugreifen darf. Starten Sie in der Produktion schreibgeschützt und nutzen Sie eine devin_dev-Sandbox für Schreibvorgänge. Jede Aktion wird in den Atlas-Logs unter Devins eigener Identität protokolliert.

​

Voraussetzungen

• Ein Projekt mit einem Cluster.
• Organization Owner zum Erstellen eines Dienstkontos; Project Owner für den Datenbanknutzer und die Zugriffslisten.

• Berechtigung zum Bearbeiten des Umgebungs-Blueprints und zum Hinzufügen von Secrets.
• Für die MCP-Varianten die Berechtigung Manage MCP Servers.

• Die IP-Adressen von Devin sind in der IP-Zugriffsliste des Projekts eingetragen (Schritt 1).
• Wenn Sie eine Devin-Netzwerkrichtlinie verwenden, lassen Sie *.mongodb.net und cloud.mongodb.com zu, außerdem die Hosts, von denen der Blueprint Pakete installiert: pgp.mongodb.com und repo.mongodb.org (Option A) bzw. registry.npmjs.org und nodejs.org (Option B). Der Treiber verbindet sich über Port 27017, nicht über 443. Da Richtlinieneinträge Hostnamen oder CIDRs sind, muss kein Port angegeben werden. Für Snapshot-Builds gilt dieselbe Richtlinie.

​

Schritt 1: Netzwerkzugriff freigeben

atlas accessLists create <ip> --type ipAddress --comment "Devin" --projectId <project-id>
atlas accessLists create <cidr> --type cidrBlock --comment "Devin" --projectId <project-id>

​

Schritt 2: Identitäten für Devin erstellen

​

Datenbanknutzer

atlas dbusers create \
  --username devin-sessions \
  --password "<generated-password>" \
  --role read@analytics,read@billing,readWrite@devin_dev \
  --scope <cluster-name> \
  --projectId <project-id>

​

Dienstkonto (nur wenn Devin die Control Plane benötigt)

​

Schritt 3: Devin verbinden

​

Option A: CLI in einem Blueprint

​

1. Devin Secrets hinzufügen

​

2. Blueprint hinzufügen

initialize:
  - name: Install the Atlas CLI and mongosh
    run: |
      curl -fsSL https://pgp.mongodb.com/server-8.0.asc \
        | sudo gpg --batch --yes -o /usr/share/keyrings/mongodb-server-8.0.gpg --dearmor
      echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" \
        | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
      sudo apt-get update
      sudo apt-get install -y mongodb-atlas-cli mongodb-mongosh
      atlas --version && mongosh --version

knowledge:
  - name: mongodb-access
    contents: |
      Connect to MongoDB with `mongosh "$MONGODB_URI"`; the URI is a Devin Secret. The Atlas CLI
      authenticates as a service account from MONGODB_ATLAS_CLIENT_ID and MONGODB_ATLAS_CLIENT_SECRET,
      with MONGODB_ATLAS_PROJECT_ID as the default project. Do not run `atlas auth login`, do not ask
      for a username, password, or API key, and never write the connection string into a file, script,
      log, or PR. Production databases are read-only; write only to the devin_dev database. Ship
      schema, index, and migration changes through a pull request.

​

3. Snapshot erstellen

​

Option B: MongoDB-MCP-Server

• --readOnly registriert keine Create-, Update- und Delete-Tools und lehnt Aggregationen ab, die $out oder $merge enthalten. Ohne diese Option werden solche Aggregationen nach einer Bestätigungsabfrage ausgeführt – oder ganz ohne Bestätigung, wenn der MCP-Client keine Abfragen unterstützt. Verwenden Sie die Option für alles, was auf die Produktionsumgebung zugreift.
• --indexCheck lehnt Abfragen ab, deren Plan einen Collection-Scan vorsieht. Dies ist ein Performance-Guardrail: Schlägt explain selbst fehl, wird die Abfrage trotzdem ausgeführt.

initialize:
  - name: Install Node.js for the MongoDB MCP server
    uses: github.com/actions/setup-node@v4
    with:
      node-version: "22"

​

Option C: MongoDB Atlas-Plugin

1. Ein Organization Owner aktiviert den AI-Client-Zugriff (Organization Settings > App Connections) und setzt den Zugriffsmodus auf Read, damit keine Schreib-Tools registriert werden. Die Einstellung gilt für alle AI-Clients in der Organisation, nicht nur für Devin.
2. Erstellen Sie einen dedizierten Atlas-Nutzer für Devin mit GROUP_READ_ONLY und GROUP_DATA_ACCESS_READ_ONLY – ausschließlich in Projekten, die er lesen darf. GROUP_DATA_ACCESS_READ_ONLY gewährt Lesezugriff auf Dokumente in allen Datenbanken des Projekts und ist damit weiter gefasst als der Nutzer devin-sessions.
3. Installieren Sie das Plugin und führen Sie den OAuth-Login einmalig unter Customize > MCPs durch – angemeldet als dieser Nutzer, nicht als Sie selbst.
4. Pinnen Sie das Plugin an einen Commit an, sobald es funktioniert.

​

Rebuilds und Versions-Pinning

​

Schritt 4: Berechtigungen festlegen

​

Schritt 5: Überprüfen

mongosh "$MONGODB_URI" --quiet --eval 'JSON.stringify(db.runCommand({connectionStatus: 1}), null, 2)'
atlas clusters list --projectId "$MONGODB_ATLAS_PROJECT_ID"

mongosh "$MONGODB_URI" --quiet --eval 'db.getSiblingDB("<prod-db>").devin_probe.insertOne({probe: 1})'
mongosh "$MONGODB_URI" --quiet --eval 'db.getSiblingDB("devin_dev").devin_probe.insertOne({probe: 1}); db.getSiblingDB("devin_dev").devin_probe.drop()'

​

Fehlerbehebung

​

Einschränkungen

​

Support