企业官网建设流程全解析

LetsFG连接指南：一次点击的OAuth认证与零扣费绑定卡片的完整步骤

【免费下载链接】LetsFGAgent-native flight & hotel search and booking — MCP server, CLI, and Python/JS SDKs. Every airline in the world, major booking sites and OTAs, with per-flight reliability history.项目地址: https://gitcode.com/gh_mirrors/le/LetsFG

LetsFG 是一款Agent-native 的机票与酒店搜索/预订工具，通过 MCP 服务器、CLI 和 Python/JS SDK 让 AI 助手一次性查询全球所有航空公司的真实价格并完成真实出票。本指南带你走完OAuth 一次点击授权和零扣费绑定卡片的完整连接流程——全程无需注册账号、无需填写卡号。

为什么 LetsFG 值得连接

核心机制一句话：价格只"冻结"不"扣款"，直到航司出票（PNR）才真正扣费；预订失败自动释放，一分不扣。

OAuth 认证流程是怎么运作的

LetsFG 采用的是标准的OAuth 2.1 授权码 + PKCE流程，客户端（如letsfg auth命令）会自动完成全部四步，你只需要在浏览器里点一下"Approve"：

令牌有效期为access token 约 1 小时 + refresh token 30 天，SDK 会在过期前静默刷新，你几乎感知不到。安全设计上，系统没有任何能用卡号直接换 token 的接口——卡片信息只经过 Revolut，永不接触 LetsFG。流程实现可参考 sdk/python/letsfg/connectors/auth.py 与 sdk/js/src/auth.ts。

在 AI 客户端中一次点击完成授权（MCP 方式）

这是最省事的路线：在你的 AI 工具中添加远程 MCP 服务器，批准连接即完成 OAuth 授权，不装任何东西、不需要卡片。

① Claude Code（一行命令）：

claude mcp add --transport http letsfg https://letsfg.co/developers/api/mcp

② Cursor / Windsurf（项目根目录.cursor/mcp.json）：

{ "mcpServers": { "letsfg": { "url": "https://letsfg.co/developers/api/mcp" } } }

③ claude.ai / ChatGPT：在设置中"添加自定义连接器"，填入同一个 URL。

添加后点击Connect / Approve，浏览器打开letsfg.co/connect授权页——一次点击，没有注册表单、没有卡片，连接即成功。随后直接在对话里说"帮我找 6 月 15 日从伦敦到巴塞罗那最便宜的机票并预订"，AI 就会自动调用search_flights→book_flight→get_flight_booking完成全流程。

📖 分客户端的详细步骤见 docs/quickstart-claude.md、docs/quickstart-cursor.md 和 docs/mcp.md。

终端用户：letsfg auth一条命令完成认证

如果你用 CLI 或 SDK（脚本、自动化流程），一条命令即可走完全相同的 OAuth 流程：

pip install letsfg # 或 npm install -g letsfg letsfg auth

letsfg auth会自动注册为 OAuth 客户端（PKCE + 本地回环回调），打开浏览器授权页等你批准，然后把令牌写入~/.letsfg/config.json，之后自动续期。无桌面环境时加--no-browser参数，命令会直接打印授权 URL 供手动打开。

之后所有搜索、预订命令直接复用该令牌：

letsfg search LHR BCN 2026-06-15

SDK 也会自动从~/.letsfg/config.json或环境变量LETSFG_BEARER_TOKEN读取令牌。命令全集见 docs/cli-reference.md。

零扣费绑定卡片：0.00 元验证的完整步骤

连接阶段完全不需要卡片。卡片只在第一次预订时才会被要求添加，且是一个0.00 元的 Revolut 验证流程——任何银行卡、Revolut Pay 或 Google Pay 都可以：

1. AI 调用book_flight（或letsfg book），返回一个add_card_url链接；
2. 点开链接，在 Revolut 页面填入卡片完成0.00 验证（不扣一分钱，无需注册 Revolut 账号）；
3. 卡片绑定完成，回到对话继续预订即可。

资金安全三重保障：

• ✅冻结而非扣款：预订时票价只是在你卡上"hold"住，钱并未划走；
• ✅出票才扣费：只有航司生成真实 PNR 后，冻结金额才转为扣款——你看到的价格就是你付的价格；
• ✅失败自动释放：预订失败时冻结自动解除，零扣费。

预订全程约 4–11 分钟，AI 会自动轮询get_flight_booking直到返回 PNR。

授权后的免费额度与避坑指南

常见报错速查（详见 docs/getting-started.md）：

• payment_method_required+add_card_url→ 账号还没绑卡，打开链接加卡（零扣费）；
• TOKEN_REVOKED→ 旧版已退役的令牌，断开后重新连接一次即可；
• 402→ 你误用了付费版 Developer API 密钥，普通用户走上面免费的连接流程即可。

⚠️ 新手注意：不要运行letsfg register或letsfg connect-payment——那是面向企业的高流量付费产品，会创建计费账户，普通用户和 AI 智能体用不到。

总结

跟着上面的步骤，5 分钟内你的 AI 助手就能替你查价、比价、出票——看到的总价就是最终价格。更多架构与 API 细节可查阅 docs/architecture-guide.md 与 docs/agent-guide.md。

【免费下载链接】LetsFGAgent-native flight & hotel search and booking — MCP server, CLI, and Python/JS SDKs. Every airline in the world, major booking sites and OTAs, with per-flight reliability history.项目地址: https://gitcode.com/gh_mirrors/le/LetsFG