GWC Bridge manuell mit Gemini verbinden

Verbinden Sie GWC Bridge mit Gemini, damit Gemini mit den Dateien und Befehlen arbeiten kann, die Sie auf Ihrem eigenen PC erlauben.

Hinweis zu UI-Bezeichnungen: Die Bezeichnungen in Anführungszeichen folgen der aktuellen englischen Dokumentation von Google. Ihre Oberfläche kann abweichen, während Google Funktionen schrittweise einführt. Mit GWC Bridge kann Gemini auf Ihrem eigenen PC mit freigegebenen Dateien und Befehlen arbeiten, während dort GWC for VS Code oder GWC Studio läuft. Das Hinzufügen eines benutzerdefinierten MCP-Servers bedeutet nicht, dass Google GWC Bridge geprüft hat oder empfiehlt.

1. Wer diesen Weg nutzen kann

Gemini: Ein Administrator kann einen Datenspeicher vom Typ „Custom MCP Server“ hinzufügen, nachdem die verwaltete Organisationsrichtlinie des Projekts benutzerdefinierte MCP-Konnektoren zulässt. Google verlangt für den Administrator, der den Datenspeicher erstellt, die Rolle „Discovery Engine Editor“; außerdem können zusätzliche Änderungen an den Richtlinien für ausgehenden Datenverkehr und Datenquellen erforderlich sein, wenn VPC Service Controls oder eine verwaltete Richtliniendurchsetzung aktiviert ist.^[1]^[2]

Gemini CLI: GWC Bridge unterstützt diesen Weg derzeit nicht. Konfigurieren Sie keinen statischen Gemini-CLI-OAuth-Client.

Benutzerdefinierte Apps in Gemini für Privatkunden: Google beschränkt benutzerdefinierte Apps derzeit auf berechtigte Nutzer: mindestens 18 Jahre alt, in den USA, mit einem persönlichen Google-Konto angemeldet, mit aktiviertem „Keep Activity“ (Aktivitäten speichern) und mit Englisch für diese Funktion. Die Einrichtung beginnt in der Gemini-Web-App.^[4] GWC Bridge ist für diesen Privatkunden-Ablauf noch nicht aktiviert. Google beschreibt zwar die Eingabe von Zugangsdaten unter „Advanced features“ (Erweiterte Funktionen), wenn ein Server keine dynamische Client-Registrierung unterstützt, veröffentlicht auf der aktuellen Hilfeseite jedoch nicht die Callback-URI, die GWC auf die Positivliste setzen müsste. GWC rät diese Adresse nicht und akzeptiert keine Wildcard-Weiterleitung.

2. Bevor Sie beginnen

Halten Sie Ihr GWC-Konto bereit und stellen Sie sicher, dass Ihr Connect Pass aktiv ist und GWC for VS Code oder GWC Studio auf dem PC, den Gemini nutzen soll, läuft und verbunden ist.
Melden Sie sich mit demselben GWC-Konto an, sobald sich das OAuth-Fenster öffnet. Das Hinzufügen der MCP-URL installiert oder startet die PC-Komponente nicht.
Prüfen Sie die von diesem PC freigegebenen Datei-, Ordner- und Befehlsberechtigungen. Beginnen Sie mit dem kleinsten erforderlichen Zugriffsumfang.
GWC Bridge setzt weiterhin seine eigenen Konto-, Berechtigungs-, Ordner-, Ressourcen-, Genehmigungs- und Befehlsrichtlinien durch. Gemini kann sich keinen Zugriff gewähren, den GWC verweigert.

3. Serveradresse und OAuth

Verwenden Sie diese MCP-Serveradresse:

https://mcp.gwc-corp.com/mcp

Die OAuth-Endpunkte von GWC lauten:

Authorization URL: https://api.gwc-corp.com/oauth/authorize
Token URL:         https://api.gwc-corp.com/oauth/token
Issuer:            https://api.gwc-corp.com

