Documentazione

Da zero a connesso

Crea un account, installa Infser o l’app Android, collega il tuo assistente e approva quando te lo chiede. Qui trovi ogni passaggio.

Avvio rapido

Quattro passaggi.

  1. 01 · Crea il tuo account

    Registrati e conferma l’email.

  2. 02 · Installa Infser

    Crea un codice di associazione ed esegui l’installer per macOS, Windows o Linux, oppure installa l’app Android. All’inizio l’assistente vede solo la cartella home.

  3. 03 · Collega la tua AI

    Aggiungi https://mcp.infser.com/mcp in ChatGPT, Claude, Gemini o Grok e accedi con il tuo account Infser.

  4. 04 · Approva quando te lo chiede

    Quando l’assistente chiede, approva un’autorizzazione per quel dispositivo. Copre le azioni elencate per un tempo limitato. La revochi da Approvazioni.

Assistenti

Collega la tua AI

Ogni assistente usa lo stesso indirizzo e lo stesso accesso Infser. Accedi quando l’assistente lo chiede. Non incollare una password o una chiave API nella chat.

Indirizzo MCPMCP
https://mcp.infser.com/mcp
ChatGPT

Aggiungi un connettore personalizzato con l’indirizzo MCP, oppure installa l’app Infser dalla directory quando è elencata. Scegli Connetti e completa l’accesso Infser. Poi chiedi di elencare i dispositivi.

Claude

In Claude aggiungi un connettore personalizzato per l’indirizzo MCP e completa l’accesso Infser. Dalla CLI di Claude Code puoi eseguire: claude mcp add --transport http infser https://mcp.infser.com/mcp

Gemini

Aggiungi l’indirizzo MCP come server remoto e completa l’accesso Infser. Inizia con una lettura, per esempio l’elenco della cartella home, prima di approvare una modifica.

Grok

Scegli Nuovo connettore, poi MCP personalizzato, e inserisci l’indirizzo MCP. Completa l’accesso Infser. L’equivalente nella CLI di Grok è: grok mcp add --transport http infser https://mcp.infser.com/mcp

Ambito

Il lavoro gira sul computer che hai associato

L’assistente può elencare i tuoi dispositivi, lavorare sui file nelle cartelle consentite, fare uno screenshot, aprire la vista dal vivo dove è disponibile e fare clic o digitare mentre l’autorizzazione è attiva.

Sui tuoi dispositivi l’assistente lavora solo su quelli che hai associato, nelle cartelle consentite e mentre l’autorizzazione è attiva.

Il tuo computer
ChatGPT · Claude · Gemini · Grok → Infser → il tuo computer

Esempio: «Elenca i file nella cartella home e leggi la nota di esempio.» Clic e digitazione aspettano la tua approvazione.

Installazione

Installa Infser su un computer che controlli

Accedi, apri Dispositivi e crea un codice di associazione. Esegui il comando su quel computer e conferma il dispositivo quando compare. L’installer scarica sempre l’ultima versione pubblicata.

Installa solo su computer che possiedi o che sei autorizzato ad amministrare. L’installer verifica la release firmata prima di modificare il sistema. L’associazione decide quale workspace può usare la macchina.

Linux · shell
curl -fsSL https://infser.com/install-agent.sh | sudo sh -s -- --pair <TOKEN>

Usa sudo per installare il servizio. L’agent non resta in esecuzione come root. Aggiungi --full-disk solo se vuoi uscire dalla cartella home.

Sostituisci <TOKEN> con il codice di associazione dalla pagina Dispositivi. Il codice vale una sola volta.

Non serve Node.js per installare l’agent. La CLI facoltativa aggiunge comandi diagnostici: @infser/cli · npx --yes https://infser.com/downloads/cli/0.3.0/infser-cli-0.3.0.tgz doctor

Android

Usa Infser su un telefono Android

