一、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/requests | Bearer lca_... | 创建 PENDING 申请(TTL 90s);单用户限流每分钟最多 5 次(超限返回 429);返回 matchCode(仅 AI 可见)。 |
| GET /api/ai-auth/requests/:id/wait | Bearer lca_... | 支持 ?mode=sse 或 ?mode=poll 挂起等待用户审批,用户在 App 刷脸通过后毫秒级唤醒。 |
| POST /api/ai-auth/requests/:id/consume | Bearer lca_... | PostgreSQL 行级锁原子消费 encryptedGrantBundle;单次模式提取后立即置为 CONSUMED 并擦除密文,重放返回 409。 |