核心用法
Let's Clarify 是一个人机协同(Human-in-the-Loop)基础设施服务，解决AI自动化流程中需要人类确认、审批或补充数据的场景。其工作流程分为五步：
1. 注册获取API密钥 — 一次性注册，密钥lc_...用于所有后续调用
2. 创建表单 — 使用JSON Schema定义字段（支持文本、单选、多选、文件上传等7种类型），可预设收件人UUID及预填充值
3. 分发唯一URL — 每个收件人获得专属链接https://letsclarify.ai/f/{token}/{uuid}，可通过邮件/Slack/WhatsApp发送
4. 异步轮询结果 — 通过get_summary查看进度，get_results获取提交数据，支持游标分页和updated_since增量更新
5. 清理或自动过期 — 支持手动删除或设置retention_days（默认30天，最长365天）自动清理
关键特性：
- 双模式集成：REST API + 远程MCP服务器，后者为Claude Code/Cursor等提供原生工具调用
- Webhook实时通知：每次提交自动POST到指定HTTPS端点，10秒超时+3次多项式退避重试
- 嵌入组件：
<script src="https://letsclarify.ai/embed.js">可直接将表单嵌入自有页面 - 扩展收件人：单表单最多10,000个收件人，支持动态追加
显著优点
| 维度 | 优势 |
|---|---|
| **架构设计** | 纯异步无阻塞设计，提交成功不依赖Webhook送达，保证数据完整性 |
| **数据安全** | API密钥前缀化设计、删除需双令牌（`api_key`+`delete_token`）、自动过期硬删除 |
| **开发者体验** | MCP原生支持避免手写HTTP；Schema DSL简洁；轮询策略文档详尽（含Cron配置示例） |
| **规模化** | 10k收件人/表单、文件上传支持（10MB/文件，10文件/字段） |
| **灵活性** | 预填充值、UUID自定义、主题色配置、自托管实例支持 |
潜在缺点与局限性
- 实时性受限：无Websocket/SSE，必须轮询或依赖Webhook；Webhook仅支持HTTPS且10秒超时可能丢消息
- 离线依赖：收件人必须访问公网URL，无法用于完全离线场景
- 验证局限：仅支持基础正则校验，无复杂业务逻辑校验（如交叉字段验证）
- 存储成本：文件存储时长受限于表单保留期，非独立对象存储
- MCP生态依赖：若使用MCP模式，需客户端支持Model Context Protocol
适合人群
- AI Agent开发者：需在工作流中插入人工审批节点（如自动采购前的人工预算确认）
- SaaS产品经理：快速搭建客户反馈收集、内部审批流，无需自建表单后端
- 自动化工程师：n8n/Make/Zapier用户需结构化人工输入补充自动化断点
- 合规敏感团队：MIT开源协议，可自托管，数据保留策略透明可控
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---|---|---|
| **密钥泄露** | API密钥`lc_...`泄露可导致表单数据被拉取 | 使用环境变量`LETSCLARIFY_API_KEY`，启用最小权限轮转 |
| **URL拦截** | 唯一URL若被转发，非目标人员可提交 | 敏感场景追加邮箱验证码或结合身份提供者 |
| **Webhook伪造** | 未验证Webhook来源可能导致虚假提交确认 | 校验`form_token`+`recipient_uuid`与预期匹配，或弃用Webhook改用轮询 |
| **数据残留** | `retention_days`配置错误导致数据过期丢失 | 关键数据及时通过`get_results`导出，设置提醒 |
| **速率限制** | 突发流量触发429（60请求/分钟） | 实现指数退避，生产环境分散请求时段 |
技术评估结论
Let's Clarify 填补了AI自动化与人工决策之间的关键空白，其MCP优先的设计思路契合当前AI Agent生态演进方向。架构上牺牲部分实时性换取极高可靠性（提交不依赖Webhook），数据模型清晰，适合作为中低风险人机协同场景的标准化组件。