Collegare manualmente GWC Bridge a Gemini

Collega GWC Bridge a Gemini in modo che Gemini possa lavorare con i file e i comandi che autorizzi sul tuo PC.

Nota sulle etichette dell’interfaccia: Le etichette tra virgolette seguono l’attuale documentazione in inglese di Google. L’interfaccia potrebbe variare man mano che Google rilascia nuove funzionalità. GWC Bridge consente a Gemini di lavorare con i file e i comandi autorizzati sul tuo PC, dove è in esecuzione GWC for VS Code o GWC Studio. Aggiungere un server MCP personalizzato non significa che Google abbia esaminato o approvato GWC Bridge.

1. Chi può usare questa procedura

Gemini: Un amministratore può aggiungere un data store Custom MCP Server dopo che il criterio dell’organizzazione gestito del progetto consente i connettori MCP personalizzati. Google richiede il ruolo Discovery Engine Editor per l’amministratore che crea il data store; inoltre possono essere necessarie ulteriori modifiche ai criteri di egress e delle origini dati quando sono attivi i VPC Service Controls o l’applicazione gestita dei criteri.^[1]^[2]

Gemini CLI: GWC Bridge non supporta ancora questo percorso. Non configurare un client OAuth Gemini CLI statico.

App personalizzate di Gemini per utenti consumer: Attualmente Google limita le app personalizzate agli utenti idonei: almeno 18 anni di età, negli Stati Uniti, con accesso effettuato tramite un Google Account personale, “Keep Activity” (Conserva attività) attivo e lingua inglese per questa funzionalità. La configurazione inizia nell’app web di Gemini.^[4] GWC Bridge non è ancora abilitato per questo flusso consumer. Google documenta l’inserimento delle credenziali in “Advanced features” (Funzionalità avanzate) quando un server non supporta la Dynamic Client Registration, ma la pagina di assistenza attuale non pubblica l’URI di callback che GWC dovrebbe autorizzare. GWC non tenterà di indovinarlo né accetterà un reindirizzamento con caratteri jolly (wildcard).

2. Prima di iniziare

Tieni pronto il tuo account GWC, verifica di avere un Connect Pass attivo e assicurati che GWC for VS Code o GWC Studio sia in esecuzione e connesso sul PC che intendi far utilizzare a Gemini.
Accedi allo stesso account GWC quando si apre la finestra OAuth. Aggiungere l’URL MCP non installa né avvia il componente sul PC.
Controlla i file, le cartelle e le autorizzazioni per i comandi esposti da quel PC. Inizia concedendo solo l’accesso minimo necessario.
GWC Bridge continua ad applicare i propri criteri relativi ad account, concessioni, cartelle, risorse, approvazioni e comandi. Gemini non può concedersi un accesso che GWC rifiuta.

3. Indirizzo del server e OAuth

Usa questo indirizzo del server MCP:

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

Gli endpoint OAuth di GWC sono:

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

Il percorso supportato per Gemini usa Authorization Code con PKCE S256. Il suo ID client statico è un identificatore pubblico vincolato al callback ospitato esatto di Google. GWC Bridge non registra attualmente un client OAuth Gemini CLI.

4. Configurazione amministratore per Gemini

Google tratta la configurazione di un Custom MCP Server come un’operazione amministrativa a livello di organizzazione.^[1]

In Google Cloud, seleziona il progetto a cui appartiene l’app Gemini.
Apri Organization Policies (Criteri dell’organizzazione) e individua Disable custom MCP server connector for Gemini Enterprise (constraints/discoveryengine.managed.disableCustomMcpServerConnector). Sovrascrivi il criterio padre per questo progetto e imposta l’applicazione su Off. Non disabilitare il criterio per un ambito organizzativo più ampio a meno che non si tratti di una precisa decisione di governance della tua organizzazione.^[2]
Se il progetto è protetto da VPC Service Controls, o se per questo progetto sono applicati i relativi criteri gestiti per i connettori, consenti custom_mcp come origine dati e autorizza il traffico in uscita (egress) verso mcp.gwc-corp.com e api.gwc-corp.com.^[1]^[5]
Assegna all’amministratore che crea il data store il ruolo obbligatorio Discovery Engine Editor (roles/discoveryengine.editor).^[1]
Apri Gemini Enterprise → Data stores → Create data store → Custom MCP Server → Add MCP server.
Scegli OAuth 2.0 e inserisci:

