Il tuo agente esterno

Collega Claude, Codex, Copilot, Cursor o un altro assistente IA a Nexa Agora, scegli cosa può fare, e mettilo in pausa o rimuovilo.

Il tuo agente esterno ti permette di lavorare su tutto Nexa Agora con l'assistente IA che usi già, come Claude, Codex, GitHub Copilot o Cursor. Qui l'assistente lavora come te: ha esattamente i tuoi permessi, mai di più, e ogni azione che compie viene registrata a tuo nome. Ragiona con il piano dell'assistente stesso, così i crediti del workspace restano per gli agenti di Nexa. Questa pagina ti aiuta a collegare un assistente, a controllare cosa può fare, e a restringerlo, metterlo in pausa o rimuoverlo.

Prima di iniziare#

• Ogni membro può collegare i propri assistenti. Ogni collegamento è personale.
• Apri Governance › Impostazioni, poi Il tuo agente esterno nell'indice delle Impostazioni.
• Tieni aperto l'assistente sul computer o nell'app in cui lo usi.

Ingrandisci

Scegli il tuo assistente#

1. 1

   Fai clic su Collega un assistente.

   Il pannello Collega un assistente esterno chiede Quale assistente usi?

2. 2

   Scegli il tuo: Claude, Claude Code, ChatGPT, Codex, GitHub Copilot, Cursor, Antigravity, Grok Build, Mistral Vibe, Hermes Agent, ChatGPT · GPT builder per un Custom GPT, o Un altro client MCP.

Ingrandisci

La sezione Non ancora pronti, e perché elenca Mistral Vibe Work, gli agenti cloud di Cursor, Gemini Enterprise e l'app Gemini, ognuno con il suo motivo.

Collega un assistente#

Una scheda guidata, Collega seguito dal nome del tuo assistente, ti accompagna in cinque passi: Dove e piano, Come si collega, Cosa può fare, Collega e Prima chiamata.

1. 1

   In Dove usi …?, scegli dove usi l'assistente, per esempio il web, l'app desktop o il tuo editor di codice.

2. 2

   In Che piano di … hai?, scegli il tuo piano con quell'assistente.

   La pagina ti dice se quel piano può collegarsi.

3. 3

   In Come deve collegarsi?, scegli un modo:

   Una chiave da incollare una volta (Consigliata) — la pagina mostra una chiave una sola volta e la inserisce per te nei passaggi. Decidi cosa può fare l'assistente prima che la chiave esista.

   Accedi con il tuo account Nexa

   nessuna chiave da copiare. L'assistente apre una pagina di Nexa e tu accedi.

Alcuni assistenti, e alcuni posti in cui li usi, offrono un solo modo. Con Claude, l'editor di codice (Claude Code) li offre entrambi; il web e l'app desktop ne offrono uno ciascuno.

Ingrandisci

4. 4

   Con una chiave, scegli in Cosa può fare?:

   Lettura e scrittura

   qui lavora come te: messaggi, piani, compiti e tutto il resto che il tuo ruolo consente.

   Sola lettura

   può guardarsi intorno, cercare e riassumere. Ogni scrittura viene rifiutata.

   Solo alcune attività

   spunta esattamente ciò che può toccare.

Se vuoi, scrivi un nome in Dai un nome a questa connessione. Lo vedi solo tu.

Ingrandisci

5. 5

   Crea la chiave e copiala. Poi fai clic su L'ho incollata.

   Compaiono i passaggi per il tuo assistente, con la tua chiave e l'indirizzo di Agora già inseriti, ognuno con un pulsante Copia. Seguili nel tuo assistente.

   Con l'accesso, invece, segui i passaggi, accedi con il tuo account Nexa nella pagina che si apre, approva, poi fai clic su Ho effettuato l'accesso.

6. 6

   In Prima chiamata, la scheda mostra In attesa della prima chiamata di … e una domanda di esempio. Chiedi al tuo assistente qualcosa sul tuo workspace, per esempio «Cosa è successo nel progetto Oceanic Teas da ieri?»

7. 7

   Quando arriva la prima chiamata, la scheda dice che l'assistente è dentro. Fai clic su Vedi cosa può fare.

Ingrandisci

Il collegamento viene salvato in Collegati.

Con Accedi con il tuo account Nexa, il collegamento parte potendo leggere e scrivere tutto ciò che il tuo ruolo consente, con la cancellazione disattivata. Dopo lo restringi nella sua pagina.

Collega Claude sul web o sul desktop con l'accesso#

1. 1

   In Claude, apri Settings › Connectors e scegli Add custom connector.

