Gemini Cloud Assist mit MCP in Drittanbietertools einbinden

In diesem Dokument erfahren Sie, wie Sie Gemini Cloud Assist und App Design Center mithilfe des Model Context Protocol (MCP) in Drittanbietertools wie Antigravity, Gemini CLI und Cursor einbinden.

Mit MCP können Sie die agentischen Funktionen von Gemini Cloud Assist und App Design Center direkt in Ihre bevorzugten Drittanbieter-Tools und benutzerdefinierten Workflows einbinden. So haben Sie genau dort Zugriff auf Cloud-Betriebs-Know-how, wo Sie bereits arbeiten. Weitere Informationen zu MCP finden Sie unter MCP für Ihre KI-Anwendung konfigurieren.

MCP-Tools für Gemini Cloud Assist

Gemini Cloud Assist ist ein Agent, auf den über eine Reihe von MCP-Tools mit dem Muster „Agents as Tools“ zugegriffen werden kann. Im Gegensatz zu Tools, die Daten abrufen oder prozedurale Verarbeitung durchführen, stellen die Gemini Cloud Assist-Tools die agentischen Funktionen von Gemini Cloud Assist oder von bestimmten Workflows bereit. Der durch MCP-Tool-Aufrufe aufgerufene Agent führt intern eigene Tool-Aufrufe anGoogle Cloudaus. Die folgenden MCP-Tools werden für die Verwendung durch Agenten veröffentlicht:

  • ask_cloud_assist: Dies ist die primäre Schnittstelle für Google Cloud Unterstützung und für den Gemini Cloud Assist-Agent. Über dieses Tool ist die gesamte Funktionalität von Gemini Cloud Assist verfügbar. Es umfasst die Funktionalität der anderen MCP-Tools.
  • design_infra: Dies unterstützt Workflows für das Entwerfen und die Architektur von Infrastruktur auf Google Cloud. Es funktioniert mit den MCP-Servertools des App Design Center, um den Lebenszyklus des Infrastrukturdesigns zu verwalten, z. B. um Sicherheitsergebnisse auszuführen und zu beheben oder Probleme zu beheben.
  • investigate_issue: Dies unterstützt Workflows zur Fehlerbehebung inGoogle Cloud. Es kann eine schnelle oder eine detailliertere Fehlerbehebung über eine Untersuchungsressource durchführen.
  • invoke_operation: Dies unterstützt Arbeitsabläufe zum Erstellen, Aktualisieren und Löschen von Ressourcen in Google Cloud. Dieses Tool funktioniert nur, wenn Agent-Aktionen aktiviert sind. Schreibvorgänge in Gemini Cloud Assist können nur durch den Aufruf dieses Tools ausgeführt werden.
  • optimize_costs: Dies unterstützt Workflows zum Analysieren, Nachverfolgen und Optimieren von Google Cloud Kosten. Es bietet detaillierte Aufschlüsselungen der Ausgaben und identifiziert Möglichkeiten zur Kosteneffizienz, indem es inaktive oder unzureichend genutzte Ressourcen findet.

MCP-Tools für App Design Center

Diese Tools, die oft vom design_infra-Tool von Gemini Cloud Assist orchestriert werden, verwalten die Anwendungslebenszyklen der Infrastruktur mit App Design Center, einschließlich Vorlagenverwaltung, Sicherheits-Compliance und ‑behebung sowie Bereitstellung. Folgende Tools sind verfügbar:

  • setup_adc: Initialisiert die App Design Center-Umgebung. Dies ist ein einmaliger Einrichtungsschritt, der ausgeführt werden muss, bevor andere App Design Center-Tools verwendet werden können.
  • manage_application: Verwaltet den Deployment-Lebenszyklus einer Anwendung. Mit diesem Tool können Sie ein verifiziertes Design über das App Design Center bereitstellen oder den Status und die Details einer vorhandenen Bereitstellung abrufen. Dies ist der letzte Schritt, um Ihr Design in eine bereitgestellte Infrastruktur auf Google Cloudzu verwandeln.
  • manage_application_template: Verwaltet den Infrastructure as Code-Inhalt (IaC) Ihres Infrastrukturdesigns. Damit können Sie das Design als App Design Center-Vorlage speichern, das Design als Terraform-Dateien exportieren oder das Design aktualisieren. Sie können das Tool beispielsweise verwenden, um das Design zu aktualisieren, indem Sie Komponenteneinstellungen und Parameterkonfigurationen ändern.
  • assess_best_practices: Führt vor der Bereitstellung eine umfassende Sicherheits- und Konfigurationsprüfung für Ihr Anwendungsdesign durch. Das Tool validiert das Design anhand von Security Command Center-Frameworks und relevanten Kontrollen und gibt einen Bericht mit umsetzbaren Ergebnissen für die Fehlerbehebung zurück.
  • list_application_templates: Listet alle verfügbaren Anwendungsdesigns auf.

