Collegare un client IA

Lascia che un client IA, come un assistente di chat o uno strumento di programmazione, legga la tua libreria di Nectar e queste guide con un token personale.

Prima di iniziare

L’accesso IA viene attivato dal servizio. Se non vedi Accesso IA nelle impostazioni, non è ancora disponibile. Il client deve potersi collegare a un server MCP via HTTPS, direttamente o tramite un piccolo ponte locale.

Creare un token

1. Apri le impostazioni e trova Accesso IA.
2. Scegli Crea un token. Devi aver effettuato l’accesso negli ultimi 10 minuti; altrimenti Nectar ti chiede di accedere di nuovo.
3. Dai al token un nome che indichi client e dispositivo, e scegli quando scade: da 1 a 90 giorni, 30 come predefinito.
4. Scegli cosa può fare. La lettura è ciò che usano oggi gli strumenti; gli altri permessi sono per strumenti che modificheranno i tuoi dati e per ora non fanno nulla.
5. Copia il token. Viene mostrato una sola volta, e Nectar ne conserva solo un’impronta.

Collegare il client

Le impostazioni mostrano l’indirizzo a cui si collega il tuo client, che termina con /mcp/me, e una configurazione pronta.

• I client che accettano un’intestazione personalizzata si collegano a quell’indirizzo con l’intestazione Authorization: Bearer IL_TUO_TOKEN.
• I client che avviano un comando locale usano il ponte indicato nella configurazione, con l’indirizzo e il tuo token nelle sue impostazioni.

Tieni il token nelle impostazioni del client, mai in un messaggio di chat o in un file che condividi.

Cosa può fare il client

Il client vede ciò che vedi tu nell’app, e niente di più:

• me: il tuo account, livello, serie, obiettivo giornaliero e missioni, e quante pergamene e raccolte hai;
• scrolls_list e scroll_inspect: la tua libreria, le pergamene che possiedi e il catalogo pubblico, e una pergamena con capitoli, idee ed esempi;
• collections_list e collection_inspect: le tue raccolte e quelle che ti sono piaciute;
• saved_list, review_list e revisit_due: idee piaciute, pergamene salvate, Ripassa più tardi e le idee in scadenza in Rivedi;
• friends_list: i tuoi amici e le richieste di amicizia;
• docs_search e docs_read: queste guide, così il client può spiegare come funziona Nectar.

Un client non può guadagnare XP o progressi di lettura al posto tuo, cambiare email o password, né eliminare il tuo account. Chiedi al client di elencare i suoi strumenti per vedere esattamente cosa permette il tuo token.

Proteggere i token

Puoi avere fino a 10 token attivi. Revoca un token nelle impostazioni appena smetti di usarlo o pensi che sia stato esposto; smette subito di funzionare. Un token smette di funzionare anche quando scade.