Der unterstützte Gemini-Weg verwendet Authorization Code mit PKCE S256. Die statische Client-ID ist ein öffentlicher Bezeichner und an Googles exakten gehosteten Callback gebunden. GWC Bridge registriert derzeit keinen Gemini-CLI-OAuth-Client.

4. Einrichtung durch Administratoren in Gemini

Google behandelt die Konfiguration eines Custom MCP Server als organisationsweiten Vorgang für Administratoren.^[1]

Wählen Sie in Google Cloud das Projekt aus, zu dem die Gemini-App gehört.
Öffnen Sie Organization Policies (Organisationsrichtlinien) und suchen Sie Disable custom MCP server connector for Gemini Enterprise (constraints/discoveryengine.managed.disableCustomMcpServerConnector). Überschreiben Sie die übergeordnete Richtlinie für dieses Projekt und setzen Sie die Durchsetzung auf Off (Aus). Deaktivieren Sie die Richtlinie nicht für einen breiteren Organisationsbereich, sofern dies keine bewusste Governance-Entscheidung Ihrer Organisation ist.^[2]
Wenn Ihr Projekt durch VPC Service Controls geschützt ist oder die zugehörigen verwalteten Konnektorrichtlinien für dieses Projekt durchgesetzt werden, lassen Sie custom_mcp als Datenquelle sowie ausgehenden Datenverkehr zu mcp.gwc-corp.com und api.gwc-corp.com zu.^[1]^[5]
Weisen Sie dem Administrator, der den Datenspeicher erstellt, die erforderliche Rolle Discovery Engine Editor (roles/discoveryengine.editor) zu.^[1]
Öffnen Sie Gemini Enterprise → Data stores (Datenspeicher) → Create data store (Datenspeicher erstellen) → Custom MCP Server → Add MCP server (MCP-Server hinzufügen).
Wählen Sie OAuth 2.0 und geben Sie Folgendes ein:

Feld	Wert
MCP Server URL	`https://mcp.gwc-corp.com/mcp`
Authorization URL	`https://api.gwc-corp.com/oauth/authorize`
Authorization URL Parameters	Leer lassen (Leave blank)
Token URL	`https://api.gwc-corp.com/oauth/token`
Client ID	`gwc-google-gemini-v1`
Client Secret	`none`
Scopes	`files:read files:write commands:run`
Enable PKCE Support	On
Use HTTP Basic	Off

Das aktuelle Cloud-Beispiel von Google für eine MCP-App in Gemini zeigt ebenfalls aktiviertes PKCE und deaktiviertes HTTP Basic.^[7]

Die von Google für diesen Konnektor dokumentierte Weiterleitungsadresse lautet exakt https://vertexaisearch.cloud.google.com/oauth-redirect; das GWC-Clientprofil akzeptiert ausschließlich diese URI und keinen benachbarten Pfad, alternativen Host oder Wildcard-Eintrag.^[1] Der Wert none ist kein gemeinsames Geheimnis. Googles eigene Looker-MCP-Anleitung verwendet genau dieses Literal, wenn das Formular für einen öffentlichen PKCE-Client ein ausgefülltes Feld „Client Secret“ verlangt.^[6]

Klicken Sie auf Verify Auth (Authentifizierung prüfen), melden Sie sich bei GWC an, prüfen Sie die angeforderten GWC-Berechtigungen und stimmen Sie nur zu, wenn Konto und Ziel korrekt sind.
Schließen Sie die Erstellung des Datenspeichers ab. Warten Sie, bis er den Status Active (Aktiv) erreicht.
Öffnen Sie die Ansicht Actions (Aktionen) des Datenspeichers, laden Sie die benutzerdefinierten Aktionen bei Bedarf neu und aktivieren Sie nur die GWC-Bridge-Tools, die Gemini verwenden soll. Google deaktiviert Aktionen benutzerdefinierter MCP-Server standardmäßig.^[1]
Verbinden Sie den Datenspeicher mit der vorgesehenen Gemini-App und führen Sie anschließend einen ersten rein lesenden Test aus: Use GWC Bridge to show which of my computers and shared folders are available. Do not change files or run commands.

