Connecter manuellement GWC Bridge à Gemini

Connectez GWC Bridge à Gemini afin que Gemini puisse travailler avec les fichiers et les commandes que vous autorisez sur votre propre PC.

Remarque sur les libellés de l’interface : Les libellés entre guillemets suivent la documentation actuelle en anglais de Google. Votre interface peut différer à mesure que Google déploie des fonctionnalités. GWC Bridge permet à Gemini de travailler avec les fichiers et les commandes autorisés sur votre propre PC, sur lequel GWC for VS Code ou GWC Studio est en cours d’exécution. L’ajout d’un serveur MCP personnalisé ne signifie pas que Google a examiné ou approuvé GWC Bridge.

1. Qui peut utiliser cette méthode

Gemini : Un administrateur peut ajouter un magasin de données « Custom MCP Server » une fois que la règle d’organisation gérée du projet autorise les connecteurs MCP personnalisés. Google exige le rôle Discovery Engine Editor pour l’administrateur qui crée le magasin de données, et des modifications supplémentaires des règles de sortie (egress) ou de sources de données peuvent s’appliquer lorsque VPC Service Controls ou l’application gérée des règles est activée.^[1]^[2]

Gemini CLI : GWC Bridge ne prend pas encore en charge ce parcours. Ne configurez pas de client OAuth Gemini CLI statique.

Applications personnalisées Gemini grand public : Google limite actuellement les applications personnalisées aux utilisateurs éligibles : âgés de 18 ans ou plus, situés aux États-Unis, connectés avec un compte Google personnel, avec Keep Activity (Conserver l’activité) activé et l’anglais configuré pour cette fonctionnalité. La configuration commence dans l’application web Gemini.^[4] GWC Bridge n’est pas encore activé pour ce parcours grand public. Google documente la saisie d’identifiants sous “Advanced features” (Fonctionnalités avancées) lorsqu’un serveur ne prend pas en charge l’enregistrement dynamique des clients (Dynamic Client Registration), mais sa page d’aide actuelle ne publie pas l’URI de rappel que GWC devrait autoriser. GWC ne le devinera pas et n’acceptera pas de redirection avec caractère générique.

2. Avant de commencer

Préparez votre compte GWC, un Connect Pass actif, ainsi que GWC for VS Code ou GWC Studio en cours d’exécution et connecté sur le PC que vous souhaitez faire utiliser à Gemini.
Connectez-vous au même compte GWC lorsque la fenêtre OAuth s’ouvre. L’ajout de l’URL MCP n’installe ni ne démarre le composant sur le PC.
Vérifiez les autorisations relatives aux fichiers, aux dossiers et aux commandes exposées par ce PC. Commencez par le niveau d’accès minimal dont vous avez besoin.
GWC Bridge continue d’appliquer ses propres règles relatives aux comptes, aux autorisations, aux dossiers, aux ressources, aux approbations et aux commandes. Gemini ne peut pas s’accorder un accès que GWC refuse.

3. Adresse du serveur et OAuth

Utilisez cette adresse de serveur MCP :

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

Les points de terminaison OAuth de GWC sont :

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

Le parcours pris en charge pour Gemini utilise Authorization Code avec PKCE S256. Son identifiant client statique est public et lié au rappel hébergé exact de Google. GWC Bridge n’enregistre actuellement aucun client OAuth Gemini CLI.

4. Configuration administrateur dans Gemini

Google traite la configuration d’un Custom MCP Server comme une opération d’administrateur à l’échelle de l’organisation.^[1]

Dans Google Cloud, sélectionnez le projet propriétaire de l’application Gemini.
Ouvrez Organization Policies (Règles d’administration) et recherchez Disable custom MCP server connector for Gemini Enterprise (constraints/discoveryengine.managed.disableCustomMcpServerConnector). Remplacez la règle parente pour ce projet et définissez son application sur Off (Désactivé). Ne désactivez pas cette règle à une échelle plus large de l’organisation, sauf s’il s’agit d’une décision de gouvernance volontaire de votre organisation.^[2]
Si votre projet est protégé par VPC Service Controls, ou si les règles gérées associées aux connecteurs sont appliquées à ce projet, autorisez custom_mcp comme source de données et autorisez le trafic sortant vers mcp.gwc-corp.com et api.gwc-corp.com.^[1]^[5]
Accordez à l’administrateur qui crée le magasin de données le rôle requis Discovery Engine Editor (roles/discoveryengine.editor).^[1]
Ouvrez Gemini Enterprise → Data stores (Magasins de données) → Create data store (Créer un magasin de données) → Custom MCP Server → Add MCP server (Ajouter un serveur MCP).
Choisissez OAuth 2.0 et saisissez :

