Collegare un agente AI
Un agente AI può elencare, caricare e riordinare i tuoi media al posto tuo. Questa guida mostra come dargli accesso, con un token o lasciando che l'app acceda da sola, quanto lasciargli fare e come togliergli di nuovo l'accesso.
Per chiunque abbia un account, con qualsiasi piano.
Le immagini mostrano un telefono. Su un computer le pagine sono uguali, solo più larghe.
In questa pagina
Cosa fa
- App come Claude Code, Codex, Cursor e Gemini CLI possono collegarsi al tuo account tramite MCP, un modo standard con cui gli agenti AI usano altri servizi.
- Una volta collegato, puoi chiedere all'agente con parole semplici, per esempio di spostare le foto delle vacanze in una nuova cartella o di aggiungere titoli e descrizioni ai tuoi file.
- L'agente entra con un token: un lungo codice segreto che crei tu. Chiunque lo abbia può fare nel tuo account tutto ciò che il suo livello di accesso consente, quindi tienilo riservato, come una password.
Crea un token
- Tocca il pulsante con il robot in cima alla pagina (Agenti connessi).
- Tocca Nuovo token.
- In Etichetta, scrivi un nome che riconoscerai in seguito, per esempio il nome dell'app.
- Scegli un'opzione in Livello di accesso (più dettagli sotto), poi tocca Crea token.
Passalo al tuo agente
- Ora vedi Token creato. Tocca Copia messaggio di configurazione.
- Incolla il messaggio in una chat con il tuo agente e invialo. Un agente che può eseguire comandi, come Claude Code o Codex, legge la nostra pagina di configurazione e aggiunge la connessione da solo. Alcuni vanno riavviati prima di poterla usare.
- Tocca Fatto quando l'agente è collegato.
Configuri un'app a mano? Tocca Endpoint MCP per copiare l'indirizzo e dai il token all'app con Copia token. Le impostazioni per Claude Code, Codex, Cursor, Gemini CLI e altri sono su account.nostr.build/agent-setup.md (in inglese).
Oppure lascia che l'app acceda da sola
Le app che sanno accedere da sole, come Claude Code, Claude Desktop, Cursor e VS Code, non hanno bisogno di un token. Aggiungi nostr.build nell'app (le impostazioni sono su account.nostr.build/agent-setup.md) e l'app apre questo sito nel tuo browser.
- Accedi se ti viene chiesto. Arrivi sulla stessa pagina di un codice, con il codice già inserito. Tocca Continua.
- Controlla il nome dell'app e dove, secondo la pagina, viene rimandato il codice. Per molte app la pagina mostra anche dove è pubblicata l'app, come claude.ai per Claude Code. Verifichiamo che i dati dell'app arrivino davvero da quell'indirizzo; il nome da solo è solo ciò che l'app dice di sé. Poi scegli un Livello di accesso. Qui puoi dare più di quanto chiede l'app: la maggior parte chiede Sola lettura.
- Tocca Approva. Il browser torna all'app, che ora è collegata. Compare in Agenti connessi.
Oppure approva un codice di connessione
Gli agenti che non sanno accedere da soli chiedono con un codice. L'agente ti mostra un codice breve (come ABCD-2345) e un link.
- Prima accedi, poi apri il link: il codice è già inserito. Oppure in Agenti connessi tocca Lo approvi e scrivi il codice in Codice di connessione. Poi tocca Continua.
- Controlla il nome dell'agente e l'accesso che chiede. Puoi dargliene meno, mai di più.
- Tocca Approva. L'agente riceve il suo token da solo; tu non lo vedi mai. Poi compare in Agenti connessi.
Scegli il livello di accesso giusto
- Sola lettura: l'agente può vedere cartelle, file, account e notifiche, senza cambiare nulla.
- Lettura e scrittura: può anche caricare, creare cartelle, spostare file, modificare titoli e descrizioni e impostare l'immagine di copertina di un video. Nei piani con AI Studio può anche creare immagini AI, e i modelli a pagamento usano i tuoi Crediti AI.
- Accesso completo, eliminazione inclusa: può anche eliminare file e cartelle. Eliminare una cartella sposta i suoi file in Home, ma l'agente può anche eliminare una cartella insieme a tutto il suo contenuto. I file eliminati non si possono recuperare.
Vedi e revoca i token
- Apri Agenti connessi. Ogni token mostra il nome, il livello di accesso, quando è stato creato e quando è stato usato l'ultima volta, con l'indirizzo IP e l'app di provenienza (Mai utilizzato se non ancora). Questo dato si aggiorna al massimo una volta all'ora.
- Tocca Revoca accanto a un token, poi di nuovo Revoca per confermare. Ogni agente che lo usa perde subito l'accesso. Un'eliminazione di cartella già avviata viene comunque completata.
I token non scadono da soli, quindi revoca quelli che non usi più. Il nome e il livello di accesso di un token non si possono cambiare: crea un nuovo token e revoca quello vecchio.
Guide correlate
La tua libreria
Carica dal telefono o dal computer, ordina i file in cartelle, copia un link da condividere, sposta ed elimina i file.
Accesso e i tuoi account
Accedi con una password, la tua chiave Nostr o un codice, reimposta una password e passa da un account all'altro.
Quando qualcosa va storto
Cosa significano i messaggi di errore e cosa fare: caricamenti, spazio, l'editor, l'accesso, i pagamenti e le pagine che non si caricano.
Ancora problemi? La guida Quando qualcosa va storto spiega i messaggi di errore più comuni, e la guida Ricevi aiuto mostra come contattare il team.