Diese MCP-Tools sollten nicht als stabile APIs betrachtet oder über prozedurale API-Clients konfiguriert werden. Tools aus dieser Liste oder ihre Parameter können im Laufe der Zeit umbenannt, neu definiert, entfernt oder hinzugefügt werden, um den sich entwickelnden Funktionen von Gemini Cloud Assist Rechnung zu tragen. Die Funktionen von Gemini Cloud Assist bleiben stabil, sodass Client-Agents dieselben Aufgaben konsistent ausführen können. Die Art und Weise, wie Agents über diese Tools mit Gemini Cloud Assist interagieren und es aufrufen, ändert sich jedoch im Laufe der Zeit.

Hinweis

  1. Zugriff gewähren: Wenn Sie MCP verwenden möchten, benötigen Sie eine Identity and Access Management-Rolle mit der Berechtigung mcp.googleapis.com/tools.call, z. B. eine der folgenden Gemini Cloud Assist-Rollen:

    • roles/geminicloudassist.user
    • roles/geminicloudassist.editor
    • roles/geminicloudassist.admin

  2. Installieren Sie die gcloud CLI und ihre Betakomponenten, falls noch nicht geschehen.

  3. Aktivieren Sie den MCP-Dienst in Ihrem Projekt mit dem folgenden Befehl:

    gcloud beta services mcp enable geminicloudassist.googleapis.com \
    --project=PROJECT_ID

    Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .

  4. Authentifizieren Sie sich mit Standardanmeldedaten für Anwendungen, indem Sie den folgenden Befehl ausführen:

    gcloud auth application-default login

MCP für Ihren Client konfigurieren

Die Client-Agent-Konfiguration hängt davon ab, welchen Agent Sie verwenden. In den folgenden Abschnitten finden Sie Anleitungen zum Konfigurieren von MCP für verschiedene Clients.

Damit der gesamte Workflow von der Entwicklung bis zur Bereitstellung möglich ist, müssen Sie Ihren Client so konfigurieren, dass er eine Verbindung zu den MCP-Servern von Gemini Cloud Assist und App Design Center herstellt, und die entsprechende SKILL.md-Datei einfügen. Die folgenden Snippets zeigen die kombinierte Konfiguration.

Gemini CLI

Mit einer Erweiterung konfigurieren

Installieren Sie den MCP-Server als Gemini CLI-Erweiterung mit dem folgenden Befehl:

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

Manuell konfigurieren

  1. MCP-Servereinstellungen konfigurieren

    Öffnen Sie die Datei mit den Einstellungen für den Nutzerbereich der Gemini CLI unter ~/.gemini/settings.json oder die Datei mit den Einstellungen für den Arbeitsbereich unter .gemini/settings.json. Wenn die Datei nicht vorhanden ist, erstellen Sie sie. Fügen Sie den folgenden Konfigurationsblock unter dem Schlüssel mcpServers hinzu oder führen Sie ihn zusammen. Achten Sie darauf, dass die Datei ein gültiges JSON-Format hat. Bei dieser Konfiguration werden automatisch Ihre Standardanmeldedaten für Anwendungen verwendet. 

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      },
      "timeout": 600000
    },
    "application_design_center": {
      "httpUrl": "https://designcenter.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      },
      "timeout": 600000
    }
  }
}

  2. Skill-Dateien erstellen und befüllen

    Erstellen Sie eine SKILL.md-Datei in einem der folgenden Verzeichnisse. Kopieren Sie den Markdown-Inhalt für den ausgewählten Skill aus dem Abschnitt Skill-Referenz dieses Dokuments und fügen Sie ihn in die Datei ein.

    • Arbeitsbereich-Bereich: .gemini/skills/<skill-name>/
    • Nutzerumfang: ~/.gemini/skills/<skill-name>/

    Hier sehen Sie ein Beispiel für eine Verzeichnisstruktur:

    .gemini/
