Fr24.Ai Mcp

fr24.ai-mcp

[中文](#中文) | [English](#english)

Source: [FR24 International Flights MCP Integration Guide](https://fr24.ai/mcp.html)

---

中文

FR24 AI MCP Server 提供国际机票搜索、验价、下单和订单查询的完整能力，支持 Cursor、Claude Code、Codex、WorkBuddy、OpenClaw 等兼容 MCP 的 AI Agent 客户端接入。

1. 概述

标准预订流程必须按顺序调用，不可跳步：

shopping 搜索航班 -> pricing 锁定价格 -> booking 提交下单 -> orderDetail 查询订单

2. 获取 CID 与密钥

接入本服务需要 FR24 分配的采购商 ID（`X-Cid`）与 16 位采购密钥（`X-Passkey`）。

申请流程：

1. 商务对接：联系 FR24 商务团队，说明公司名称、业务场景和预估请求量。
2. 资质审核：提交企业资质材料，FR24 将在 1 个工作日内完成审核。
3. 发放凭证：审核通过后，专属商务经理将发送 X-Cid 与 16 位 X-Passkey。
4. 接入联调：按下方配置示例完成联调，可联系技术支持协助。

联系方式：

类型	信息
商务邮箱	bd@flightroutes24.com
B2B 平台	https://b2b.flightroutes24.com
技术支持	tech@flightroutes24.com

密钥安全：`X-Passkey` 是核心鉴权凭证，请妥善保管，切勿提交到公共代码仓库或泄露给第三方。如密钥疑似泄露，请立即联系技术支持重置。

3. 接入配置

3.1 服务地址

环境	MCP Endpoint
生产环境	https://mcp.fr24.ai/mcp

3.2 鉴权方式

通过 HTTP Header 传入鉴权信息：

Header	说明	示例
X-Cid	采购商 ID，由 FR24 分配	FRG
X-Passkey	采购密钥，必须是 16 位字符串	your16charpasskey

`X-Passkey` 必须恰好 16 个字节，长度不符将返回鉴权失败错误。

3.3 客户端配置示例

所有客户端使用相同鉴权信息：`X-Cid` 为采购商 ID，`X-Passkey` 为 16 位采购密钥。请将示例中的 `YOUR_CID` 和 `YOUR_16CHAR_PASSKEY` 替换为 FR24 分配的真实凭证。

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

{
  "mcpServers": {
    "fr-flight-mcp": {
      "url": "https://mcp.fr24.ai/mcp",
      "headers": {
        "X-Cid": "YOUR_CID",
        "X-Passkey": "YOUR_16CHAR_PASSKEY"
      }
    }
  }
}

Claude Code（项目级 `.mcp.json` 或用户级 `~/.mcp.json`）：

{
  "mcpServers": {
    "fr-flight-mcp": {
      "type": "http",
      "url": "https://mcp.fr24.ai/mcp",
      "headers": {
        "X-Cid": "YOUR_CID",
        "X-Passkey": "YOUR_16CHAR_PASSKEY"
      }
    }
  }
}

也可以通过命令行添加：

claude mcp add --transport http fr-flight-mcp https://mcp.fr24.ai/mcp \
  -H "X-Cid:YOUR_CID" \
  -H "X-Passkey:YOUR_16CHAR_PASSKEY"

Codex（`~/.codex/config.toml`）