Campo	Valore
MCP Server URL	`https://mcp.gwc-corp.com/mcp`
Authorization URL	`https://api.gwc-corp.com/oauth/authorize`
Authorization URL Parameters	Lascia vuoto (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

Anche l’esempio attuale di Google Cloud per un’app MCP di Gemini mostra PKCE abilitato e HTTP Basic deselezionato.^[7]

L’URI di reindirizzamento documentato da Google per questo connettore è esattamente https://vertexaisearch.cloud.google.com/oauth-redirect; il profilo client di GWC accetta solo tale URI e nessun percorso affine, host alternativo o carattere jolly.^[1] Il valore none non è un segreto condiviso: le stesse istruzioni di Google per il server MCP di Looker utilizzano quel valore letterale quando il modulo richiede il campo Client Secret per un client pubblico PKCE.^[6]

Fai clic su Verify Auth (Verifica autenticazione), accedi a GWC, esamina le autorizzazioni GWC richieste e approva solo se l’account e la destinazione sono corretti.
Completa la creazione del data store e attendi che lo stato diventi Active (Attivo).
Apri la vista Actions (Azioni) del data store, ricarica le azioni personalizzate se necessario e abilita solo gli strumenti di GWC Bridge che intendi far utilizzare a Gemini. Per impostazione predefinita, Google disabilita le azioni dei server MCP personalizzati.^[1]
Collega il data store all’app Gemini desiderata, quindi esegui una prima verifica in sola lettura: 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 può collegarsi a server MCP remoti, ma GWC Bridge non abilita attualmente un client OAuth Gemini CLI. Non aggiungere ancora un profilo OAuth GWC Bridge a Gemini CLI. Questo percorso resta non supportato finché GWC non pubblica un meccanismo di identità del client sottoposto a revisione separata.

6. App personalizzate di Gemini per utenti consumer

La guida di Google per le app consumer Gemini indica che gli utenti idonei possono aprire Settings → Connected Apps (Impostazioni → App connesse), aggiungere un’app personalizzata tramite l’URL del server MCP e—quando il server non supporta la Dynamic Client Registration—aprire Advanced features (Funzionalità avanzate) e inserire le credenziali.^[4]

Non inserire oggi nessuno dei due Client ID statici di GWC in quella schermata. L’attuale pagina di assistenza di Google non documenta l’URI di callback OAuth delle app personalizzate consumer e GWC non dispone di un endpoint di Dynamic Client Registration. Riutilizzare il callback di Enterprise o il callback di loopback della CLI sarebbe errato; accettare un carattere jolly indebolirebbe il vincolo di reindirizzamento OAuth.

Questo percorso potrà essere supportato solo quando sarà vera almeno una delle seguenti condizioni:

Google pubblicherà un URI di callback consumer stabile ed esatto che GWC possa associare a un Client ID pubblico dedicato; oppure
GWC implementerà e sottoporrà a revisione di sicurezza una Dynamic Client Registration conforme al flusso di registrazione client di Gemini.

Fino ad allora, l’unico percorso cliente supportato in questa guida è Gemini.

7. Cosa può vedere Gemini e come disconnettersi

Quando Gemini richiama uno strumento di GWC Bridge, il risultato dello strumento può includere nomi di file, contenuti di file, output di comandi, etichette di dispositivi o altri dati restituiti dallo strumento autorizzato. Tali contenuti lasciano il tuo PC e vengono elaborati dall’interfaccia Gemini che hai scelto. Google precisa che i server MCP personalizzati di terze parti sono al di fuori del controllo di Google e raccomanda di connettere solo server di cui ci si fida.^[4]

Le autorizzazioni di GWC Bridge restano l’unica fonte autorevole:

La lettura dei file è limitata alle cartelle condivise con la connessione GWC Bridge attiva.
Le modifiche ai file richiedono che la connessione e la cartella consentano le modifiche, oltre agli eventuali controlli per le azioni protette.
I comandi richiedono che la connessione consenta Commands e possono comunque richiedere un’approvazione.
Un PC diverso, un account diverso o una concessione revocata non sono intercambiabili con quelli che hai autorizzato.

Per disconnettere:

Gemini: un amministratore può disabilitare le azioni, scollegare il data store dall’app o rimuovere il data store MCP personalizzato secondo i criteri dell’organizzazione.
Gemini CLI: non è abilitato alcun client OAuth GWC. Rimuovi qualsiasi profilo OAuth GWC Bridge sperimentale invece di tentare l’autenticazione.
In GWC, la revoca della concessione Bridge sottostante invalida l’accesso indipendentemente dalla configurazione lato Gemini.

8. Risoluzione dei problemi

Sintomo	Cosa controllare
Si tenta OAuth con Gemini CLI	Interrompi. GWC Bridge non supporta attualmente OAuth per Gemini CLI.
Gemini segnala che il Custom MCP Server è bloccato	Verifica che il vincolo gestito a livello di progetto Disable custom MCP server connector for Gemini Enterprise sia sovrascritto e impostato su Off. Se si applicano VPC Service Controls o criteri gestiti, consenti anche `custom_mcp` e gli FQDN di egress richiesti.
Verify Auth segnala un reindirizzamento non valido	Verifica che il Client ID sia esattamente `gwc-google-gemini-v1`. Per quel client GWC accetta solo l’URI documentato da Google `https://vertexaisearch.cloud.google.com/oauth-redirect`.
Verify Auth segnala un Client Secret non valido	Inserisci esattamente `none`, abilita PKCE e lascia Use HTTP Basic impostato su Off. GWC accetta questo valore solo come segnaposto richiesto dal modulo di Google per questo specifico client pubblico; qualsiasi altro segreto viene rifiutato.
L’autorizzazione fallisce immediatamente	Verifica che GWC abbia abilitato l’OAuth manuale per Gemini. L’interruttore di compatibilità lato server è disattivato per impostazione predefinita.
Gemini non riesce a raggiungere il server o gli endpoint OAuth	Se sono attivi controlli sul traffico in uscita (egress), consenti sia `mcp.gwc-corp.com` sia `api.gwc-corp.com`. Ricontrolla che gli URL HTTPS siano esatti.
Il data store è Active ma Gemini non richiama gli strumenti	Le azioni dei server MCP personalizzati sono disabilitate per impostazione predefinita. Abilita le azioni desiderate e collega il data store all’app Gemini prevista.

| L’accesso riesce ma GWC rifiuta l’accesso al servizio | Verifica l’account GWC e che il Connect Pass sia attivo, quindi controlla la concessione Bridge e le autorizzazioni del PC. Non ritentare alla cieca uno strumento che modifica lo stato. | | Il PC o una cartella non è disponibile | Conferma che il PC desiderato sia online, che GWC Studio o GWC for VS Code sia in esecuzione e connesso e che la cartella sia condivisa con questa connessione. | | La lettura funziona ma le modifiche o i comandi falliscono | Controlla le autorizzazioni Change files / Commands di GWC Bridge e gli eventuali prompt di approvazione. Un rifiuto è un limite previsto dai criteri, non la prova di un errore di autenticazione. | | L’app personalizzata consumer di Gemini chiede le credenziali | Non usare i Client ID di Enterprise o della CLI. L’URI di callback consumer non è attualmente documentato, pertanto GWC rifiuta intenzionalmente questo percorso. |

Quando contatti l’assistenza GWC, indica la piattaforma Gemini utilizzata (Enterprise o CLI), il passaggio della configurazione e il messaggio di errore esatto. Non inviare mai password, token bearer, contenuti di file privati o alcun segreto client reale.

9. Riferimenti ufficiali

I passaggi del fornitore sono stati verificati il 2026-10-22 (Asia/Singapore) rispetto alla documentazione ufficiale in inglese di Google: