Importazione e sync

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

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. 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

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 indica il comando o la configurazione da incollare.

Importare ciò che hai già

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 <dir> e --agents <dir> 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 <dir>: 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

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/<name>/SKILL.md e agents/<name>.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 <dir> 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

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 <dir> estrae invece l’archivio in una cartella, e --scope e --types ne limitano il contenuto.