Collegare manualmente GWC Bridge a Claude

Collega GWC Bridge a Claude come connettore personalizzato in modo che Claude possa lavorare con i file e i comandi che autorizzi sul tuo PC.

Nota sulle etichette dell’interfaccia: Le etichette tra virgolette seguono la documentazione dell’interfaccia inglese del fornitore. Le etichette localizzate non sono state verificate e l’interfaccia potrebbe essere diversa. GWC Bridge consente a Claude di lavorare con i file e i comandi autorizzati sul tuo PC, dove è in esecuzione GWC for VS Code o GWC Studio. Questa guida descrive la configurazione di un connettore personalizzato in Claude; aggiungere manualmente un server non significa che Anthropic lo abbia esaminato o approvato.

1. Chi può usare questa procedura

Claude supporta i connettori remoti personalizzati nei piani Free, Pro, Max, Team ed Enterprise. Gli account Free possono avere un connettore personalizzato. Nei piani Team, un "Owner" (Proprietario) o "Primary Owner" (Proprietario principale) dell’organizzazione deve prima aggiungere GWC Bridge all’organizzazione; nei piani Enterprise, deve farlo un "Owner", un "Primary Owner" o un membro con un ruolo personalizzato che includa "Manage access to Libraries" (Gestisci l’accesso alle librerie).^[1]

L’accesso a Claude Code richiede un’abilitazione separata tramite un abbonamento supportato o un accordo della propria organizzazione. Un account Claude Free da solo non include l’accesso a Claude Code.^[3]

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 vuoi far utilizzare a Claude.
Accedi allo stesso account GWC nell’applicazione sul PC e durante l’autorizzazione del connettore in Claude; aggiungere l’URL di GWC Bridge in Claude non installa il componente sul PC.
Controlla i file, le cartelle e le autorizzazioni per i comandi che intendi rendere disponibili su quel PC e inizia concedendo solo l’accesso minimo necessario.
GWC Bridge rifiuta le richieste se chi le invia non è autenticato o non ha diritto al servizio; aggiungere il suo URL o visualizzare un elenco di strumenti non permette di aggirare questi controlli.

3. Indirizzo del server e OAuth

Usa questo indirizzo del server:

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

GWC Bridge si autentica automaticamente tramite il Client ID Metadata Document (CIMD) pubblicato da Claude e PKCE. Non serve, e non devi inserire, un OAuth Client ID o un OAuth Client Secret. Non incollare mai password, token di accesso o segreti del client in una conversazione con Claude o nelle intestazioni delle richieste.^[4]

Installazione alternativa tramite ZIP del plugin: Se la pagina di configurazione di GWC Bridge offre lo ZIP per Claude, scaricalo prima da lì. In Claude scegli Customize > Plugins > Add > Upload plugin e carica lo ZIP; apri GWC Bridge > Connectors > Connect e accedi con l’account GWC del computer. Scegli questo percorso o Add custom connector qui sotto, non entrambi.

4. Configurazione personale (Free, Pro o Max)

Accedi all’account Claude che intendi utilizzare su claude.ai (o in Claude Desktop) e apri "Customize" → "Connectors" (Personalizza → Connettori).
Fai clic su "+ Add" (+ Aggiungi), oppure su "+", e scegli "Add custom connector" (Aggiungi connettore personalizzato). Nel menu unificato, fai clic su "Add" → "Custom" → "Web".
Assegna al connettore il nome GWC Bridge e inserisci https://mcp.gwc-corp.com/mcp; se la finestra mostra una sezione "Advanced settings" (Impostazioni avanzate) con i campi facoltativi OAuth Client ID e OAuth Client Secret, lascia vuoti entrambi i campi.
Fai clic su "Continue" (Continua) (oppure su "Add" nella finestra a passaggio unico) per controllare le impostazioni di autenticazione rilevate: in "Authentication", mantieni selezionato "Sign in now" (non selezionare "No sign in"); in "OAuth client", mantieni selezionato "Use Claude's published identity (Recommended)" (non selezionare "Register automatically", perché GWC Bridge non utilizza la registrazione dinamica dei client, né "Use your own OAuth client"); e lascia vuoto "Request headers".
Fai clic su "Add" per completare la creazione del connettore, poi su "Connect" (Connetti) se la procedura di accesso non è già iniziata, e completa nel browser la procedura di accesso a GWC e di consenso alle autorizzazioni.
Verifica che GWC Bridge risulti connesso in "Customize" → "Connectors", apri "+" → "Connectors" (oppure il menu "Search and tools") in una conversazione per attivare GWC Bridge, mantieni l’obbligo di approvazione per le modifiche ai file e l’esecuzione di comandi finché non ti senti a tuo agio con l’accesso concesso ed 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.), controllando il risultato effettivo dello strumento e non soltanto l’affermazione di Claude che la connessione è riuscita.^[1]

