Zum Inhalt springen
nectar Dokumentation

Dokumentation / Einen KI-Client verbinden

Einen KI-Client verbinden

Mit einem persönlichen Token kann ein KI-Client, etwa ein Chat-Assistent oder ein Programmierwerkzeug, deine Nectar-Bibliothek und diese Anleitungen lesen.

Bevor du beginnst

Der KI-Zugang wird vom Dienst eingeschaltet. Siehst du KI-Zugang nicht in den Einstellungen, ist er noch nicht verfügbar. Der Client muss sich mit einem MCP-Server über HTTPS verbinden können, direkt oder über eine kleine lokale Brücke.

Ein Token erstellen

  1. Öffne die Einstellungen und such KI-Zugang.
  2. Wähle Token erstellen. Du musst dich in den letzten 10 Minuten angemeldet haben; sonst bittet Nectar dich, dich erneut anzumelden.
  3. Gib dem Token einen Namen, der Client und Gerät nennt, und wähle, wann es abläuft: 1 bis 90 Tage, voreingestellt 30.
  4. Wähle, was es darf. Lesen ist das, was die Werkzeuge heute nutzen; die anderen Berechtigungen sind für Werkzeuge, die deine Daten ändern werden, und bewirken noch nichts.
  5. Kopiere das Token. Es wird nur einmal gezeigt, und Nectar speichert nur einen Fingerabdruck davon.

Den Client verbinden

Die Einstellungen zeigen die Adresse, mit der sich dein Client verbindet und die auf /mcp/me endet, und eine fertige Konfiguration.

  • Clients, die einen eigenen Header erlauben, verbinden sich mit dieser Adresse und dem Header Authorization: Bearer DEIN_TOKEN.
  • Clients, die einen lokalen Befehl starten, nutzen die Brücke aus der Konfiguration, mit der Adresse und deinem Token in ihren Einstellungen.

Bewahre das Token in den Einstellungen des Clients auf, nie in einer Chatnachricht oder einer Datei, die du teilst.

Was der Client kann

Der Client sieht, was du in der App siehst, und nicht mehr:

  • me: dein Konto, Level, Serie, Tagesziel und Quests und wie viele Scrolls und Sammlungen du hast;
  • scrolls_list und scroll_inspect: deine Bibliothek, die Scrolls, die dir gehören, und den öffentlichen Katalog, sowie einen Scroll mit Kapiteln, Ideen und Beispielen;
  • collections_list und collection_inspect: deine Sammlungen und die, die dir gefallen;
  • saved_list, review_list und revisit_due: Ideen mit Gefällt mir, gespeicherte Scrolls, Später wiederholen und die Ideen, die in Erneut ansehen fällig sind;
  • friends_list: deine Freunde und Freundschaftsanfragen;
  • docs_search und docs_read: diese Anleitungen, damit der Client erklären kann, wie Nectar funktioniert.

Ein Client kann keine XP oder Lesefortschritt für dich sammeln, weder E-Mail noch Passwort ändern und dein Konto nicht löschen. Bitte deinen Client, seine Werkzeuge aufzulisten, um genau zu sehen, was dein Token erlaubt.

Tokens schützen

Du kannst bis zu 10 aktive Tokens haben. Widerrufe ein Token in den Einstellungen, sobald du es nicht mehr nutzt oder glaubst, dass es bekannt geworden ist; es hört sofort auf zu funktionieren. Ein Token hört auch auf zu funktionieren, wenn es abläuft.