Champ	Valeur
MCP Server URL	`https://mcp.gwc-corp.com/mcp`
Authorization URL	`https://api.gwc-corp.com/oauth/authorize`
Authorization URL Parameters	Laisser vide (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

L’exemple Cloud actuel de Google pour une application MCP Gemini montre également PKCE activé et HTTP Basic décoché.^[7]

La redirection documentée par Google pour ce connecteur est exactement https://vertexaisearch.cloud.google.com/oauth-redirect ; le profil client GWC accepte uniquement cet URI et aucun chemin voisin, hôte alternatif ni caractère générique.^[1] La valeur none n’est pas un secret partagé. Les propres instructions Looker MCP de Google utilisent cette valeur littérale lorsque le formulaire exige un champ Client Secret pour un client public PKCE.^[6]

Cliquez sur Verify Auth (Vérifier l’authentification), connectez-vous à GWC, vérifiez les autorisations GWC demandées et n’approuvez que si le compte et la cible sont corrects.
Terminez la création du magasin de données. Attendez qu’il passe à l’état Active (Actif).
Ouvrez la vue Actions du magasin de données, rechargez les actions personnalisées si nécessaire et activez uniquement les outils GWC Bridge que vous souhaitez faire utiliser à Gemini. Google désactive par défaut les actions MCP personnalisées.^[1]
Connectez le magasin de données à l’application Gemini souhaitée, puis effectuez une première vérification en lecture seule : 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 peut se connecter à des serveurs MCP distants, mais GWC Bridge n’active actuellement aucun client OAuth Gemini CLI. N’ajoutez pas encore de profil OAuth GWC Bridge à Gemini CLI. Ce parcours reste non pris en charge jusqu’à ce que GWC publie un mécanisme d’identité client examiné séparément.

6. Applications personnalisées Gemini grand public

L’aide de Google relative aux applications Gemini grand public indique que les utilisateurs éligibles peuvent ouvrir Settings → Connected Apps (Paramètres → Applications connectées), ajouter une application personnalisée par URL de serveur MCP et — lorsque le serveur ne prend pas en charge l’enregistrement dynamique des clients — ouvrir Advanced features (Fonctionnalités avancées) et saisir des identifiants.^[4]

N’y saisissez aucun des deux identifiants client statiques de GWC aujourd’hui. La page d’aide actuelle de Google ne documente pas l’URI de rappel OAuth des applications personnalisées grand public, et GWC ne dispose d’aucun point de terminaison d’enregistrement dynamique des clients. Réutiliser le rappel Enterprise ou le rappel local (loopback) de la CLI serait incorrect ; accepter un caractère générique affaiblirait la liaison de redirection OAuth.

Ce parcours ne pourra être pris en charge qu’une fois l’une au moins des conditions suivantes remplie :

Google publie un URI de rappel grand public exact et stable que GWC peut lier à un identifiant client public dédié ; ou
GWC implémente et soumet à une revue de sécurité un mécanisme d’enregistrement dynamique des clients conforme au flux d’enregistrement des clients de Gemini.

D’ici là, Gemini est le seul parcours client pris en charge dans ce guide.

7. Ce que Gemini peut voir et comment se déconnecter

Lorsque Gemini appelle un outil GWC Bridge, le résultat de l’outil peut inclure des noms de fichiers, le contenu de fichiers, la sortie de commandes, des libellés d’appareils ou d’autres données renvoyées par l’outil autorisé. Ce contenu quitte votre PC et est traité par l’interface Gemini que vous avez choisie. Google précise que les serveurs MCP tiers personnalisés échappent au contrôle de Google et recommande de ne connecter que des serveurs auxquels vous faites confiance.^[4]

Les autorisations de GWC Bridge restent déterminantes :

La lecture de fichiers est limitée aux dossiers partagés avec la connexion GWC Bridge active.
Les modifications de fichiers exigent que la connexion et le dossier autorisent les modifications, ainsi que le respect des contrôles relatifs aux actions protégées.
Les commandes exigent que la connexion autorise Commands et peuvent toujours nécessiter une approbation.
Un autre PC, un autre compte ou une autorisation révoquée ne sont pas interchangeables avec ceux que vous avez autorisés.

Pour se déconnecter :

Gemini : un administrateur peut désactiver les actions, déconnecter le magasin de données de l’application ou supprimer le magasin de données MCP personnalisé conformément aux règles de l’organisation.
Gemini CLI : aucun client OAuth GWC n’est activé. Supprimez tout profil OAuth GWC Bridge expérimental au lieu de tenter de l’authentifier.
Dans GWC, la révocation de l’autorisation Bridge sous-jacente invalide l’accès indépendamment de la configuration côté Gemini.

8. Dépannage

Symptôme	Points à vérifier
Une authentification OAuth Gemini CLI est tentée	Arrêtez. GWC Bridge ne prend actuellement pas en charge OAuth pour Gemini CLI.
Gemini indique que Custom MCP Server est bloqué	Vérifiez que la contrainte gérée au niveau du projet Disable custom MCP server connector for Gemini Enterprise est remplacée et définie sur Off. Si VPC Service Controls ou l’application gérée des règles s’applique, autorisez également `custom_mcp` et les FQDN de sortie requis.
Verify Auth signale une redirection non valide	Vérifiez que Client ID est exactement `gwc-google-gemini-v1`. GWC n’accepte pour ce client que l’adresse documentée par Google `https://vertexaisearch.cloud.google.com/oauth-redirect`.
Verify Auth signale un secret client non valide	Saisissez exactement `none`, activez PKCE et laissez Use HTTP Basic désactivé. GWC ne traite cette valeur que comme l’espace réservé de formulaire exigé par Google pour cet unique client public ; tout autre secret est refusé.
L’autorisation échoue immédiatement	Vérifiez que GWC a activé l’authentification OAuth manuelle de Gemini. L’indicateur de compatibilité côté serveur est désactivé par défaut.
Gemini ne parvient pas à joindre le serveur ou les points de terminaison OAuth	Si des contrôles de sortie s’appliquent, autorisez à la fois `mcp.gwc-corp.com` et `api.gwc-corp.com`. Vérifiez à nouveau les URL HTTPS exactes.
Le magasin de données est Active mais Gemini n’appelle pas les outils	Les actions MCP personnalisées sont désactivées par défaut. Activez les actions souhaitées et connectez le magasin de données à l’application Gemini prévue.

| La connexion réussit mais GWC refuse l’accès | Vérifiez le compte GWC et la validité du Connect Pass, puis inspectez l’autorisation Bridge et les autorisations du PC. Ne relancez pas aveuglément un outil qui modifie l’état. | | Le PC ou le dossier n’est pas disponible | Vérifiez que le PC souhaité est en ligne, que GWC Studio ou GWC for VS Code est en cours d’exécution et connecté, et que le dossier est partagé avec cette connexion. | | La lecture fonctionne mais les modifications ou les commandes échouent | Vérifiez les autorisations Change files (Modifier les fichiers) / Commands (Commandes) de GWC Bridge ainsi que toute demande d’approbation. Un refus constitue une limite de politique, et non la preuve d’un échec d’authentification. | | Une application personnalisée Gemini grand public demande des identifiants | N’utilisez pas les identifiants client Enterprise ou CLI. L’URI de rappel grand public n’étant pas documenté actuellement, GWC refuse volontairement ce parcours. |

Lorsque vous contactez le support GWC, indiquez l’interface Gemini concernée (Enterprise ou CLI), l’étape de configuration et le message d’erreur exact. N’envoyez jamais de mots de passe, de jetons porteurs, de contenu de fichiers privés ni de véritable secret client.

9. Références officielles

Les étapes du fournisseur ont été vérifiées le 2026-10-22 (Asia/Singapore) par rapport à la documentation officielle actuelle en anglais de Google :