5. Configurazione dell’organizzazione (Team o Enterprise)

Un "Owner" o "Primary Owner" dell’organizzazione (oppure, nei piani Enterprise, una persona con un ruolo personalizzato che includa "Manage access to Libraries") apre "Organization settings" → "Connectors" → "Add" → "Custom" → "Web" (oppure sceglie "Add custom connector").
Inserisci il nome GWC Bridge e l’URL del server https://mcp.gwc-corp.com/mcp, poi fai clic su "Continue".
Mantieni le impostazioni di autenticazione rilevate ("Sign in now" e "Use Claude's published identity (Recommended)"), lascia vuoti "Request headers" e tutti gli eventuali campi per le credenziali di un client OAuth personalizzato, quindi fai clic su "Add".
Dopo che il connettore è stato aggiunto all’organizzazione, ogni membro apre "Customize" → "Connectors", trova GWC Bridge (contrassegnato dall’etichetta "Custom"), fa clic su "Connect" per accedere con il proprio account GWC e lo attiva in "+" → "Connectors" (o "Search and tools").

Rendere disponibile il connettore a un’organizzazione non fa accedere automaticamente i suoi membri.^[1]

6. Dispositivi mobili e Claude Code

Configura e autentica prima GWC Bridge su Claude web o Claude Desktop, poi accedi allo stesso account Claude—e, dove previsto, alla stessa organizzazione—nell’app Claude per iOS o Android. I connettori web funzionano su Claude Mobile una volta configurati sul tuo account; l’installazione dei connettori direttamente da dispositivo mobile è attualmente in beta, quindi Claude Desktop e la versione web restano i canali principali per configurare connettori personalizzati.^[2]

In Claude Code, controlla prima /mcp: se accedi con il tuo account Claude, il connettore aggiunto su claude.ai potrebbe essere già caricato automaticamente, quindi evita di aggiungere una voce CLI duplicata se il connettore dell’account è già presente. Per aggiungere (o rimuovere in seguito) GWC Bridge direttamente tramite CLI nel terminale:^[3]

claude mcp add --transport http --scope user gwc-bridge https://mcp.gwc-corp.com/mcp
claude mcp remove gwc-bridge --scope user

Dopo aver aggiunto il server, avvia Claude Code, esegui /mcp, seleziona gwc-bridge, scegli "Authenticate" (Autentica) e completa la procedura di accesso a GWC nel browser. L’ambito user rende questo server disponibile in tutti i tuoi progetti su quel computer. Verifica lo stato del server ed esegui la prima verifica in sola lettura descritta sopra. La tua organizzazione potrebbe limitare i server MCP che Claude Code può caricare; non tentare di aggirare le regole dell’organizzazione modificando l’autenticazione o cambiando account.^[3]^[4]

7. Cosa può vedere Claude e come disconnettersi

GWC Bridge è più di un elenco di nomi di strumenti. Quando uno strumento autorizzato legge un file o restituisce l’output di un comando, quel contenuto viene inviato a Claude. Un connettore può anche rendere disponibili risorse MCP e prompt per i flussi di lavoro. Le azioni disponibili tramite GWC Bridge dipendono dalle tue autorizzazioni GWC e dalle regole di accesso alle cartelle del PC; i controlli delle autorizzazioni degli strumenti in Claude possono limitare gli strumenti che Claude richiama, ma non possono concedere un accesso che GWC Bridge rifiuta. Esamina attentamente le richieste di approvazione, soprattutto prima di modificare o eliminare file oppure eseguire comandi. Non presumere che il traffico di un connettore remoto rimanga esclusivamente locale: su claude.ai, Claude Desktop, Cowork e Claude Mobile, Claude si collega ai server MCP remoti dall’infrastruttura cloud di Anthropic. Aggiungere l’URL non concede mai automaticamente il controllo dello schermo, l’accesso illimitato ai file o l’esecuzione di comandi non approvati: sono disponibili solo le cartelle condivise e le funzionalità che hai autorizzato in GWC.

Per disconnettere o rimuovere GWC Bridge, apri "Customize" → "Connectors" e seleziona GWC Bridge:

