CockroachDB Cloud MCP Server

Der CockroachDB Cloud MCP Server ist der gehostete Zugang von Cockroach Labs, über den KI-Assistenten wie Claude Code oder Cursor mit Clustern in CockroachDB Cloud arbeiten können. Anders als der lokale CockroachDB MCP Server für selbst betriebene Cluster müssen Sie nichts installieren: Der Assistent verbindet sich über das Netz mit dem Endpunkt https://cockroachlabs.cloud/mcp. Die Beschreibung hier stützt sich auf die offizielle Dokumentationsseite des Herstellers; Aussagen darüber sind entsprechend laut Anbieter.

Was ist der CockroachDB Cloud MCP Server?

CockroachDB ist eine verteilte SQL-Datenbank, und CockroachDB Cloud ist ihre gehostete Variante. MCP ist ein offener Standard, über den ein Assistent Werkzeuge eines externen Dienstes aufruft. Der Cloud-Server übersetzt diese Aufrufe in Operationen gegen Ihre Cluster und nutzt dafür das HTTP-Transportverfahren über HTTPS. Damit eignet er sich für Teams, die ihre Datenbank ohnehin bei Cockroach Labs betreiben lassen und keinen eigenen Server pflegen wollen.

Welche Werkzeuge stehen zur Verfügung?

Laut Dokumentation gibt es neun lesende Werkzeuge: Cluster auflisten und abrufen, Datenbanken und Tabellen auflisten, das Schema einer Tabelle lesen, SELECT-Abfragen ausführen, Ausführungspläne mit EXPLAIN erzeugen, Anweisungen anzeigen und laufende Abfragen einsehen. Dazu kommen drei schreibende Werkzeuge: Datenbanken anlegen, Tabellen anlegen und Zeilen einfügen. Änderndes oder löschendes SQL wird in der Werkzeugliste nicht genannt.

Anmeldung und Zugriffsrechte

Es gibt zwei Wege. Empfohlen ist OAuth: Sie melden sich in der CockroachDB-Cloud-Konsole an, wählen die Organisation und legen fest, ob der Assistent nur lesen, nur schreiben oder beides darf. Alternativ senden Sie den geheimen Schlüssel eines Dienstkontos als Bearer-Token im Header Authorization; dann bestimmen die Rollen des Dienstkontos, was erlaubt ist. Benötigt wird eine der Rollen Cluster Admin, Cluster Operator oder Cluster Data Accessor auf den Ziel-Clustern. Eigene Clients müssen zusätzlich von einer Organisationsadministration für die Weiterleitungs-URL freigeschaltet werden. Mit einem optionalen Header mcp-cluster-id lässt sich die Verbindung auf ein einziges Cluster beschränken; Aufrufe auf andere Cluster scheitern dann.

Wofür ist er besonders nützlich?

Der Nutzen liegt darin, dass ein Assistent Ihr Cloud-Cluster erkunden kann, ohne dass jemand Verbindungszeichenfolgen und Zertifikate verteilt. Er liest das Schema, schlägt Abfragen vor, prüft sie mit EXPLAIN und hilft bei der Suche nach langsamen laufenden Abfragen. Weil Cluster, Datenbanken und Tabellen über denselben Endpunkt erreichbar sind, eignet sich der Server auch für Teams mit mehreren Clustern.

Einrichtung

Tragen Sie den Endpunkt im MCP-Client als HTTP-Server ein und schließen Sie bei der ersten Verbindung die OAuth-Anmeldung ab. Für Automatisierung legen Sie ein Dienstkonto mit knappen Rollen an und hinterlegen dessen Schlüssel als Bearer-Token. Beginnen Sie laut Dokumentation mit einem Staging-Cluster, weil KI-Werkzeuge mit Zugriff auf ein Cluster in Ihrem Namen Operationen ausführen können.

Sicherheit und Grenzen

Wählen Sie bei OAuth nur den Lesezugriff, wenn der Assistent nichts verändern soll, und vergeben Sie Dienstkonten die kleinstmögliche Rolle. Beschränken Sie die Verbindung mit mcp-cluster-id auf ein Cluster. Abgefragte Daten gelangen in den Kontext des KI-Clients und damit zum Modellanbieter. Die Dokumentation sagt nichts zu einem Vorschau-Status; prüfen Sie den Stand vor dem Produktiveinsatz.

Kosten