5. Gemini CLI

Gemini CLI kann Remote-MCP-Server verbinden, aber GWC Bridge aktiviert derzeit keinen Gemini-CLI-OAuth-Client. Fügen Sie Gemini CLI noch kein GWC-Bridge-OAuth-Profil hinzu. Dieser Weg bleibt ohne einen separat geprüften Client-Identitätsmechanismus nicht unterstützt.

6. Benutzerdefinierte Apps in Gemini für Privatkunden

Laut der Google-Hilfe für Gemini Apps für Privatkunden können berechtigte Nutzer Settings → Connected Apps (Einstellungen → Verknüpfte Apps) öffnen, eine benutzerdefinierte App über die MCP-Server-URL hinzufügen und – falls der Server keine dynamische Client-Registrierung unterstützt – Advanced features (Erweiterte Funktionen) öffnen und dort Zugangsdaten eingeben.^[4]

Geben Sie dort heute keine der beiden statischen Client-IDs von GWC ein. Die aktuelle Google-Hilfeseite dokumentiert die OAuth-Callback-URI für benutzerdefinierte Privatkunden-Apps nicht, und GWC stellt keinen Endpunkt für dynamische Client-Registrierung bereit. Die Wiederverwendung der Enterprise-Callback-URI oder der Loopback-Callback-URI der CLI wäre falsch; die Annahme eines Wildcard-Eintrags würde die OAuth-Weiterleitungsbindung schwächen.

Dieser Weg kann erst unterstützt werden, wenn mindestens eine der folgenden Bedingungen erfüllt ist:

Google veröffentlicht eine stabile, exakte Callback-URI für Privatkunden, die GWC an eine eigene öffentliche Client-ID binden kann; oder
GWC implementiert und prüft sicherheitstechnisch eine dynamische Client-Registrierung, die den Client-Registrierungsablauf von Gemini erfüllt.

Bis dahin ist Gemini der einzige unterstützte Kundenweg in dieser Anleitung.

7. Was Gemini sehen kann und wie Sie die Verbindung trennen

Wenn Gemini ein GWC-Bridge-Tool aufruft, kann das Tool-Ergebnis Dateinamen, Dateiinhalte, Befehlsausgaben, Gerätebezeichnungen oder andere Daten enthalten, die vom autorisierten Tool zurückgegeben werden. Diese Inhalte verlassen Ihren PC und werden von der von Ihnen gewählten Gemini-Oberfläche verarbeitet. Google weist darauf hin, dass benutzerdefinierte MCP-Server von Drittanbietern außerhalb der Kontrolle von Google liegen, und empfiehlt, nur Server zu verbinden, denen Sie vertrauen.^[4]

Die Berechtigungen von GWC Bridge bleiben maßgeblich:

Das Lesen von Dateien ist auf Ordner beschränkt, die für die aktive GWC-Bridge-Verbindung freigegeben sind.
Dateiänderungen setzen voraus, dass sowohl die Verbindung als auch der Ordner Änderungen erlauben und alle Prüfungen für geschützte Aktionen bestanden werden.
Befehle setzen voraus, dass die Verbindung Befehle erlaubt, und können weiterhin eine Genehmigung erfordern.
Ein anderer PC, ein anderes Konto oder eine widerrufene Berechtigung ist nicht mit dem von Ihnen autorisierten Ziel austauschbar.

So trennen Sie die Verbindung:

Gemini: Ein Administrator kann gemäß den Richtlinien der Organisation Aktionen deaktivieren, den Datenspeicher von der App trennen oder den benutzerdefinierten MCP-Datenspeicher entfernen.
Gemini CLI: Es ist kein GWC-OAuth-Client aktiviert. Entfernen Sie ein experimentelles GWC-Bridge-OAuth-Profil, statt eine Authentifizierung zu versuchen.
In GWC macht der Widerruf der zugrunde liegenden Bridge-Berechtigung den Zugriff unabhängig von der Konfiguration auf Gemini-Seite ungültig.

