如何把LetsFG接入Claude、Cursor和Windsurf:MCP配置清单与5分钟快速上手教程
【免费下载链接】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 原生的机票与酒店搜索预订工具,覆盖全球航空公司和主流预订网站。通过 MCP(Model Context Protocol)一次接入,它就能让你手里的 Claude、Cursor 或 Windsurf 直接获得"查机票、订酒店"的超能力——无需安装任何本地服务,搜索免费。本文给你一份完整的 MCP 配置清单,5 分钟跑通全流程。
为什么选 MCP 方式接入:零安装、搜索免费
LetsFG 提供了三种使用路径,其中MCP / CLI / SDK最适合普通用户和 AI 智能体:
- 无需本地安装:连接的是托管在云端的远程 MCP 服务器,你的 AI 工具里什么都不用装;
- 一次授权永久生效:授权页面点一下 Approve,无需注册表单、无需绑卡;
- 搜索完全免费:限额为每 10 分钟 10 次、每小时 30 次、每天 100 次,远超个人使用;
- 预订真实可用:机票价格先在你的卡上"预授权",LetsFG 的预订代理买好票、拿到航司真实 PNR 后才扣款,失败自动释放。
接入后,你的 AI 助手能返回这样的实时结果——多航司比价、行李政策、地图位置一目了然:
💡 想先体验网页版效果?项目提供了完整的本地预览工程,见 preview/。
核心 MCP 配置清单:一个 URL 搞定三端
三个客户端指向同一个远程 MCP 端点,差异只在配置文件位置和字段名,对照下表照抄即可:
| 客户端 | 配置位置 | 关键配置 |
|---|---|---|
| Claude Desktop / claude.ai | 设置 → Connectors → Add custom connector | 填入 URL:https://letsfg.co/developers/api/mcp |
| Claude Code | 命令行一条指令 | claude mcp add --transport http letsfg https://letsfg.co/developers/api/mcp |
| Cursor | 项目根目录.cursor/mcp.json | url字段填上述端点 |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | serverUrl字段填上述端点 |
技术细节(来自 docs/mcp.md):传输协议为 Streamable HTTP,认证采用 OAuth 2.1 + PKCE,令牌有效期 1 小时并自动刷新,你完全不用关心这些底层细节。
Claude 接入教程:三步搜索机票
详细步骤见 docs/quickstart-claude.md。
第 1 步:添加连接器在 claude.ai 或 Claude Desktop 中进入Settings → Connectors → Add custom connector,名称填LetsFG,URL 填 MCP 端点;若用 Claude Code,直接运行上面那条claude mcp add命令。
第 2 步:批准连接点击 Connect 后,浏览器会打开授权页,点Approve即可。没有注册表单,也没有卡片信息。
第 3 步:直接开聊
"Find me the cheapest flight from London to Barcelona next Friday"
Claude 会自动调用search_flights工具返回真实报价。想预订时说一句"Book the 06:25 Ryanair one",它会收集乘机人信息、调用book_flight下单,并轮询get_flight_booking直到拿到 PNR 确认号。
备用方案(本地 MCP):如果你的客户端无法连接远程服务器,可以用npx letsfg-mcp本地方式,配置示例在 mcp-config.json 中。
Cursor 接入教程:Agent 模式自动订机票
详细步骤见 docs/quickstart-cursor.md。
- 在项目根目录创建
.cursor/mcp.json,写入mcpServers配置,url指向 MCP 端点; - Cursor 弹出认证提示后,打开授权页点Approve;
Ctrl+Shift+P→Developer: Reload Window重载,LetsFG 工具即出现在 MCP 面板中。
之后在Agent 模式下,Cursor 能自动串联多个工具:解析城市为 IATA 代码 → 搜索航班 → 展示比价 → 收集乘机人信息 → 下单并轮询直到完成。一句"帮我订下个月旧金山飞东京最便宜的机票"就够了。
Windsurf 接入教程:Cascade 一站式规划行程
详细步骤见 docs/quickstart-windsurf.md。
- 编辑
~/.codeium/windsurf/mcp_config.json,在mcpServers中添加 letsfg 服务,serverUrl指向 MCP 端点; - 按提示完成授权,点Approve;
- 重启 Windsurf,Cascade 即可调用全部工具。
Windsurf 的强项是多步骤行程规划,Cascade 可以一次完成:搜机票 + 搜酒店 + 比价 + 预订最便宜的航班,全程无需手动切换工具。
关于授权与支付:你需要知道的三件事
- 连接阶段不绑卡:授权只是一次性的浏览器确认,0 元、无注册;
- 首次预订时才要卡:
book_flight会返回一个add_card_url,任意银行卡或 Revolut Pay / Google Pay 均可,走 0.00 预授权流程,卡信息直达 Revolut,不经过 LetsFG; - 酒店搜索需先有卡:因为酒店搜索会向供应商发起真实会话,连接阶段保存的卡即可复用。
常见问题排查(Troubleshooting 速查)
| 现象 | 原因与解决 |
|---|---|
提示payment_method_required | 账户还没有绑卡,打开返回的add_card_url添加即可,不扣款 |
提示TOKEN_REVOKED | 旧版令牌已失效,断开后重新连接连接器 |
搜索返回402 | 你可能误用了付费 Developer API 密钥,普通接入应走免费的 connect 流程 |
| 工具列表为空 | 检查配置文件 JSON 是否合法,然后重启客户端 |
Windows 报spawn npx ENOENT | 本地模式下把"npx"换成完整路径"C:\\Program Files\\nodejs\\npx.cmd" |
⚠️ 特别提醒:普通用户不要注册付费的 Developer API 账户(不要运行
letsfg register),那是面向高并发商业集成的预付费产品,搜索功能对它就是"未充值不可用"。
延伸阅读
- MCP 服务器完整工具列表与限额说明:docs/mcp.md
- 三端 5 分钟上手:Claude · Cursor · Windsurf
- 本地 MCP 服务源码与打包:sdk/mcp/
- 编程接口指南(脚本/CLI 用户):docs/api-guide.md
接入只需一次,之后你的 AI 助手就随时能帮你比价、订票、订酒店。配置清单已备好,现在就去试试第一句话:"帮我找下周从北京到东京最便宜的航班 ✈️"
【免费下载链接】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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考