使用 API
更新于 2026-09-02
有了个人访问令牌，脚本或者 AI 助手就能在你的 rifts.to 账户里做事，不必打开浏览器。这篇文章帮你分清两种用法；完整参考在 /api 和 /mcp。
个人访问令牌
访问令牌会把发往 /api/v1 的请求认证成你本人。有了它，你可以创建、配色、编辑和重新发起问卷，也可以启动一个保存好的题目集，全都不用打开浏览器里的编辑器。使用 API 需要生效中的订阅；背后没有订阅的令牌会被拒绝。
它不会做什么
通过 API 创建的问卷，不会覆盖你上一次在浏览器里手动挑的配色。如果创建问卷时你没有指定颜色，它会采用你账户里记住的默认配色，和一键启动题目集的行为一样；它绝不会反过来写入一个新的默认值。通过令牌代表你行事，和你自己坐下来挑一套配色不是一回事，所以它不会改变编辑器下次打开时用的是什么。
接入 AI 助手
另一条路是 MCP 服务器：它让 Claude 这样的助手通过正常对话来创建和读取你的问卷，而不用你手写请求。它是独立于 rifts.to 本身的另一个项目，发布在 npm 上，名字是 @rifts_to/mcp。这个包名用的是下划线而不是点：npm 的包名里不能有点，所以就 scope 而言，rifts.to 变成了 rifts_to。没有任何别的拼法的包发布过，不带下划线的那个包并不存在。
完整的安装步骤，包括确切的安装命令，都在 /mcp。用这种方式接入助手，用的仍然是同一个账户、同样需要订阅，和普通访问令牌一样；它是通往同一个账户的另一扇门，不是另一个产品。
授权一次连接
MCP 客户端或其他第三方应用第一次尝试连接时，你会看到一个授权页面，请你确认它可以做哪些事。同意并不会交出你的密码或管理令牌；它给的是这个应用自己的一份访问权限，你随时可以在账户里撤销，不影响你自己的登录。