Collegare manualmente GWC Bridge a ChatGPT

Collega GWC Bridge a ChatGPT come connettore personalizzato in modo che ChatGPT 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.

1. Chi può usare questa procedura

Usare ChatGPT sul Web (https://chatgpt.com) con un account o uno spazio di lavoro ChatGPT Business, Enterprise o Edu che consenta "Add custom MCP server". Il Centro assistenza OpenAI documenta il supporto MCP completo, incluse le azioni di scrittura, per Business ed Enterprise/Edu; per Pro descrive l’accesso MCP personalizzato come lettura/recupero, e questi riferimenti non dimostrano un accesso completo equivalente per Free o Plus. Su ChatGPT Business, solo gli Admins and Owners (Amministratori e proprietari) dello spazio di lavoro possono creare e pubblicare plugin di server MCP personalizzati (verificare "Workspace settings" → "Members"). Su ChatGPT Enterprise ed Edu, gli Admins and Owners possono creare, testare e pubblicare connessioni MCP personalizzate, e gli amministratori possono usare il controllo degli accessi basato sui ruoli (RBAC) in "Workspace settings" → "Permissions & roles" per concedere a membri selezionati l’autorizzazione "Create plugins with MCPs" per creare e testare connessioni, mentre gli Admins and Owners gestiscono la pubblicazione nello spazio di lavoro e i controlli sulle azioni. Verificare i controlli realmente disponibili per il proprio account; GWC non può modificare i requisiti del fornitore o le regole dello spazio di lavoro.^[2]

2. Preparare il computer

Sul computer di destinazione, usare una versione ufficiale supportata di GWC Studio, se disponibile per il proprio sistema operativo, oppure installare GWC for VS Code in Visual Studio Code.
Aprire l’applicazione, accedere al proprio account GWC, collegare il computer previsto e mantenere il componente GWC in esecuzione e online. Autorizzare lo stesso account GWC nel connettore.
Condividere prima una cartella di test senza dati sensibili e verificare le autorizzazioni effettive Change files e Commands di questa app sul computer, non soltanto le istruzioni scritte in un prompt di chat. I confini delle cartelle, i percorsi protetti, le autorizzazioni di connessione, il principio del privilegio minimo e le conferme sul computer restano controlli separati applicati dal server.
Mantenere un GWC Personal Connect Pass attivo (Connect Pass) per l’autorizzazione remota e le azioni degli strumenti. GWC rifiuta le chiamate non autenticate o prive di diritto al servizio indipendentemente dall’abbonamento ChatGPT. La visualizzazione di un elenco di strumenti non dimostra l’accesso, e aggiungere un connettore remoto non installa il componente sul computer.

3. Indirizzo del server e OAuth

Incollare questo esatto indirizzo HTTPS del server MCP remoto nel campo URL del server del connettore:

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

Usare l’accesso individuale OAuth 2.1 con PKCE (S256) e il rilevamento automatico dei Client ID Metadata Documents (CIMD) (client_id_metadata_document_supported: true). Le richieste non autenticate a https://mcp.gwc-corp.com/mcp restituiscono 401 Unauthorized con un’intestazione WWW-Authenticate contenente resource_metadata che punta ai metadati della risorsa protetta (https://mcp.gwc-corp.com/.well-known/oauth-protected-resource, RFC 9728) e al server di autorizzazione https://api.gwc-corp.com. Lasciare vuote le "Advanced OAuth settings" ("Client ID" e "Client Secret") e non scegliere "No authentication": GWC usa client pubblici (none) con CIMD anziché la registrazione dinamica dei client (DCR) o segreti statici, e l’inserimento di credenziali statiche prevale sul rilevamento automatico CIMD. Non incollare mai password GWC, token di accesso/aggiornamento o chiavi API nei prompt o nelle intestazioni delle richieste.^[3]

Il supporto manuale è disattivato per impostazione predefinita. Quando viene attivato, gli host predefiniti dei metadati client sono chatgpt.com, openai.com e claude.ai. L’host di Claude è esattamente claude.ai; la configurazione predefinita non ammette claude.com, altri sottodomini o porte esplicite, inclusa :443. Un elenco di host configurato dall’operatore sostituisce questi valori, quindi GWC deve confermare la configurazione effettiva.

Quando il supporto manuale è attivo, GWC annuncia e accetta offline_access (supporto per il tipo di autorizzazione refresh_token) e lo conserva se richiesto nel flusso OAuth. I token di aggiornamento esistenti vengono ruotati; il client deve utilizzare ogni token sostitutivo. Questo ambito non aggiunge autorizzazioni per file, comandi o altre funzioni del computer. Il computer deve restare online per le azioni degli strumenti. Una connessione revocata o non valida richiede un nuovo accesso ufficiale.

Installazione alternativa tramite ZIP del plugin: Se la pagina di configurazione di GWC Bridge offre lo ZIP per ChatGPT, scaricalo prima da lì. In ChatGPT selezionare Plugins > Add > Upload plugin e caricare lo ZIP; aprire GWC Bridge > Connect e accedere con l’account GWC del computer. Se appare Open in desktop app, completare lì. Utilizzare questo metodo oppure Add custom MCP server più avanti, non entrambi.

4. Configurazione personale

Aprire ChatGPT sul Web, aprire "Plugins" dalla barra laterale di navigazione, quindi selezionare "+" → "Add custom MCP server". Non è necessario attivare prima un interruttore separato per "Developer Mode".
Inserire il nome GWC Bridge (e, facoltativamente, una descrizione), quindi in "Connection" scegliere "Server URL" e inserire https://mcp.gwc-corp.com/mcp.
Impostare "Authentication" su "OAuth" e lasciare vuote le "Advanced OAuth settings" ("Client ID" e "Client Secret") in modo che ChatGPT rilevi automaticamente i metadati OAuth di GWC tramite Client ID Metadata Documents (CIMD). Non inserire un segreto client e non usare "No authentication".
Leggere l’avviso sui rischi relativo al server, selezionare "I understand and want to continue", quindi selezionare "Create as a plugin". Completare l’accesso a GWC e la richiesta di consenso nel browser al reindirizzamento, poi esaminare gli strumenti e i metadati rilevati nella pagina dei dettagli del plugin.
Aprire la voce nei propri "Plugins" personali (oppure passare da "Chat" a "Work" nella pagina iniziale), avviare una nuova conversazione sul Web e selezionare "+" nel campo di composizione del messaggio o digitare @ / / per selezionare GWC Bridge.
Iniziare con un prompt di verifica in sola lettura (ad esempio identificando il computer disponibile ed elencando i nomi dei file nella cartella di test autorizzata senza leggere il contenuto dei file, modificare file o eseguire comandi). In "Settings" → "Plugins" o "Settings" → "Apps", mantenere attive le conferme per le operazioni di scrittura e i comandi; le impostazioni di conferma di ChatGPT non sostituiscono né ampliano mai le autorizzazioni per cartelle e comandi applicate da GWC sul PC stesso.^[1]

5. Configurazione dell’organizzazione o dell’area di lavoro

Un Admin or Owner autorizzato verifica i permessi dello spazio di lavoro ("Workspace settings" → "Members" su Business, oppure "Workspace settings" → "Permissions & roles" su Enterprise/Edu dove l’RBAC può concedere "Create plugins with MCPs") e crea GWC Bridge tramite "Plugins" con https://mcp.gwc-corp.com/mcp e "OAuth" lasciando vuote le credenziali statiche.
Eseguire un test privato in una nuova conversazione sul Web prima dell’attivazione nello spazio di lavoro: verificare la selezione degli strumenti, gli argomenti, i limiti delle autorizzazioni e un elenco in sola lettura su una cartella di test priva di dati sensibili. Non usare mai dati di produzione, eliminazione di file, installazione di pacchetti, distribuzioni o comandi shell ad ampio raggio come primo test della connessione.
Dalla pagina dei dettagli del plugin GWC Bridge (oppure "Admin console" → "Plugins" → "Manage Legacy Apps" → "Drafts" / "Workspace Settings" → "Apps" → "Drafts" → "Publish"), un Admin or Owner pubblica il plugin nello spazio di lavoro o per i ruoli Enterprise/Edu designati dopo aver esaminato i controlli sulle azioni. La pubblicazione nello spazio di lavoro condivide il plugin solo all’interno della propria organizzazione e non costituisce un invio alla directory pubblica di OpenAI.
Ogni membro dello spazio di lavoro apre "Settings" → "Plugins" (o "Settings" → "Apps"), seleziona GWC Bridge → "Connect" e accede con il proprio account GWC (con un Connect Pass attivo e un PC online). Collegare un account GWC non cambia lo spazio di lavoro ChatGPT attivo dell’utente; non condividere mai le credenziali di un amministratore e non incollare token nella chat.

I plugin MCP pubblicati o connessi mantengono in cache le definizioni degli strumenti finché non vengono aggiornati. Quando GWC aggiunge o aggiorna strumenti, un amministratore o un utente autorizzato può aprire la pagina dei dettagli di GWC Bridge nelle impostazioni "Plugins" / "Apps" e selezionare "Refresh" per recuperare gli strumenti, le descrizioni e le istruzioni del server aggiornati senza eliminare il plugin (se cambiano i metadati di rilevamento OAuth .well-known, ricreare il plugin). Su Enterprise ed Edu, gli amministratori e i proprietari possono anche attivare o disattivare singole azioni dell’app dopo la pubblicazione.^[2]

Per rimuovere l’accesso, aprire "Settings" → "Plugins" (o "Settings" → "Apps"), selezionare GWC Bridge e scegliere "Disconnect" per un singolo account, oppure disattivare/rimuovere il plugin pubblicato dalla pagina di amministrazione "Plugins" (o "Manage Legacy Apps") dello spazio di lavoro. La disconnessione interrompe le future chiamate remote agli strumenti senza eliminare le trascrizioni delle chat precedenti né terminare automaticamente un processo locale di lunga durata già avviato sul computer; controllare sempre GWC Studio o GWC for VS Code sul PC prima di ritentare un comando o una modifica a un file interrotti.^[2]

6. Altri client

OpenAI documenta le connessioni MCP personalizzate per spazi di lavoro e account personali su ChatGPT sul Web. Non presumere che le app mobili di ChatGPT o le app desktop native offrano lo stesso percorso manuale di configurazione o esecuzione MCP; continuare a usare ChatGPT in un browser desktop anziché tentare ripetutamente di riconnettersi dalle app mobili.^[2]

Se lo spazio di lavoro mostra la vista di amministrazione precedente per le app personalizzate ("Admin console" → spazio di lavoro → "Plugins" → "Manage Legacy Apps", oppure "Workspace settings" → "Apps" → "Create" con "Scan Tools" e "Workspace Settings" → "Apps" → "Drafts"), usarla solo dove lo spazio di lavoro presenta tale interfaccia. Non mescolare i passaggi dell’interfaccia attuale "Plugins" e dell’interfaccia precedente "Apps", e non presumere che l’assenza di un menu precedente significhi che GWC sia stato approvato o rifiutato.^[2]

7. Risoluzione dei problemi

Cosa può apparire	Passaggio successivo
Controllo di configurazione assente — "Add custom MCP server"	Verificare di usare ChatGPT sul Web, di trovarsi nello spazio di lavoro Business, Enterprise o Edu desiderato (o in un account idoneo) e di avere un ruolo Admin/Owner o un ruolo Enterprise/Edu con l’autorizzazione "Create plugins with MCPs".
`invalid_client` — inserimento manuale di Client ID/Secret o `client_id host is not allowed`	Lasciare "Client ID" e "Client Secret" vuoti durante la creazione del plugin in modo che ChatGPT usi i Client ID Metadata Documents (`client_id_metadata_document_supported: true` su `chatgpt.com` / `openai.com`), e chiedere a GWC di verificare l’attivazione manuale e l’elenco degli host consentiti. GWC non usa segreti statici né la registrazione dinamica dei client (DCR).
`invalid_request` — `redirect_uri is not registered by the client`	ChatGPT usa `https://chatgpt.com/connector_platform_oauth_redirect` (e `https://chatgpt.com/connector/oauth/{callback_id}` quando sono previsti reindirizzamenti specifici per il callback) tramite i propri metadati CIMD. Assicurarsi che nessun proxy o firewall riscriva `redirect_uri` o rimuova il parametro `resource`.
`invalid_scope` — `Requested scope is not supported` oppure la connessione si apre senza strumenti	Verificare che "Server URL" sia `https://mcp.gwc-corp.com/mcp`, che l’accesso OAuth sia stato completato, che gli ambiti richiesti corrispondano ai metadati abilitati di GWC e che `https://mcp.gwc-corp.com/.well-known/oauth-protected-resource` sia raggiungibile dagli indirizzi IP di uscita dei connettori OpenAI (`https://openai.com/chatgpt-connectors.json`).
`invalid_grant` / `GRANT_REVOKED` o richieste di accesso ripetute dopo la scadenza	Il server di autorizzazione di GWC (`https://api.gwc-corp.com`) supporta il tipo di autorizzazione `refresh_token` con rotazione e PKCE (`S256`). Se un’autorizzazione è stata revocata o se ChatGPT ha memorizzato in cache una configurazione precedente dell’app prima che fossero presenti i metadati per il rinnovo, ricreare o ricollegare il plugin tramite l’interfaccia ufficiale; non riutilizzare né condividere mai un token di aggiornamento.
`CONNECT_PASS_REQUIRED` / `connect_pass_required` — `Your GWC account does not currently have an active Connect Pass entitlement.`	Verificare che l’account GWC con cui si è effettuato l’accesso abbia un GWC Personal Connect Pass (Connect Pass) attivo. La pubblicazione nello spazio di lavoro o un abbonamento ChatGPT non fornisce un Connect Pass.
`PC_OFFLINE` / `DEVICE_NOT_ONLINE`	Verificare che il computer di destinazione sia online, che GWC Studio o GWC for VS Code sia in esecuzione e collegato allo stesso account GWC, e non passare silenziosamente a un altro computer.
`ROOT_NOT_SHARED` / `PATH_PROTECTED`	Verificare che la cartella sia condivisa in GWC Bridge sul PC di destinazione. Il proprietario del PC può esaminare quella specifica cartella e autorizzazione; i percorsi protetti restano inaccessibili.
`SCOPE_NOT_GRANTED` / `APPROVAL_DENIED` / `CLIENT_ACCESS_DISABLED` (la lettura funziona, la scrittura o i comandi vengono rifiutati)	Controllare separatamente entrambi i lati: (1) se i controlli sulle azioni dello spazio di lavoro Enterprise/Edu o le richieste di conferma di ChatGPT hanno bloccato la chiamata e (2) se Change files o Commands è attivo per quella cartella in GWC Studio / GWC for VS Code sul PC.
`UPDATE_REQUIRED` o gli strumenti non funzionano dopo un aggiornamento di GWC Bridge	Aggiornare il componente GWC installato tramite il suo canale ufficiale supportato, poi aprire la pagina dei dettagli di GWC Bridge nelle impostazioni "Plugins" / "Apps" di ChatGPT e selezionare "Refresh" per recuperare gli schemi aggiornati degli strumenti.
`RATE_LIMITED` o timeout durante la modifica di un file / l’esecuzione di un comando	Attendere prima di riprovare una lettura dello stato e controllare prima lo stato del file o del processo sul computer; un timeout di rete non dimostra che l’azione non sia stata eseguita sul PC.
`GWC_BRIDGE_PROTOCOL_ERROR` (HTTP 500, `-32603`) — `GWC Bridge could not complete this request. Check the connection and try again.`	Verificare la connessione e il risultato dell’azione precedente sul PC prima di riprovare. Quando si contatta l’assistenza, annotare data e ora, nome dello spazio di lavoro, nome dello strumento, codice di errore e un ID della richiesta non sensibile senza password, token o contenuti di file privati.
`Internal server error` / `INTERNAL` / `temporarily_unavailable` / HTTP 503	Chiedere a GWC di controllare la configurazione e la disponibilità del servizio. Il percorso disattivato per impostazione predefinita mantiene un errore di protocollo generico; gli errori ordinari degli strumenti e le interruzioni hanno una gestione separata.

8. Privacy e autorizzazioni

ChatGPT riceve gli output restituiti dalle chiamate autorizzate agli strumenti di GWC Bridge, come elenchi di cartelle, contenuti dei file richiesti e output dei comandi; sia content sia structuredContent restituiti da uno strumento entrano nel contesto della conversazione del modello, quindi non dire agli utenti che il contenuto dei file non lascia mai il PC quando chiedono a ChatGPT di leggere file o eseguire comandi. Quando ChatGPT richiama uno strumento, invia a GWC Bridge e al computer connesso gli argomenti dello strumento ricavati dalla conversazione; limitare le cartelle condivise e le autorizzazioni per i comandi in GWC Studio o GWC for VS Code a ciò che serve per l’attività.

Per ChatGPT Business, Enterprise ed Edu, OpenAI dichiara che i dati dello spazio di lavoro — comprese le informazioni consultate tramite plugin e app connessi — non vengono usati per addestrare i modelli OpenAI per impostazione predefinita, mentre restano applicabili le regole di conservazione della propria organizzazione e il trattamento dei dati di GWC per le richieste autenticate inoltrate tramite relay. Collegare GWC Bridge in ChatGPT autorizza soltanto quella connessione ChatGPT e non condivide le conversazioni ChatGPT con altri client di IA; se un altro assistente è collegato separatamente allo stesso computer e alla stessa cartella condivisa, può osservare solo le modifiche scritte su disco in quella cartella condivisa.

9. Riferimenti ufficiali

I passaggi del fornitore sono stati verificati il 2026-10-18, ricontrollati il 2026-10-19 e sottoposti a verifica indipendente dei fatti il 2026-10-21 (Asia/Singapore). I riferimenti seguenti sono le fonti ufficiali in inglese. La configurazione GWC in produzione e l’accettazione di callback/aggiornamento dei token richiedono ancora verifica.