MongoDB MCP einrichten: Verbindung und Read-only prüfen

Ein MongoDB-MCP-Zugang sollte mit einer konkreten Datenbank und Collection beginnen. Bereiten Sie ein unkritisches Testdokument vor und notieren Sie dessen Kennung sowie zwei erwartete Felder. Nutzen Sie einen Datenbankbenutzer mit passenden Leserechten. Ein Clustername allein reicht für den späteren Abgleich nicht aus: Mehrere Datenbanken können gleich benannte Collections enthalten.

Drei Angaben vor dem Start

MongoDB dokumentiert das Paket mongodb-mcp-server, die Variable MDB_MCP_CONNECTION_STRING und den Schalter --readOnly. Die offizielle Beispielkonfiguration verwendet den Leseschalter. Er ersetzt nicht die Auswahl eines begrenzten Datenbankbenutzers. Planen Sie eine spätere Schreibaufgabe separat und erweitern Sie die Rechte nicht bloß, um eine unklare Fehlermeldung loszuwerden.

VS Code: Verbindungszeichenfolge verdeckt eingeben

Ergänzen Sie .vscode/mcp.json im vorgesehenen Arbeitsbereich. Das Beispiel fragt die Verbindungszeichenfolge als verdeckte Eingabe ab und übergibt sie an den Serverprozess. Ersetzen Sie die Eingabeaufforderung nicht durch ein Passwort in einer geteilten Datei. Node.js und npx müssen für den gestarteten Prozess verfügbar sein. Prüfen Sie außerdem, ob Ihre Netzfreigaben diesen Rechner mit dem gewählten Cluster verbinden lassen.

{
  "inputs": [
    {
      "id": "mongodb-uri",
      "type": "promptString",
      "description": "MongoDB connection string",
      "password": true
    }
  ],
  "servers": {
    "mongodb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server@latest",
        "--readOnly"
      ],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "${input:mongodb-uri}"
      }
    }
  }
}

Die verdeckte Eingabe schützt die Anzeige im Dialog; der Serverprozess erhält den Verbindungswert trotzdem. Übernehmen Sie ihn nicht in Tickets, Screenshots oder öffentliche Suchfelder. Bei bestehenden inputs ergänzen Sie den neuen Eintrag mit einer eindeutigen Kennung. Weitere Hinweise finden Sie in den Anleitungen zu Umgebungsvariablen und VS Code.

Ein Dokument statt der ganzen Datenbank lesen

1. Öffnen Sie das vorbereitete Dokument selbst und halten Sie Datenbank, Collection, Kennung und erwartete Feldwerte fest.

2. Starten Sie MCP mit --readOnly. Prüfen Sie die angebotenen Funktionen und ob der Server die Verbindung tatsächlich herstellen konnte.

3. Lesen Sie genau das bekannte Dokument mit einem engen Filter und einer kleinen Ergebnismenge. Fordern Sie nur die Felder an, die für den Test nötig sind.

4. Vergleichen Sie Kennung und Werte mit Ihrer Notiz. Prüfen Sie bei mehreren Ergebnissen die Filterbedingung, bevor Sie einen Bericht daraus erstellen.

Fehler an der passenden Ebene eingrenzen

Ein Startfehler betrifft zunächst den lokalen Prozess. Eine fehlgeschlagene Anmeldung führt zur Verbindungszeichenfolge, dem Datenbankbenutzer und dem Authentifizierungsbereich. Bei einer leeren Ergebnismenge prüfen Sie dagegen zuerst Datenbank, Collection und Filter. Beachten Sie den Typ der Dokumentkennung: Ein Text und ein ObjectId können unterschiedlich behandelt werden. Der Datenbank-Assistent hilft, den Prüfumfang festzuhalten; der Fehler-Navigator trennt Start und Zugriff.

Halten Sie nach einer erfolgreichen Probe das verwendete Paket, die Version und den Testumfang ohne Geheimnisse fest. Wiederholen Sie denselben Lesetest nach einem Versionswechsel. Die MongoDB-Registersuche zeigt auch andere Implementierungen, deren Einstellungen abweichen können. In der App-Auswahl für Daten finden Sie weitere Datenbank- und Dateianleitungen.

Ist der Connection String eine öffentliche MCP-Adresse?

Nein. Er verbindet den Serverprozess mit MongoDB und kann Zugangsdaten enthalten.

Ersetzt --readOnly einen begrenzten Datenbankbenutzer?

Nein. Prüfen Sie den Werkzeugmodus und die Rechte des verwendeten Datenbankzugangs getrennt.

Beweist eine leere Antwort, dass die Collection leer ist?

Nein. Prüfen Sie Datenbank, Collection, Filter und den Datentyp der gesuchten Kennung.

Ist das ein gehosteter MCP-Server?

Das Beispiel startet das offizielle Paket lokal per stdio. Der Datenbankserver kann trotzdem entfernt liegen.

Herstellerquellen geprüft am 2. Oktober 2026. Die Testabläufe sind redaktionelle Vorschläge.

1. MongoDB: MCP server and configuration
   Abrufbefehl anzeigen

   curl -s https://github.com/mongodb-js/mongodb-mcp-server
2. VS Code: MCP configuration and input variables
   Abrufbefehl anzeigen

   curl -s https://code.visualstudio.com/docs/copilot/customization/mcp-servers

Alle Beiträge