AI Agent 安全授权指南

LazyCoffee AI 凭据按需授权与 MCP 使用文档

无需向 AI 聊天框粘贴明文密码或交出永久 2FA 种子:AI 按需发起申请,LazyCoffee 手机/桌面端实时弹出审批卡片,您核对 2 位安全匹配码与申请范围后通过 Face ID / Touch ID 一键放行,由端侧使用 AI 临时公钥封装并在 60 秒内阅后即焚。

第一步:在 App 绑定 AI 助手令牌

  • 打开 LazyCoffee 客户端,进入「设置 -> AI 凭据授权管理 -> 绑定 AI 助手」。
  • 填写助手名称(如 Claude Desktop / Cursor),勾选允许申请的字段上限(account、password、totp_code、notes)。
  • 复制一次性展示的专属令牌(lca_... 前缀),严禁将个人主登录 Token 直接交给外部脚本。

第二步:接入 MCP 或 REST API

  • 桌面 AI 客户端(Claude Desktop / Cursor)推荐直接配置官方 @lazycoffee/mcp-server,自动完成 P-256 临时密钥协商与本地解封。
  • AI 仅传递 targetDomain、最小 requestedScopes 与 reason;服务端对首次访问站点或密码字段强制启用安全确认码。
  • 当用户授予「当前任务 (15分钟)」模式时,本地 MCP 进程会在 15 分钟内复用租约缓存,减少重复打断。

第三步:生物识别核对与一键熔断

  • 客户端首页顶部「待审批授权横幅」或设置页会实时弹出申请详情,明确隔离展示系统锁定目标与 AI 自述理由。
  • 遇高敏字段或新站点时,需在弹窗中从 3 个数字里盲选出 AI 屏幕显示的 2 位确认码,选错将自动拒绝并拦截。
  • 如发现异常请求,可点击「拒绝并屏蔽」拉黑该站点,或在管理页一键开启「全局冻结 AI 授权通道」。

一、MCP 客户端快速接入配置(Claude Desktop / Cursor)

将以下配置写入 Claude Desktop(claude_desktop_config.json)或 Cursor 的 MCP 配置文件,并替换为您在 App 中生成的 lca_... 令牌:

{
  "mcpServers": {
    "lazycoffee": {
      "command": "bun",
      "args": ["run", "/path/to/lc-totp-app/packages/mcp-server/src/index.ts"],
      "env": {
        "LAZYCOFFEE_AGENT_TOKEN": "lca_your_agent_token_here",
        "LAZYCOFFEE_API_URL": "https://www.lazycoffee.com"
      }
    }
  }
}
MCP 工具名称适用场景返回内容与安全边界
lazycoffee_get_totp_code仅需过 2FA 两步验证(推荐)仅申请 account + totp_code,端侧实时算出当期 6 位动态码(剩余 <8s 附带下一周期码),绝不下发原始 secret 种子。
lazycoffee_request_credential自动登录或读取受控凭据支持按需组合 account / password / totp_code / notes;若授出 task_15m 则 15 分钟内本地缓存复用。

二、HTTP REST API 全流程接入说明(自研 Agent / 脚本)

若您的自动化脚本不走 MCP 协议,可直接调用 lazycoffee.com 的 /api/ai-auth/* 接口。AI 端须在每次请求前于内存生成一次性 ECDH P-256(prime256v1)非对称密钥对,仅将 65 字节未压缩 Base64 公钥传给服务端:

# 1. 发起按需授权请求(由 AI 本地生成临时 ECDH P-256 公钥)
curl -X POST https://www.lazycoffee.com/api/ai-auth/requests \
  -H "Authorization: Bearer lca_your_agent_token" \
  -H "Content-Type: application/json" \
  -d '{
    "targetDomain": "github.com",
    "accountHint": "alice@example.com",
    "requestedScopes": ["account", "totp_code"],
    "reason": "登录 GitHub 检查 CI 发布状态",
    "ephemeralPubKey": "<Base64_Uncompressed_P256_PublicKey>"
  }'

# 2. 长轮询 / SSE 等待用户在 App 上完成生物识别放行
curl "https://www.lazycoffee.com/api/ai-auth/requests/<requestId>/wait?mode=sse&timeoutMs=25000" \
  -H "Authorization: Bearer lca_your_agent_token"

# 3. 原子阅后即焚消费(仅提取密文信封,服务端立即抹除载荷)
curl -X POST https://www.lazycoffee.com/api/ai-auth/requests/<requestId>/consume \
  -H "Authorization: Bearer lca_your_agent_token"
协议端点鉴权方式核心行为与状态机流转
POST /api/ai-auth/requestsBearer lca_...创建 PENDING 申请(TTL 90s);单用户限流每分钟最多 5 次(超限返回 429);返回 matchCode(仅 AI 可见)。
GET /api/ai-auth/requests/:id/waitBearer lca_...支持 ?mode=sse 或 ?mode=poll 挂起等待用户审批,用户在 App 刷脸通过后毫秒级唤醒。
POST /api/ai-auth/requests/:id/consumeBearer lca_...PostgreSQL 行级锁原子消费 encryptedGrantBundle;单次模式提取后立即置为 CONSUMED 并擦除密文,重放返回 409。

三、零知识加密与防钓鱼安全机制说明

  1. 端到端临时信封(ECDH-P256 + AES-256-CBC + HMAC-SHA256):即使用户开启了「凭证数据加密」零知识模式,也是由手机/桌面客户端在本地生物识别放行后解密凭据、再用 AI 的临时公钥重加密上传,lazycoffee.com 服务端全程不可见任何明文。
  2. 3 选 1 盲选数字匹配(Number Matching):面向客户端的 /api/ai-auth/pending 接口绝不下发真实 matchCode,仅返回 3 个混淆候选码,彻底防止恶意脚本诱导盲点或通知疲劳轰炸。
  3. 站点黑名单与全局熔断:在审批弹窗点击「拒绝并屏蔽」会将域名写入该 Agent 的 blocked_domains;在「AI 凭据授权管理」页可随时查看全链路审计日志、解封域名、吊销单个助手或开启全局冻结开关。

立即体验面向 AI 时代的零知识凭据托管

升级至最新客户端并在「设置 -> AI 凭据授权管理」中创建首个受控 Agent 令牌,全程可审计、可随时一键冻结。