Google Cloud MCP Server (gcloud-mcp) einrichten

Dieser Ratgeber zeigt, wie der offizielle Google Cloud MCP Server (gcloud-mcp) eingerichtet wird, damit ein KI-Assistent Google-Cloud-Ressourcen per natürlicher Sprache über die gcloud-CLI steuern kann.

Voraussetzungen

Node.js Version 20 oder neuer (node --version)
Installierte und authentifizierte gcloud-CLI (gcloud auth login)
Ein MCP-fähiger KI-Client (Gemini CLI, Claude Desktop, Cline, Cursor, VS Code oder vergleichbar)

Option 1: Gemini CLI / Gemini Code Assist (empfohlen für Gemini-Nutzer)

Im Home-Verzeichnis ausführen:

npx @google-cloud/gcloud-mcp init --agent=gemini-cli

Der Server wird dadurch als Gemini-CLI-Erweiterung registriert und steht in allen Projekten zur Verfügung. Prüfen lässt sich die Einrichtung mit:

gemini mcp list

Option 2: Andere MCP-Clients (Claude Desktop, Cline, Cursor, VS Code)

In der jeweiligen MCP-Konfigurationsdatei folgenden Block ergänzen:

{
  "mcpServers": {
    "gcloud": {
      "command": "npx",
      "args": ["-y", "@google-cloud/gcloud-mcp"]
    }
  }
}

Bei Bedarf lassen sich die drei weiteren Teilserver ergänzen, jeweils als eigener Eintrag mit dem passenden Paketnamen:

{
  "mcpServers": {
    "gcloud": {
      "command": "npx",
      "args": ["-y", "@google-cloud/gcloud-mcp"]
    },
    "observability": {
      "command": "npx",
      "args": ["-y", "@google-cloud/observability-mcp"]
    },
    "storage": {
      "command": "npx",
      "args": ["-y", "@google-cloud/storage-mcp"]
    },
    "backupdr": {
      "command": "npx",
      "args": ["-y", "@google-cloud/backupdr-mcp"]
    }
  }
}

In VS Code liegt der Wurzelschlüssel abweichend unter servers statt mcpServers in der .vscode/mcp.json.

Installation überprüfen

Nach der Einrichtung im KI-Client die Tool-Liste aktualisieren und einen einfachen Testprompt senden, zum Beispiel:

Liste meine Google-Cloud-Projekte auf.

Antwortet der Agent mit einer Projektliste, ist der Server aktiv und korrekt authentifiziert.

Erste Prompts

"Zeige die letzten 20 Fehler-Logeinträge im Projekt <projekt-id> der letzten Stunde"
"Liste alle Objekte im Bucket <bucket-name> auf"
"Welche Backup-Tresore existieren in der Region europe-west3?"
"Erstelle einen neuen Bucket <name> in der Region europe-west1"

Sicherheitshinweise

Eingeschränktes Konto verwenden – Für produktive Einrichtungen ein Service-Account mit möglichst wenigen Rechten per Impersonation nutzen statt eines persönlichen Kontos mit vollem Zugriff.

Schreibende Werkzeuge bewusst freigeben – Werkzeuge wie delete_bucket, delete_backup_vault oder restore_backup führen echte Änderungen aus. Vor dem produktiven Einsatz prüfen, ob der Agent diese Werkzeuge überhaupt benötigen soll.

Preview-Status beachten – Das Projekt ist laut Google ausdrücklich keine offiziell unterstützte, durch die Google-Cloud-Nutzungsbedingungen abgedeckte Lösung. Für unternehmenskritische Automatisierungen empfiehlt sich ein Testlauf mit eingeschränkten Testkonten vor dem breiten Rollout.

Datenfluss zum Modell im Blick behalten – Log-, Objekt- und Konfigurationsinhalte werden an den KI-Client und von dort an den Modell-Anbieter weitergereicht. Keine Secrets oder personenbezogenen Daten unkontrolliert über den Agenten verarbeiten lassen.

Fehlerbehebung

Server verbindet nicht – gcloud auth list prüfen, ob ein aktives Konto vorhanden ist. Gegebenenfalls erneut mit gcloud auth login anmelden.

Befehl wird abgelehnt – Der gcloud-Kernserver blockiert bewusst bestimmte Befehle (etwa interaktive Sitzungen). Das ist beabsichtigt und kein Fehler.

Node.js-Version zu alt – node --version prüfen; mindestens Version 20 wird benötigt.