# Importazione e sync Porta in OnlyMCP gli skill, gli agent e la memoria già presenti sul tuo computer, tieni aggiornato ogni client e riprendi tutto, con la riga di comando onlymcp. Lo strumento a riga di comando `onlymcp` collega un computer al tuo account, registra OnlyMCP nei client che hanno un file di configurazione e porta i tuoi contenuti dentro e fuori. Gira tramite `npx`, prima non c’è nient’altro da installare. **Requisito:** Node.js 22 o più recente. ## Collegare questo computer ```bash npx onlymcp login ``` Il comando apre il browser su una pagina in cui il codice è già inserito, e stampa anche il codice, l’indirizzo e un codice QR, nel caso in cui non si apra nessun browser. Accedi e conferma: questo computer ora è uno dei tuoi dispositivi e compare nella tua lista dei dispositivi, dove puoi revocarlo in qualsiasi momento. Subito dopo, `login` scrive i file stub descritti più sotto. Il token è custodito nel portachiavi del tuo sistema operativo, non in un file, e sia lo strumento a riga di comando sia il pacchetto locale lo leggono solo da lì. Su un computer senza portachiavi, come alcuni server senza desktop, usa invece la via remota con un token, vedi [client supportati](https://only-mcp.com/it/docs/clients). `npx onlymcp status` mostra se questo computer ha effettuato l’accesso. `npx onlymcp logout` chiude la sessione di questo computer sul server, che così non lo conta più come dispositivo, e rimuove l’accesso e la cache da questo computer. ## Registrare OnlyMCP in un client ```bash npx onlymcp install --client claude-code npx onlymcp install --client codex npx onlymcp install --client gemini-cli ``` Questi comandi registrano il pacchetto locale onlymcp nel client: il client lo avvia su questo computer tramite stdio, e il pacchetto accede con il login di sopra, non con un token. `--all` scrive ogni file di configurazione di questi client che esiste già su questo computer, e `--print` mostra solo cosa verrebbe scritto. Una configurazione esistente viene letta e integrata, mai sostituita. Per tutti gli altri client, [client supportati](https://only-mcp.com/it/docs/clients) indica il comando o la configurazione da incollare. ## Importare ciò che hai già ```bash npx onlymcp import --dry-run npx onlymcp import ``` Per impostazione predefinita l’importazione legge gli skill da `~/.claude/skills` e gli agent da `~/.claude/agents`. `--skills ` e `--agents ` indicano altre cartelle, e anche una cache di plugin funziona come cartella di skill. La memoria viene importata solo se indichi una cartella con `--memory `: non c’è un valore predefinito, perché un valore predefinito puntato sulle note di qualcuno sarebbe la cosa peggiore che questo comando potrebbe fare. `--dry-run` mostra cosa verrebbe caricato e poi si ferma. L’importazione non legge mai file come `.env` o le chiavi private. Trattiene ogni altro file il cui contenuto sembra una credenziale e lo elenca con la riga che ha fatto scattare la regola, poi chiede prima di caricare qualsiasi cosa; un file trattenuto viene caricato solo se lo sblocchi in quel momento. `--yes` carica senza chiedere, per le esecuzioni non sorvegliate, e lascia indietro i file trattenuti; senza `--yes` e senza un terminale, l’importazione si rifiuta. `--prune` rimuove inoltre dal tuo account ciò che la sorgente non ha più. Elenca tutto ciò che cancellerebbe e poi chiede una sola volta. Tocca solo le tue voci che non sono archiviate, mai le voci di un team, e solo i tipi di contenuto che questa esecuzione ha letto: senza `--memory`, la tua memoria resta intatta. Non esiste un `--yes` per questa opzione, e senza un terminale non cancella niente. ## Tenere aggiornati i client ```bash npx onlymcp sync ``` Alcuni client trovano skill e agent scansionando una cartella. `sync` scrive lì un piccolo file stub per ogni skill e ogni agent, con la sua descrizione, così il client può proporlo al momento giusto; `login` fa lo stesso subito dopo il collegamento. Gli stub finiscono in `skills//SKILL.md` e `agents/.md` dentro `~/.claude` e dentro `~/.codex`, ciascuna solo se esiste già, e dentro ogni cartella elencata nella variabile `ONLYMCP_STUB_DIRS`, separate da due punti. Se non ce n’è nessuna, finiscono in `~/.claude/onlymcp/plugin`. Il testo di uno skill o di un agent resta in OnlyMCP e viene caricato quando il client lo richiede, ma i file di supporto di uno skill vengono copiati per intero, così uno skill che rimanda a uno dei suoi file funziona senza modifiche. Una cartella di skill o un file di agent tuo che si trova già lì non viene mai sovrascritto, e `sync` lo elenca invece. `sync` aggiunge e aggiorna, non cancella: lo stub di uno skill o di un agent rimosso da OnlyMCP resta sul disco finché non lo rimuovi tu. `--memory ` scrive inoltre la tua memoria come file nella cartella che indichi, e sostituisce lì un file con lo stesso percorso. L’importazione e la sincronizzazione si eseguono nella riga di comando, la dashboard non le avvia. La pagina dei dispositivi mostra per ogni dispositivo quando ha importato e sincronizzato l’ultima volta e quanti file ha riguardato ogni esecuzione. ## Riprendere tutto ```bash npx onlymcp export --zip onlymcp-export.zip ``` L’esportazione contiene memoria, skill, agent e connessioni, compreso tutto ciò che è stato archiviato dopo un cambio di piano. Le connessioni vi compaiono senza le loro credenziali: nell’archivio non c’è nessun token e nessun accesso OAuth. Nessuna quota la blocca: un account pieno smette di crescere, ma non ti impedisce mai di riprendere i tuoi contenuti. L’unico limite è di 3 esportazioni all’ora. `--out ` estrae invece l’archivio in una cartella, e `--scope` e `--types` ne limitano il contenuto. ## Per continuare - [Client supportati](https://only-mcp.com/it/docs/clients) - [Cos’è OnlyMCP](https://only-mcp.com/it/docs/what-is-onlymcp) - [Sicurezza](https://only-mcp.com/it/docs/security) - [Prezzi](https://only-mcp.com/it/pricing)