Vai al contenuto
Tutta la documentazione

Dispositivi e token

Video

Dispositivi, token e sicurezza

2:58 · in inglese, con sottotitoli in inglesePagina del video · Tutti i video tutorial
Capitoli (6)

In OnlyMCP un dispositivo è tutto ciò che detiene un accesso al tuo account. Questa pagina dice cosa comprende, cos’è un token, cosa conta per il limite del tuo piano e come dare a un token meno diritti o una data di fine.

Cos’è un dispositivo

Ognuno di questi ha una riga propria sotto Sessioni e dispositivi nella dashboard e si revoca da solo:

  • una sessione del browser, con cui sei connesso al sito;
  • un accesso della riga di comando, fatto con onlymcp login su una macchina;
  • un token di accesso, la chiave con omk_ che incolli in un client;
  • un’app collegata, un’app di chat o un altro client che hai ammesso con un accesso OAuth.

Cos’è un token

Un token di accesso inizia con omk_ e va nell’header di un client che non può accedere da solo. Viene mostrato una sola volta, subito dopo averlo creato: OnlyMCP ne conserva solo un’impronta, quindi un token perso non si può rimostrare, solo sostituire.

Crea un token per client e chiamalo come il client, per esempio Cursor o Claude Code. L’elenco sotto Gestisci i token ti dice allora a cosa serve ciascuno, e revocarne uno ferma solo quel client. Sulla pagina di un client sotto Connect, il pulsante Nuovo token per quel client lo fa con un clic: chiama il token come il client, gli dà tutti i diritti e 365 giorni.

Cosa conta per il limite

Il tuo piano consente un numero di client collegati, mostrato nella dashboard per esempio come 2 di 3 client collegati. Contano:

  • gli accessi della riga di comando,
  • i token non revocati e non scaduti,
  • le app collegate.

Le sessioni del browser non contano. Free consente tre client collegati; gli altri piani sono nella pagina dei prezzi. Quando il limite è raggiunto, un nuovo token o una nuova app viene rifiutato con un messaggio. Rimuovine uno che non usi più, oppure sostituisci con un clic, sulla stessa pagina, il più vecchio non usato.

Diritti di un token

Un token creato senza scelta ha accesso completo. Il modulo offre quattro preimpostazioni:

PreimpostazioneCosa può fare il token
Accesso completoTutto ciò che il tuo account può fare, compresi gli strumenti dei server che hai collegato.
Sola letturaSolo gli strumenti che leggono: elencare, leggere e cercare in Memory, skill e agent. Nulla viene modificato.
Solo MemoryGli strumenti Memory, in lettura e scrittura. Niente skill, niente agent, niente server collegati.
Senza server collegatiOgni strumento di OnlyMCP, ma nessuno strumento di un server collegato.

Un client che usa un token con meno diritti vede solo gli strumenti che il token può chiamare. Se un agent ne chiama comunque un altro, riceve questa risposta: This token may not call memory_write: its scope is read. Create a token with more rights under Connect. Un accesso tramite OAuth, come lo usano le app di chat, ha sempre accesso completo.

Scadenza ed e-mail di promemoria

Il modulo parte da 90 giorni. Puoi scegliere mai, un’ora, 24 ore, 30, 90 o 365 giorni, oppure una data fino a dieci anni avanti. Un token che scade smette di funzionare quel giorno e non conta più per il limite.

Sette giorni prima della scadenza di un token, OnlyMCP ti manda una e-mail che nomina il token e la data, e l’elenco mostra Scade tra 3 giorni al posto della data. Un token creato per meno di sette giorni non riceve e-mail, e nemmeno uno revocato. Per sostituire un token che sta per scadere, creane uno nuovo sotto Connect, mettilo nel client e revoca il vecchio.

Dove revocare

  • Sotto Sessioni e dispositivi ogni riga ha Revoca. Un token revocato smette subito di funzionare; un’app revocata va ricollegata.
  • Sotto Connect, Gestisci i token elenca i token con i loro diritti e le loro date.

L’accesso della riga di comando come dispositivo

onlymcp login collega una macchina tramite il browser e conta come un dispositivo, con il nome della macchina. onlymcp logout chiude quella sessione sul server, e la macchina non conta più.

npx onlymcp login npx onlymcp logout

Da leggere dopo