Przejdź do treści
nectar Dokumentacja

Dokumentacja / Połączenie klienta AI

Połączenie klienta AI

Pozwól klientowi AI, na przykład asystentowi czatu lub narzędziu programistycznemu, czytać Twoją bibliotekę Nectar i te poradniki za pomocą osobistego tokenu.

Zanim zaczniesz

Dostęp dla AI włącza serwis. Jeśli w Ustawieniach nie widać sekcji Dostęp dla AI, nie jest jeszcze dostępny. Klient musi umieć połączyć się z serwerem MCP przez HTTPS, bezpośrednio lub przez mały lokalny most.

Utwórz token

  1. Otwórz Ustawienia i znajdź Dostęp dla AI.
  2. Wybierz Utwórz token. Logowanie musi mieć miejsce w ciągu ostatnich 10 minut; w przeciwnym razie Nectar poprosi o ponowne zalogowanie.
  3. Nadaj tokenowi nazwę wskazującą klienta i urządzenie oraz wybierz, kiedy wygasa: od 1 do 90 dni, domyślnie 30.
  4. Wybierz, co może robić. Narzędzia korzystają dziś z odczytu; pozostałe uprawnienia są dla narzędzi, które będą zmieniać Twoje dane, i na razie nic nie robią.
  5. Skopiuj token. Jest pokazywany tylko raz, a Nectar przechowuje jedynie jego odcisk.

Połącz klienta

Ustawienia pokazują adres, z którym łączy się Twój klient, kończący się na /mcp/me, oraz gotową konfigurację.

  • Klienci, którzy pozwalają dodać własny nagłówek, łączą się z tym adresem z nagłówkiem Authorization: Bearer TWÓJ_TOKEN.
  • Klienci, którzy uruchamiają lokalne polecenie, korzystają z mostu z konfiguracji, z adresem i tokenem w jego ustawieniach.

Trzymaj token w ustawieniach klienta, nigdy w wiadomości czatu ani w udostępnianym pliku.

Co może klient

Klient widzi to, co Ty w aplikacji, i nic więcej:

  • me: Twoje konto, poziom, serię, cel dnia i zadania oraz liczbę Twoich zwojów i kolekcji;
  • scrolls_list i scroll_inspect: Twoją bibliotekę, Twoje zwoje i publiczny katalog oraz jeden zwój z rozdziałami, ideami i przykładami;
  • collections_list i collection_inspect: Twoje kolekcje i te oznaczone jako Lubię to;
  • saved_list, review_list i revisit_due: idee oznaczone jako Lubię to, zapisane zwoje, Powtórz później i idee czekające w Wróć do idei;
  • friends_list: Twoich znajomych i zaproszenia;
  • docs_search i docs_read: te poradniki, aby klient mógł wyjaśnić, jak działa Nectar.

Klient nie może zdobywać za Ciebie XP ani postępów czytania, zmieniać adresu e-mail ani hasła, ani usuwać konta. Poproś klienta o listę narzędzi, aby zobaczyć dokładnie, na co pozwala Twój token.

Chroń tokeny

Możesz mieć do 10 aktywnych tokenów. Unieważnij token w Ustawieniach, gdy przestaje być potrzebny lub mógł wyciec; od razu przestaje działać. Token przestaje działać także po wygaśnięciu.