L’app Android è in anteprima. Si installa dalla pagina Dispositivi e si collega con il tuo account, senza codici di associazione.

  1. 01 · Scarica l’app

    Dal telefono apri infser.com e accedi. In Dispositivi tocca Aggiungi dispositivo, scegli Android e scarica l’app. Consenti l’installazione da questa fonte quando Android lo chiede.

  2. 02 · Accedi con Infser

    Apri l’app e tocca Accedi con Infser. Conferma il telefono nel browser.

  3. 03 · Attiva l’accesso remoto

    Una notifica fissa ti ricorda che è attivo. Lo spegni dall’app o dalla notifica.

  4. 04 · Consenti il controllo

    In Impostazioni › Accessibilità attiva Infser. Serve per aprire app, toccare e scrivere, solo mentre l’accesso remoto è attivo.

  5. 05 · Condividi lo schermo

    Per gli screenshot tocca Consenti condivisione schermo e scegli lo schermo intero. Android lo chiede di nuovo ogni volta che l’accesso remoto riparte. Senza condivisione, un assistente può leggere lo schermo e toccare solo dopo la tua approvazione.

  6. 06 · Scegli le cartelle

    In Cartelle condivise aggiungi solo le cartelle che vuoi rendere disponibili all’assistente.

L’app non può leggere i dati privati delle altre app: Android li tiene chiusi. Infser vede solo le cartelle che aggiungi. Nelle impostazioni dell’app puoi attivare Invia log: l’app manda solo codici di errore e contatori, mai contenuti, e li vedi nella pagina Dispositivi.

Cartelle e file

Cartella home, oppure tutto il disco

Una installazione nuova consente solo la cartella home dell’utente collegato. Gli strumenti file non possono uscirne. Il disco intero è una tua scelta e non è quella predefinita.

Elencare, leggere e cercare non modificano nulla. Scrivere, creare cartelle, spostare e cancellare richiedono l’autorizzazione.

  • macOS e Linux: aggiungi --full-disk al comando, oppure imposta INFSER_ALLOWED_ROOTS.
  • Windows: aggiungi -FullDisk. Su macOS il disco intero richiede comunque Accesso completo al disco per le cartelle protette come Scrivania, Documenti e Mail, e non aggira i permessi di un altro utente.
  • Gli aggiornamenti mantengono la tua scelta. Se le impostazioni delle cartelle mancano o sono danneggiate, l’aggiornamento torna alla cartella home e ne tiene una copia accanto.
  • Per cambiare scelta su un computer già installato, modifica allowed_roots nella configurazione dell’agent e riavvia l’agent. Dal sito non si può cambiare.
  • Su Android non esiste il disco intero: l’assistente vede solo le cartelle che aggiungi nell’app.
Permessi macOS

Registrazione schermo e Accessibilità su macOS

Gli strumenti dello schermo girano nell’app Infser Desktop Worker. L’installer apre Registrazione schermo e Accessibilità: attiva «Infser Desktop Worker» in entrambi gli elenchi in Impostazioni di Sistema → Privacy e sicurezza. Infser non sposta da solo quegli interruttori. Li concedi una volta e gli aggiornamenti li conservano. Per riaprire le richieste esegui sudo /usr/local/libexec/infser/infser-agent permissions, oppure ripeti solo quel passaggio con sudo sh install-agent-macos.sh --permissions. Se non hai una sessione grafica sul Mac, accedi prima. Se neghi le richieste, l’accesso ai file continua a funzionare e gli strumenti dello schermo restano non disponibili.

Aggiornamento

Aggiorna l’agent

Su un computer già associato, esegui di nuovo l’installer senza un nuovo codice. Aggiorna sul posto, conserva l’identità del dispositivo e installa sempre l’ultima versione pubblicata. Su Android scarica la nuova app da Dispositivi › Aggiungi dispositivo › Android e installala sopra la precedente: l’accesso resta.

Disinstallazione

Disinstalla

La disinstallazione lascia l’identità del dispositivo, così una installazione successiva può riconnettersi. La rimozione completa cancella anche quell’identità. Revoca il dispositivo da Dispositivi se non vuoi che possa ricollegarsi. Su Android usa Logout dal menu dell’app, poi disinstalla l’app.

  • Linux: sudo sh install-agent.sh --uninstall — aggiungi --purge per cancellare anche l’identità del dispositivo.
  • macOS: sudo sh install-agent-macos.sh --uninstall — aggiungi --purge per cancellare anche l’identità del dispositivo.
  • Windows, da PowerShell elevato: .\install-agent.ps1 -Uninstall — aggiungi -Purge per cancellare anche l’identità del dispositivo.
Risoluzione problemi