"Disconnect" (Disconnetti) disconnette Claude da GWC Bridge, mantenendo il connettore nell’elenco.
"Remove" / "Delete" (Rimuovi / Elimina), nel menu del connettore, rimuove un connettore personalizzato personale dal tuo account.
La "Organization-wide removal" (rimozione per l’intera organizzazione) nei piani Team ed Enterprise deve essere eseguita da un proprietario autorizzato in "Organization settings" → "Connectors".
Disattivare il connettore dal menu "+" → "Connectors" o "Search and tools" di una conversazione lo disabilita solo per quella conversazione; se il connettore è sincronizzato dal tuo account claude.ai o fornito dalla tua organizzazione, gestiscilo o rimuovilo nelle impostazioni dei connettori di Claude (oppure disattivalo per il tuo utilizzo in /mcp).

8. Risoluzione dei problemi

Problema	Cosa controllare
Non compare l’opzione per aggiungere un connettore personalizzato	Con il piano Free, verifica se l’unico connettore personalizzato consentito è già in uso. Nei piani Team o Enterprise, chiedi a un proprietario dell’organizzazione (oppure a un amministratore Enterprise con "Manage access to Libraries") di aggiungerlo in "Organization settings" → "Connectors".
GWC Bridge non è presente nella directory dei connettori	Usa la procedura per aggiungere un connettore personalizzato tramite URL (`https://mcp.gwc-corp.com/mcp`). La configurazione manuale non richiede che il connettore sia elencato nella directory.
La configurazione richiede un OAuth Client ID o un OAuth Client Secret	Lascia vuoti i campi facoltativi Client ID e Client Secret in "Advanced settings". Non indovinare né inserire credenziali client statiche.
La registrazione del client OAuth non riesce	Nella finestra di configurazione in due passaggi, assicurati che "OAuth client" sia impostato su "Use Claude's published identity (Recommended)", non su "Register automatically" (GWC Bridge non usa la registrazione dinamica dei client) o "Use your own OAuth client".
L’accesso viene completato, ma GWC nega l’accesso al servizio	Verifica di aver effettuato l’accesso con l’account GWC desiderato e che il suo Connect Pass sia attivo. Non selezionare "No sign in" per aggirare il rifiuto.
“Couldn’t reach the MCP server” (Impossibile raggiungere il server MCP)	Ricontrolla che l’URL sia `https://mcp.gwc-corp.com/mcp`. Un’interruzione temporanea del servizio, un timeout durante il rilevamento OAuth o un blocco di rete tramite firewall/WAF tra gli intervalli IP di Anthropic e il server possono causare questo errore. Comunica all’assistenza GWC l’errore esatto e l’ID di riferimento.
Il connettore è connesso, ma Claude non usa gli strumenti	Verifica che GWC Bridge sia attivo nel menu "+" → "Connectors" / "Search and tools" della conversazione e che i singoli strumenti non siano disabilitati. Chiedi esplicitamente di eseguire un’azione con GWC Bridge.
Il PC o una cartella non è disponibile	Verifica 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 per questa connessione. Non passare a un altro PC senza verificare che sia quello desiderato.
La lettura funziona, ma le modifiche o i comandi non riescono	Controlla sia le impostazioni di approvazione degli strumenti in Claude sia le autorizzazioni "Change files" (Modifica file) / "Commands" (Comandi) della cartella in GWC. Considera un’autorizzazione negata come una restrizione da chiarire, non come un errore temporaneo da ritentare alla cieca.
Il connettore non compare sul dispositivo mobile	Verifica di aver effettuato l’accesso allo stesso account Claude e alla stessa organizzazione sul dispositivo mobile e completa prima la configurazione iniziale del connettore personalizzato su Claude web o Desktop.
Claude Code non mostra un connettore aggiunto dal web	Esegui `/status` per controllare il metodo di accesso. L’accesso con una chiave API o con un profilo di un altro provider impedisce il caricamento dei connettori dell’account claude.ai. Controlla anche le regole MCP dell’organizzazione in `/mcp`.
Claude Code richiede l’autenticazione o il browser non si apre	Esegui `/mcp`, seleziona `gwc-bridge` e scegli "Authenticate". Se il browser non si avvia automaticamente, copia e apri l’URL di autorizzazione mostrato nel terminale.
Una modifica a un file o un comando va in timeout	Non presumere che l’azione sia fallita completamente. Controlla lo stato attuale del file o le attività recenti prima di ripetere un’operazione che modifica lo stato.

Quando contatti l’assistenza GWC, indica l’app o l’interfaccia Claude che stai utilizzando, il tipo di piano Claude, il passaggio in cui si è verificato il problema e gli eventuali messaggi di errore o ID di riferimento. Non inviare mai password, token bearer, segreti del client o contenuti di file privati.

9. Riferimenti ufficiali

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