Die Dokumentationsseite nennt keine eigene Gebühr für den MCP-Server. Voraussetzung ist ein CockroachDB-Cloud-Cluster, dessen Kosten sich nach dem gewählten Tarif richten; aktuelle Konditionen stehen auf der offiziellen Preisseite von Cockroach Labs. Hinzu kommen die Kosten Ihres KI-Clients.

Für wen lohnt sich der CockroachDB Cloud MCP Server?

Er lohnt sich für Teams, die CockroachDB Cloud nutzen und Schemaarbeit, Abfrageanalyse und Fehlersuche per Assistent beschleunigen wollen, ohne einen lokalen Server zu betreiben. Wer selbst betriebene Cluster hat, nimmt stattdessen den lokalen CockroachDB MCP Server. Ohne Cluster in der Cloud bringt dieser Server nichts.

Ein CockroachDB-Cloud-Cluster, ein Konto mit der Rolle Cluster Admin, Cluster Operator oder Cluster Data Accessor (oder ein Dienstkonto mit einer dieser Rollen) und ein MCP-Client mit HTTP-Unterstützung wie Claude Code oder Cursor.

Mit dem CockroachDB Cloud MCP Server arbeitet ein KI-Assistent mit Ihren Clustern in CockroachDB Cloud. Dieser Ratgeber führt von der Rollenprüfung bis zur ersten Abfrage.

Schritt 1: Voraussetzungen prüfen

Sie benötigen ein Cluster in CockroachDB Cloud und eine der Rollen Cluster Admin, Cluster Operator oder Cluster Data Accessor auf diesem Cluster. Dazu kommt ein MCP-Client mit HTTP-Unterstützung, etwa Claude Code oder Cursor. Beginnen Sie laut Dokumentation mit einem Staging-Cluster.

Schritt 2: Endpunkt eintragen

Der Endpunkt lautet https://cockroachlabs.cloud/mcp. In Claude Code genügt claude mcp add --transport http cockroachdb-cloud https://cockroachlabs.cloud/mcp; in anderen Clients tragen Sie die Adresse als HTTP-Server ein.

claude mcp add --transport http cockroachdb-cloud https://cockroachlabs.cloud/mcp

Schritt 3: Mit OAuth anmelden

Beim ersten Aufruf öffnet sich die CockroachDB-Cloud-Konsole. Melden Sie sich an, wählen Sie die Organisation und legen Sie fest, ob der Assistent nur lesen, nur schreiben oder beides darf. Wählen Sie für den Einstieg nur Lesen.

Alternativ ein Dienstkonto nutzen

Für Automatisierung legen Sie ein Dienstkonto mit der kleinstmöglichen Rolle an und senden dessen geheimen Schlüssel als Bearer-Token im Header Authorization. Dann bestimmen die Rollen des Dienstkontos, was erlaubt ist. Legen Sie den Schlüssel nie im Repository ab.

Auf ein Cluster beschränken

Mit dem optionalen Header mcp-cluster-id beschränken Sie die Verbindung auf ein einzelnes Cluster. Aufrufe, die ein anderes Cluster betreffen, scheitern dann.

Schritt 4: Erste Abfragen

Lassen Sie die Cluster auflisten, wählen Sie eine Datenbank und fragen Sie nach den Tabellen und dem Schema. Danach lassen Sie eine Abfrage mit EXPLAIN prüfen oder laufende Abfragen anzeigen.

Schritt 5: Schreibzugriff bewusst freigeben

Die schreibenden Werkzeuge legen Datenbanken und Tabellen an und fügen Zeilen ein. Geben Sie Schreibzugriff nur für Staging-Cluster frei und prüfen Sie jeden Vorschlag des Assistenten, bevor Sie ihn bestätigen.

OAuth über die CockroachDB-Cloud-Konsole (empfohlen) oder der geheime Schlüssel eines Dienstkontos als Bearer-Token im Header Authorization.

Bei OAuth wählen Sie Lesen, Schreiben oder beides; bei API-Schlüsseln gelten die Rollen des Dienstkontos. Optional mit dem Header mcp-cluster-id auf ein Cluster beschränkbar.

Der Server wird von Cockroach Labs gehostet. Abgefragte Daten gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Ungewollte Schreibzugriffe bei freigegebenem Schreibzugriff oder zu weiten Dienstkonto-Rollen, Weitergabe von Geschäftsdaten an den Modellanbieter und offen abgelegte API-Schlüssel.