Se qualcosa si ferma

  • Rete lenta o «Connection reset»: l’installer ritenta il download e riprende un file parziale. Se si ferma comunque, esegui di nuovo lo stesso comando. Il download parziale viene tenuto e i servizi Infser già presenti non vengono modificati.
  • Linux e macOS: il comando ha bisogno di sudo per l’installazione. L’agent in esecuzione non è root.
  • Windows: «Run this installer from an elevated PowerShell» significa che devi usare Esegui come amministratore. Una finestra normale non può installare il servizio.
  • Il codice di associazione vale una volta e scade. Creane uno nuovo da Dispositivi se la pagina ha smesso di attendere.
  • Il dispositivo resta offline: conferma di averlo approvato nel browser, poi verifica che il computer raggiunga infser.com.
  • Android mostra «Riconnessione…»: controlla la connessione del telefono, l’app riprova da sola. Se Android ha interrotto la condivisione dello schermo, consentila di nuovo dall’app.
Schermo

Screenshot, vista dal vivo, mouse e tastiera

Gli strumenti dello schermo funzionano nella sessione dell’utente collegato. La vista dal vivo arriva come fotogrammi via HTTPS e non viene salvata. È disponibile su Linux con X11; su Windows, macOS e Android è in test.

Screenshotdesktop.screenshot

Cattura lo schermo dell’utente collegato. L’immagine è temporanea.

Vista dal vivodesktop.stream.open · desktop.stream.stop

Avvia e ferma la vista dal vivo. I fotogrammi non vengono salvati. Disponibile su Linux con X11, in test su Windows, macOS e Android.

Lettura dello schermodesktop.state · desktop.inspect

Descrivono lo schermo dell’utente collegato. Dei titoli delle finestre entra solo quello in primo piano, accorciato.

Mouse e tastieradesktop.click · desktop.type · desktop.key · desktop.scroll · desktop.drag

Agiscono sugli elementi di una lettura recente dello schermo. Richiedono l’autorizzazione.

Stato

Cosa serve su ogni sistema

Windows usa UI Automation. macOS usa Accessibilità e Registrazione schermo per Infser Desktop Worker. Linux usa X11 con AT-SPI, XTEST e acquisizione X11 nativa. Android usa il servizio Accessibilità di Infser e la condivisione schermo di Android.

A che punto sono mouse e tastiera

Il controllo di mouse e tastiera è verificato su Linux con X11. Su Windows, macOS e Android è disponibile, ma lo stiamo ancora verificando su dispositivi reali.

Sicurezza e privacy

Sicurezza e privacy

  • L’assistente riceve il risultato dello strumento che hai chiesto. Non riceve una copia permanente del disco.
  • Screenshot e fotogrammi dal vivo non vengono scritti nel registro di audit. I fotogrammi restano in memoria fino al successivo o fino allo stop.
  • Puoi fermare un flusso dalla chat, revocare l’autorizzazione, uscire o scollegare il dispositivo.
  • Domande sui tuoi dati: [email protected]. Domande generali: [email protected]. Non inviare password o chiavi del dispositivo via email.

Privacy

Domande frequenti

Domande frequenti

L’assistente riceve un terminale?

Solo con la tua approvazione. L’assistente può vedere l’elenco di processi e servizi; aprire un terminale, avviare o fermare un programma e gestire un servizio richiedono un’autorizzazione, salvo regole che imposti tu nel workspace. Puoi revocarla quando vuoi.

Può leggere tutto il disco?

No, a meno che tu non abbia scelto --full-disk o -FullDisk. I dispositivi nuovi partono dalla cartella home. Su Android vede solo le cartelle che aggiungi.

Come lo fermo?

Revoca l’autorizzazione, fai uscire l’assistente o disattiva il dispositivo. Ognuna di queste azioni ferma il lavoro successivo.

La vista dal vivo funziona su Mac, PC e Android?

È disponibile su Linux con X11. Su Windows, macOS e Android è in test e potrebbe non comparire ancora. Lo screenshot funziona su tutti, dopo che hai concesso i permessi richiesti.

Quale versione devo installare?

Usa i comandi di questa pagina: scaricano sempre l’ultima versione pubblicata. Per Android scarica l’app da Dispositivi › Aggiungi dispositivo › Android.

Infser offre un browser nel cloud?

Sì, in anteprima. L’assistente può aprire un browser gestito da Infser per visitare siti web. Aprire il browser e agire sulle pagine richiedono la tua autorizzazione, salvo regole che imposti tu nel workspace.

Pronto

Crea un account, poi associa soltanto i dispositivi che vuoi rendere raggiungibili dal tuo assistente.