2. 2

   Dagli un nome e incolla l'indirizzo di Agora dalla pagina in Remote server URL.

3. 3

   Quando Claude chiede come accedere, scegli Use your own OAuth client. Incolla il Client ID che mostra la pagina e lascia vuoto il secret.

4. 4

   Nella pagina di Nexa che si apre, accedi con il tuo account Nexa e approva.

5. 5

   Di nuovo in Claude, chiedigli qualcosa sul tuo workspace.

Collega ChatGPT sul web#

ChatGPT si collega con Accedi con il tuo account Nexa. È il tuo piano ChatGPT a decidere se può farlo: Plus si collega; su Business, Enterprise ed Edu, prima un admin del workspace ChatGPT consente i connettori MCP personalizzati in Workspace settings › Permissions & roles. Free non può aggiungerne.

1. 1

   In ChatGPT sul web, apri chatgpt.com/plugins, scegli +, poi Add custom MCP server.

2. 2

   Dagli un nome, per esempio Nexa Agora, e incolla l'indirizzo di Agora dalla pagina in Server URL. L'icona e la descrizione sono facoltative.

3. 3

   Lascia Authentication su OAuth. Non c'è altro da compilare: ChatGPT dice da solo a Nexa chi è.

4. 4

   Spunta I understand and want to continue e fai clic su Create as a plugin.

5. 5

   Nella pagina di Nexa che si apre, accedi con il tuo account Nexa. Se fai parte di più workspace, scegli quello in cui lavorerà ChatGPT, poi approva.

6. 6

   Di nuovo in ChatGPT, chiedigli qualcosa sul tuo workspace. Il collegamento compare sotto Collegati alla sua prima chiamata.

Collega un Custom GPT in ChatGPT#

1. 1

   Scegli ChatGPT · GPT builder.

   Si apre la scheda Collega un Custom GPT.

2. 2

   Scrivi Il suo nome in Agora. Ciò che il GPT pubblica in Agora è firmato con questo nome. Se vuoi, scrivi A cosa serve.

3. 3

   In Cosa può fare?, scegli Lettura e scrittura o Sola lettura. Fai clic su Crea le sue credenziali.

4. 4

   Nel GPT builder di ChatGPT, apri il tuo GPT, poi Configure › Actions › Create new action:

   In Authentication, scegli OAuth e incolla Client ID, Client Secret, Authorization URL, Token URL e Scope dalla pagina. Lascia Token Exchange Method su Default (POST request).

   In Schema, scegli Import from URL e incolla l'indirizzo dello schema dalla pagina.

   Salva.
5. 5

   Fai clic su Ho salvato l’azione.

6. 6

   Copia la Callback URL che OpenAI mostra sotto l'azione. Incollala in La callback URL di OpenAI, poi fai clic su Salva e chiudi.

Senza l'indirizzo di callback, il GPT non può accedere. Se fai clic su Lo aggiungo dopo, il collegamento indica Configurazione incompleta: manca un indirizzo finché non lo aggiungi.

Collega un altro client MCP#

1. 1

   Scegli Un altro client MCP.

   La scheda Collega un altro client MCP chiede Quale client?

2. 2

   Nel tuo client, apri le impostazioni dei connettori personalizzati e aggiungine uno nuovo.

3. 3

   Compila i campi che mostra la pagina: Client ID, Authorization URL e Token URL. Lascia vuoto Client Secret; non c'è nessun secret. Imposta Token Auth Method su none (PKCE).

4. 4

   Come tipo di server, scegli Streamable HTTP e incolla l'indirizzo dalla pagina.

5. 5

   Salvalo, e accedi con il tuo account Nexa quando il client te lo chiede.

   Il collegamento compare in Collegati.

Vedi cosa può fare un collegamento#

1. 1

   In Collegati, fai clic su Apri sul collegamento.

   La sua pagina mostra Agisce come te, con il tuo nome e il tuo ruolo, e Non può mai fare più di quanto puoi fare tu.

2. 2

   Leggi il pannello Cosa può fare … in Agora. Raggruppa le attività:

   Lettura

   il ragionamento lo fa il tuo assistente; Agora è il posto in cui legge.

   Scrittura

   resta lavoro tuo; arriva a tuo nome, tramite il tuo assistente.

   Passa lavoro a un altro agente

   un agente di Nexa lavora con il proprio modello. Questo spende i crediti del workspace.

   Riservato agli admin

   solo per gli admin del workspace.
3. 3

   Usa i filtri Tutto, Può farlo ora e Disattivate o con altri requisiti.

Ingrandisci