8. Fehlerbehebung

Problem	Was Sie prüfen sollten
Gemini-CLI-OAuth wird versucht	Stoppen. GWC Bridge unterstützt Gemini-CLI-OAuth derzeit nicht.
Gemini meldet, dass Custom MCP Server blockiert ist	Bestätigen Sie, dass die auf Projektebene verwaltete Einschränkung Disable custom MCP server connector for Gemini Enterprise überschrieben und auf Off gesetzt ist. Wenn VPC Service Controls oder eine verwaltete Durchsetzung gilt, lassen Sie außerdem `custom_mcp` und die erforderlichen Egress-FQDNs zu.
Verify Auth meldet eine ungültige Weiterleitung	Bestätigen Sie, dass die Client ID exakt `gwc-google-gemini-v1` lautet. GWC akzeptiert für diesen Client ausschließlich die von Google dokumentierte Adresse `https://vertexaisearch.cloud.google.com/oauth-redirect`.
Verify Auth meldet ein ungültiges Client Secret	Geben Sie exakt `none` ein, aktivieren Sie PKCE und lassen Sie Use HTTP Basic ausgeschaltet. GWC behandelt diesen Wert ausschließlich als den von Google geforderten Formularplatzhalter für diesen einen öffentlichen Client; jedes andere Secret wird abgelehnt.
Die Autorisierung schlägt sofort fehl	Bestätigen Sie, dass GWC manuelles Gemini-OAuth aktiviert hat. Der serverseitige Kompatibilitätsschalter ist standardmäßig deaktiviert.
Gemini erreicht den Server oder die OAuth-Endpunkte nicht	Wenn Egress-Kontrollen gelten, lassen Sie sowohl `mcp.gwc-corp.com` als auch `api.gwc-corp.com` zu. Prüfen Sie die HTTPS-URLs nochmals genau.
Der Datenspeicher ist Active, aber Gemini ruft keine Tools auf	Benutzerdefinierte MCP-Aktionen sind standardmäßig deaktiviert. Aktivieren Sie die gewünschten Aktionen und verbinden Sie den Datenspeicher mit der vorgesehenen Gemini-App.

| Die Anmeldung gelingt, aber GWC verweigert den Zugriff | Prüfen Sie das GWC-Konto und den aktiven Connect Pass sowie anschließend die Bridge-Berechtigung und die PC-Berechtigungen. Wiederholen Sie ein zustandsänderndes Tool nicht blind. | | Der PC oder ein Ordner ist nicht verfügbar | Bestätigen Sie, dass der gewünschte PC online ist, GWC Studio oder GWC for VS Code läuft und verbunden ist und der Ordner für diese Verbindung freigegeben ist. | | Lesen funktioniert, aber Bearbeitungen oder Befehle schlagen fehl | Prüfen Sie die GWC-Bridge-Berechtigungen „Change files“ (Dateien ändern) / „Commands“ (Befehle) sowie etwaige Genehmigungsaufforderungen. Eine Ablehnung ist eine Richtliniengrenze und kein Hinweis auf eine fehlgeschlagene Authentifizierung. | | Eine benutzerdefinierte Privatkunden-App in Gemini fragt nach Zugangsdaten | Verwenden Sie weder die Enterprise- noch die CLI-Client-ID. Die Callback-URI für Privatkunden ist derzeit nicht dokumentiert, weshalb GWC diesen Weg bewusst ablehnt. |

Wenn Sie den GWC-Support kontaktieren, geben Sie die verwendete Gemini-Oberfläche (Enterprise oder CLI), den Einrichtungsschritt und die genaue Fehlermeldung an. Senden Sie niemals Passwörter, Bearer-Token, private Dateiinhalte oder echte Client-Secrets.

9. Offizielle Quellen

Die Anbieterschritte wurden am 2026-10-22 (Asia/Singapore) anhand der aktuellen offiziellen englischen Dokumentation von Google geprüft: