Conectar GWC Bridge manualmente a Gemini

Conecte GWC Bridge a Gemini para que Gemini pueda trabajar con los archivos y comandos que usted permita en su propio PC.

Nota sobre las etiquetas de la interfaz: Las etiquetas entre comillas siguen la documentación actual en inglés de Google. Su interfaz puede variar a medida que Google despliega funciones. GWC Bridge permite que Gemini trabaje con los archivos y comandos autorizados en su propio PC, donde se ejecuta GWC for VS Code o GWC Studio. Añadir un servidor MCP personalizado no significa que Google haya revisado o respaldado GWC Bridge.

1. Quién puede utilizar esta vía

Gemini: Un administrador puede añadir un almacén de datos de tipo «Custom MCP Server» después de que la política de organización gestionada del proyecto permita conectores MCP personalizados. Google exige el rol Discovery Engine Editor para el administrador que crea el almacén de datos, y pueden aplicarse cambios adicionales en las políticas de salida (egress) o de orígenes de datos cuando VPC Service Controls o la aplicación gestionada de políticas están habilitados.^[1]^[2]

Gemini CLI: GWC Bridge no admite actualmente esta vía. No configures un cliente OAuth estático para Gemini CLI.

Aplicaciones personalizadas de Gemini para consumidores: Actualmente Google limita las aplicaciones personalizadas a los usuarios que cumplen los requisitos: tener 18 años o más, estar en EE. UU., haber iniciado sesión con una cuenta personal de Google, tener activada la opción Keep Activity (Guardar la actividad) y utilizar el idioma inglés para esta función. La configuración comienza en la aplicación web de Gemini.^[4] GWC Bridge aún no está habilitado para este flujo de consumo. Google documenta la introducción de credenciales en “Advanced features” (Funciones avanzadas) cuando un servidor no dispone de registro dinámico de clientes (Dynamic Client Registration), pero su página de ayuda actual no publica el URI de devolución de llamada que GWC tendría que autorizar. GWC no lo adivinará ni aceptará una redirección con comodines.

2. Antes de empezar

Tenga preparada su cuenta de GWC, un Connect Pass activo y GWC for VS Code o GWC Studio en ejecución y conectado en el PC que desea que utilice Gemini.
Inicie sesión con la misma cuenta de GWC cuando se abra la ventana de OAuth. Añadir la URL de MCP no instala ni inicia el componente del PC.
Revise los permisos de archivos, carpetas y comandos expuestos por ese PC. Empiece con el acceso mínimo que necesite.
GWC Bridge sigue aplicando sus propias políticas de cuentas, concesiones, carpetas, recursos, aprobaciones y comandos. Gemini no puede concederse a sí mismo un acceso que GWC rechaza.

3. Dirección del servidor y OAuth

Utilice esta dirección del servidor MCP:

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

Los puntos de conexión OAuth de GWC son:

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

La vía compatible de Gemini usa Authorization Code con PKCE S256. Su ID de cliente estático es un identificador público vinculado al callback alojado exacto de Google. GWC Bridge no registra actualmente un cliente OAuth para Gemini CLI.

4. Configuración de administrador en Gemini

Google trata la configuración de un Custom MCP Server como una operación de administrador para toda la organización.^[1]

En Google Cloud, seleccione el proyecto propietario de la aplicación de Gemini.
Abra Organization Policies (Políticas de la organización) y busque Disable custom MCP server connector for Gemini Enterprise (constraints/discoveryengine.managed.disableCustomMcpServerConnector). Anule la política superior para este proyecto y establezca su aplicación en Off (Desactivado). No desactive la política para un ámbito más amplio de la organización a menos que se trate de una decisión intencionada de gobernanza de su organización.^[2]
Si su proyecto está protegido por VPC Service Controls, o si las políticas gestionadas de conectores relacionadas están activas en este proyecto, permita custom_mcp como origen de datos y permita el tráfico de salida hacia mcp.gwc-corp.com y api.gwc-corp.com.^[1]^[5]
Conceda al administrador que crea el almacén de datos el rol obligatorio Discovery Engine Editor (roles/discoveryengine.editor).^[1]
Abra Gemini Enterprise → Data stores (Almacenes de datos) → Create data store (Crear almacén de datos) → Custom MCP Server → Add MCP server (Añadir servidor MCP).
Elija OAuth 2.0 e introduzca:

Campo	Valor
MCP Server URL	`https://mcp.gwc-corp.com/mcp`
Authorization URL	`https://api.gwc-corp.com/oauth/authorize`
Authorization URL Parameters	Dejar en blanco (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

El ejemplo actual de Google Cloud para una aplicación MCP de Gemini muestra igualmente PKCE habilitado y HTTP Basic desmarcado.^[7]

La redirección documentada por Google para este conector es exactamente https://vertexaisearch.cloud.google.com/oauth-redirect; el perfil de cliente de GWC acepta ese URI y ninguna ruta paralela, host alternativo ni comodín.^[1] El valor none no es un secreto compartido. Las propias instrucciones de Looker MCP de Google utilizan ese literal cuando el formulario exige rellenar el campo Client Secret para un cliente público con PKCE.^[6]

Haga clic en Verify Auth (Verificar autenticación), inicie sesión en GWC, revise los permisos solicitados de GWC y apruébelos solo si la cuenta y el destino son correctos.
Termine de crear el almacén de datos. Espere a que su estado pase a Active (Activo).
Abra la vista Actions (Acciones) del almacén de datos, vuelva a cargar las acciones personalizadas si es necesario y habilite únicamente las herramientas de GWC Bridge que desea que utilice Gemini. Google desactiva las acciones de MCP personalizado de forma predeterminada.^[1]
Conecte el almacén de datos a la aplicación de Gemini deseada y realice una primera comprobación de solo lectura: 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 puede conectarse a servidores MCP remotos, pero GWC Bridge no habilita actualmente un cliente OAuth para Gemini CLI. No añadas todavía un perfil OAuth de GWC Bridge a Gemini CLI. Esta vía seguirá sin estar admitida hasta que GWC publique un mecanismo de identidad del cliente revisado por separado.

6. Aplicaciones personalizadas de Gemini para consumidores

La ayuda de Gemini Apps para consumidores de Google indica que los usuarios que cumplen los requisitos pueden abrir Settings → Connected Apps (Configuración → Aplicaciones conectadas), añadir una aplicación personalizada mediante la URL del servidor MCP y —cuando el servidor no admite el registro dinámico de clientes— abrir Advanced features (Funciones avanzadas) e introducir las credenciales.^[4]

No introduzca hoy ninguno de los dos ID de cliente estáticos de GWC allí. La página de ayuda actual de Google no documenta el URI de devolución de llamada de OAuth para aplicaciones personalizadas de consumo, y GWC no dispone de un punto de conexión de registro dinámico de clientes. Reutilizar la devolución de llamada de Enterprise o la devolución de llamada local (loopback) de la CLI sería incorrecto; aceptar un comodín debilitaría la vinculación de redirección de OAuth.

Esta vía solo podrá admitirse cuando se cumpla al menos una de las siguientes condiciones:

Google publique un URI exacto y estable de devolución de llamada para consumidores que GWC pueda vincular a un ID de cliente público específico; o
GWC implemente y revise en materia de seguridad un registro dinámico de clientes que satisfaga el flujo de registro de clientes de Gemini.

Hasta entonces, la única vía compatible para clientes de esta guía es Gemini.

7. Lo que Gemini puede ver y cómo desconectarlo

Cuando Gemini invoca una herramienta de GWC Bridge, el resultado de la herramienta puede incluir nombres de archivos, contenido de archivos, salidas de comandos, etiquetas de dispositivos u otros datos devueltos por la herramienta autorizada. Ese contenido sale de su PC y es procesado por la interfaz de Gemini que haya elegido. Google señala que los servidores MCP personalizados de terceros están fuera del control de Google y recomienda conectar únicamente servidores de su confianza.^[4]

Los permisos de GWC Bridge siguen siendo la autoridad definitiva:

La lectura de archivos se limita a las carpetas compartidas con la conexión activa de GWC Bridge.
Los cambios en archivos requieren que tanto la conexión como la carpeta permitan cambios, además de superar las comprobaciones de acciones protegidas.
Los comandos requieren que la conexión permita Commands y pueden seguir requiriendo aprobación.
Un PC distinto, una cuenta distinta o una concesión revocada no son intercambiables con los que usted autorizó.

Para desconectar:

Gemini: un administrador puede desactivar las acciones, desconectar el almacén de datos de la aplicación o eliminar el almacén de datos MCP personalizado según la política de la organización.
Gemini CLI: no hay ningún cliente OAuth de GWC habilitado. Elimina cualquier perfil OAuth experimental de GWC Bridge en lugar de intentar autenticarlo.
En GWC, revocar la concesión subyacente de Bridge invalida el acceso con independencia de la configuración en el lado de Gemini.

8. Solución de problemas

Síntoma	Qué comprobar
Se intenta usar OAuth con Gemini CLI	Detente. GWC Bridge no admite actualmente OAuth para Gemini CLI.
Gemini indica que Custom MCP Server está bloqueado	Confirme que la restricción gestionada a nivel de proyecto Disable custom MCP server connector for Gemini Enterprise esté anulada y establecida en Off. Si se aplican VPC Service Controls o la aplicación gestionada de políticas, permita también `custom_mcp` y los FQDN de salida necesarios.
Verify Auth informa de una redirección no válida	Confirme que Client ID sea exactamente `gwc-google-gemini-v1`. GWC solo acepta para ese cliente la dirección documentada por Google `https://vertexaisearch.cloud.google.com/oauth-redirect`.
Verify Auth informa de un secreto de cliente no válido	Introduzca exactamente `none`, active PKCE y deje Use HTTP Basic desactivado. GWC trata este valor únicamente como el marcador de posición obligatorio del formulario de Google para este cliente público concreto; cualquier otro secreto se rechaza.
La autorización falla de inmediato	Confirme que GWC haya habilitado el OAuth manual de Gemini. El indicador de compatibilidad del lado del servidor está desactivado de forma predeterminada.
Gemini no puede comunicarse con el servidor ni con los puntos de conexión OAuth	Si se aplican controles de salida, permita tanto `mcp.gwc-corp.com` como `api.gwc-corp.com`. Vuelva a comprobar exactamente las URL HTTPS.
El almacén de datos está Active, pero Gemini no invoca herramientas	Las acciones de MCP personalizado están desactivadas de forma predeterminada. Habilite las acciones deseadas y conecte el almacén de datos a la aplicación de Gemini correspondiente.

| El inicio de sesión se completa, pero GWC rechaza el acceso | Verifique la cuenta de GWC y que el Connect Pass esté activo, y revise después la concesión de Bridge y los permisos del PC. No reintente a ciegas una herramienta que modifique el estado. | | El PC o la carpeta no están disponibles | Confirme que el PC deseado esté en línea, que GWC Studio o GWC for VS Code esté en ejecución y conectado, y que la carpeta esté compartida con esta conexión. | | La lectura funciona, pero fallan las ediciones o los comandos | Revise los permisos Change files (Cambiar archivos) / Commands (Comandos) de GWC Bridge y cualquier solicitud de aprobación. Un rechazo es un límite de política, no una prueba de que haya fallado la autenticación. | | Una aplicación personalizada de Gemini para consumidores solicita credenciales | No utilice los ID de cliente de Enterprise ni de CLI. El URI de devolución de llamada para consumidores no está documentado actualmente, por lo que GWC rechaza esta vía de forma intencionada. |

Al contactar con el soporte de GWC, indique la interfaz de Gemini (Enterprise o CLI), el paso de configuración y el mensaje de error exacto. Nunca envíe contraseñas, tokens de portador, contenido de archivos privados ni ningún secreto de cliente real.

9. Referencias oficiales

Los pasos del proveedor se comprobaron el 2026-10-22 (Asia/Singapore) con la documentación oficial actual en inglés de Google: