跳到主要内容
nectar 文档

文档 / 连接 AI 客户端

连接 AI 客户端

让聊天助手或编程工具等 AI 客户端,用个人令牌读取你的 Nectar 书库和这些指南。

开始之前

AI 访问由服务开启。如果在设置里看不到"AI 访问",说明暂时还不可用。客户端需要能直接或通过一个小型本地桥接,以 HTTPS 连接 MCP 服务器。

创建令牌

  1. 打开设置,找到"AI 访问"。
  2. 选择"创建令牌"。你需要在最近 10 分钟内登录过,否则 Nectar 会请你重新登录。
  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 个有效令牌。不再使用或怀疑泄露时,立即在设置中撤销令牌,它会马上失效。令牌过期后也会失效。