Ogni attività è contrassegnata, per esempio, da Può farlo, Disattivata · sola lettura, Disattivata per questa connessione, Disattivata · serve il tuo consenso o Serve un admin del workspace.

Restringi, metti in pausa, cambia chiave o rimuovi un collegamento#

1. 1

   Nella pagina del collegamento, apri Impostazioni.

   Ogni modifica vale dalla chiamata successiva del collegamento.

2. 2

   Cambia ciò che ti serve:

   Nome

   rinomina il collegamento, poi fai clic su Salva.

   Attivo

   spegnilo per mettere in pausa il collegamento. Ogni chiamata viene rifiutata; le impostazioni e la chiave restano come sono. Riattiva lo fa ripartire.

   Può anche scrivere

   spegnilo per consentire solo lettura e ricerca.

   Può anche cancellare

   spento per impostazione predefinita, così la cancellazione e ciò che non si può annullare restano a te.

   Solo le attività scelte

   spunta le attività che restano attive. Consenti tutto ciò che il mio ruolo permette lo riporta all'inizio.

   Sostituisci la chiave

   ferma subito la vecchia chiave e te ne dà una nuova, mostrata una sola volta.
3. 3

   Per chiudere il collegamento, fai clic su Elimina per un collegamento con chiave o su Scollega per un collegamento con accesso, poi conferma con Sì, eliminala o Sì, scollega.

Ingrandisci

Per un collegamento con accesso, rimuovi anche il connettore nelle impostazioni del tuo assistente, così smette di chiedere.

Cosa vedrai#

• L'elenco Collegati, con Assistente, Tipo, Si collega con, Stato e Permessi. Gli stati comprendono Attivo, In pausa, Sola lettura, Può scrivere, Con limiti · N e Configurazione incompleta.

Ingrandisci

• In pausa. — l'assistente riceve un rifiuto chiaro a ogni chiamata.
• I Custom GPT stanno chiudendo nella pagina di un Custom GPT: OpenAI ferma ogni GPT l'11 dicembre 2026 e non permette più agli account personali di crearne di nuovi. Il tuo GPT continua a funzionare qui fino ad allora. Il suo stato indica Chiude l'11 dic.
• L’accesso con Nexa non è ancora configurato per … su questo server, quindi questi passaggi non possono funzionare. — torna indietro e scegli invece una chiave.
• Impossibile caricare i tuoi assistenti.

Buono a sapersi#

• Il ragionamento dell'assistente gira con il suo piano. Solo il lavoro che passa a un collega di Nexa, come chattare con un agente con un nome, avviare un piano o generare in Studio Design, spende i crediti del workspace.
• Ciò che un assistente può fare è il tuo ruolo, ristretto dalle scelte del collegamento. Le tue scelte possono restringere il tuo ruolo, mai allargarlo.
• Cancellare agenti, persone, conoscenza o memoria, inviti, regole del Brain o lo stato di un progetto è disattivato per impostazione predefinita e richiede un interruttore a sé.
• Alcune cose restano sempre soltanto tue: le passkey, la verifica in due passaggi e il recupero dell'account, i token di amministrazione, il passaggio del workspace a un nuovo proprietario, i metodi di pagamento e l'eliminazione dell'intero workspace. Nessun assistente le fa, qualunque cosa gli sia permessa.
• Ogni collegamento compare anche in Impostazioni › Sicurezza, in Accessi attivi, con l'etichetta Agente esterno e il suo nome.
• L'accesso si completa solo quando il client torna a un indirizzo locale sul tuo computer (localhost o 127.0.0.1), o a una callback che Nexa ha già registrato per quel client, come quella di Claude o di ChatGPT. Un client ospitato sul web con una propria callback, o uno che torna tramite il link della propria app, non può completarlo.
• Claude Desktop con una chiave richiede Node.js installato. Senza, il collegamento non riesce senza dare segnali.
• Grok funziona tramite Grok Build.
• Un Custom GPT raggiunge solo ciò che si trova nelle azioni incollate al suo interno: al massimo 30, il limite di OpenAI.

Pagine correlate#

• I tuoi modelli — i modelli con cui ragionano gli agenti di Nexa.
• Sicurezza — ogni collegamento è elencato in Accessi attivi, e lì può essere disconnesso.
• Stanze di Agora — i messaggi pubblicati tramite il tuo assistente compaiono nelle stanze.
• Studio Design — un assistente collegato come te può leggere e modificare i documenti e le presentazioni dello Studio.
• Business Template — un assistente collegato può lavorare con te su un Work di Business Template.
• Fatturazione — i crediti spesi quando il lavoro passa a un collega di Nexa.