└── skills/
    ├── design-and-deploy/
    │   └── SKILL.md
    └── google-gemini-cloud-assist/
        └── SKILL.md

  3. Fertigkeiten nachweisen:

    Nachdem Sie die Dateien settings.json und SKILL.md geändert haben, starten Sie die Gemini CLI neu. Verwenden Sie die folgenden Befehle, um Folgendes zu prüfen:

    • /skills list: So prüfen Sie, ob Ihre lokalen Skills erfolgreich erkannt wurden.
    • /mcp list: Damit wird geprüft, ob die MCP-Server von Gemini Cloud Assist und App Design Center verbunden sind.

Antigravity

  1. Erweiterung installieren

    Öffnen Sie in Antigravity den Marketplace Extensions (Erweiterungen). Suchen Sie nach der Gemini Cloud Assist-Erweiterung, klicken Sie auf Installieren und dann auf Aktualisieren.

  2. MCP-Server manuell konfigurieren

    Öffnen Sie den Bereich MCP-Server verwalten und klicken Sie auf Rohkonfiguration ansehen, um die mcp_config.json-Datei zu bearbeiten. Fügen Sie den folgenden Konfigurationsblock hinzu oder führen Sie ihn zusammen. Bei dieser Einrichtung werden Ihre Standardanmeldedaten für Anwendungen zur Authentifizierung verwendet.

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    },
    "application_design_center": {
      "serverUrl": "https://designcenter.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    }
  }
}

  3. Einrichtung überprüfen

    Nachdem Sie die Dateien mcp_config.json und SKILL.md bearbeitet haben, starten Sie Antigravity neu. Verwenden Sie im Agent-Bereich die folgenden Slash-Befehle, um die Verbindung zu prüfen:

    • /skills list: Überprüft, ob Ihre lokalen Skills erkannt wurden.
    • /mcp list: Prüft, ob die MCP-Server von Gemini Cloud Assist und App Design Center verbunden sind.

Cursor

  1. Google Cloud Erstellen Sie in Ihrem Projekt eine OAuth 2.0-Client-ID für eine Desktop-App.

  2. Konfigurieren Sie URI://anysphere.cursor-mcp/oauth/callback als Weiterleitungs-URL. Weitere Informationen finden Sie in der Dokumentation zu Cursors.

  3. Fügen Sie den folgenden Konfigurationsblock hinzu oder führen Sie ihn zusammen:

       {
     "mcpServers": {
       "gemini_cloud_assist": {
         "url": "https://geminicloudassist.googleapis.com/mcp",
         "auth": {
           "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
           "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
           "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
         }
       }
     }
   }

Gemini Cloud Assist-Skills

Die MCP-Tools von Gemini Cloud Assist und App Design Center verwenden Agent-Skills, um Ihren Agenten zu instruieren. Mit dem Skill kann Ihr Agent die folgenden Aufgaben ausführen:

  • Mehrere Tools zu einem Arbeitsablauf verketten
  • Verarbeiten Sie relevante lokale Informationen wie Terraform-Bereitstellungscode, um Ihren lokalen Kontext zu analysieren.
  • Antworte auf explizite Aufrufe, wenn du direkt auf den Skill verweist.

Wenn Sie interaktive Agents wie Antigravity oder die Gemini CLI verwenden, können Sie Gemini Cloud Assist-MCP-Tools in andere Agents und Workflows einbinden. Da diese Tools umfassende Funktionen bieten, die sich möglicherweise mit Ihren vorhandenen spezialisierten Tools überschneiden, sollten Sie die folgenden Strategien verwenden, um sie für Ihre spezifische Umgebung und Ihren Anwendungsfall zu optimieren:

  1. Skill-Definition anpassen: Aktualisieren Sie die Datei SKILL.md, um die Intents und Anwendungsfälle anzugeben, für die Gemini Cloud Assist aufgerufen werden soll. So wird sichergestellt, dass der Agent nur für Aufgaben ausgelöst wird, für die seine umfassende Cloud-Expertise erforderlich ist.
  2. Skills explizit aufrufen: Bei vielen interaktiven Agents können Sie steuern, wann ein Skill ausgelöst wird. Wenn Ihr Agent dies unterstützt, können Sie den Skill so konfigurieren, dass er manuell über Slash-Befehle (/) oder @-Erwähnungen (@) aufgerufen werden muss. So können Sie genau festlegen, wann Gemini Cloud Assist und wann ein anderes spezialisiertes Tool verwendet werden soll.

Gemini Cloud Assist-Skill-Referenz

Wir empfehlen die folgende SKILL.md-Datei für alle Agents, die mit Gemini Cloud Assist-MCP-Tools konfiguriert sind. Diese Datei enthält Anweisungen für Ihren Agenten zur richtigen Verwendung der Tools.

Nächste Schritte