콘텐츠로 건너뛰기
nectar 문서

문서 / AI 클라이언트 연결

AI 클라이언트 연결

채팅 어시스턴트나 코딩 도구 같은 AI 클라이언트가 개인 토큰으로 내 Nectar 서재와 이 안내서를 읽게 하세요.

시작하기 전에

AI 액세스는 서비스에서 켭니다. 설정에 AI 액세스가 보이지 않는다면 아직 이용할 수 없습니다. 클라이언트는 직접 또는 작은 로컬 브리지를 거쳐 HTTPS로 MCP 서버에 연결할 수 있어야 합니다.

토큰 만들기

  1. 설정을 열고 AI 액세스를 찾으세요.
  2. 토큰 만들기를 고르세요. 최근 10분 안에 로그인한 상태여야 하며, 아니라면 다시 로그인하라는 안내가 나옵니다.
  3. 어느 클라이언트와 기기용인지 알 수 있는 이름을 붙이고 만료일을 고르세요. 1~90일이며 기본값은 30일입니다.
  4. 할 수 있는 일을 고르세요. 지금 도구가 쓰는 것은 읽기입니다. 나머지 권한은 데이터를 바꿀 앞으로의 도구를 위한 것이며 아직은 아무 일도 하지 않습니다.
  5. 토큰을 복사하세요. 한 번만 보이며, Nectar는 그 지문만 저장합니다.

클라이언트 연결하기

설정에는 클라이언트가 연결할 주소(끝이 /mcp/me)와 바로 쓸 수 있는 설정 예시가 나옵니다.

  • 헤더를 직접 넣을 수 있는 클라이언트는 그 주소에 Authorization: Bearer YOUR_TOKEN 헤더로 연결합니다.
  • 로컬 명령을 실행하는 클라이언트는 설정 예시에 있는 브리지를 쓰고, 그 설정에 주소와 토큰을 넣습니다.

토큰은 클라이언트 설정에 보관하고, 채팅 메시지나 공유하는 파일에는 절대 넣지 마세요.

클라이언트가 할 수 있는 일

클라이언트는 앱에서 내가 보는 것만 볼 수 있습니다.

  • me: 계정, 레벨, 연속 기록, 하루 목표와 퀘스트, 가진 스크롤과 컬렉션 수
  • scrolls_list와 scroll_inspect: 내 서재, 내 스크롤, 공개 카탈로그, 그리고 장, 아이디어, 예시가 담긴 스크롤 하나
  • collections_list와 collection_inspect: 내 컬렉션과 좋아요를 누른 컬렉션
  • saved_list, review_list, revisit_due: 좋아요를 누른 아이디어, 저장한 스크롤, 나중에 복습, 다시 보기에 올라온 아이디어
  • friends_list: 친구와 친구 요청
  • docs_search와 docs_read: 이 안내서. 클라이언트가 Nectar 사용법을 설명할 수 있습니다

클라이언트는 나 대신 XP나 읽기 진행을 얻을 수 없고, 이메일이나 비밀번호를 바꾸거나 계정을 삭제할 수 없습니다. 토큰으로 무엇을 할 수 있는지 정확히 보려면 클라이언트에게 도구 목록을 보여 달라고 하세요.

토큰을 안전하게

활성 토큰은 최대 10개까지 가질 수 있습니다. 더 쓰지 않거나 노출되었다고 생각되면 바로 설정에서 토큰을 취소하세요. 즉시 작동을 멈춥니다. 토큰은 만료되어도 작동을 멈춥니다.