Skip to content
首页 价格 教程 常见问题 专栏

60 秒:在 Claude Desktop 里买好一张 eSIM

2026年,AI 智能体买旅行 eSIM 的速度,比你打开设置应用还快。这里给出完整的配置块、背后的安全模型,以及当你让 Claude 查西班牙最优费率时,它实际看到的东西。

可以——Claude Desktop 真能替你买旅行 eSIM:往 Claude 配置文件里加一段 JSON,重启,大约 60 秒后,智能体就拥有了八个 Roamzy 工具,可以查覆盖、估费用,并且(仅在你主动开启后)下单购买。令牌默认只读,购买权限藏在一个独立的环境变量后面,再加上 $50/天的消费上限,把“智能体失控”的最坏情况框死在可控范围内。整个过程不需要打开任何网页表单,也不需要把银行卡号交给谁。下面把安装、验证、开权限的完整流程走一遍。

智能体商务最难的地方在于:大多数产品从来不是为智能体设计的。绑卡支付流程默认有个人盯着账单页面;eSIM 应用默认你手里有台手机、随时能举起摄像头扫 QR 码;Stripe 默认有一个绑定会话 Cookie 的结账页——而 MCP 服务器给不出 Cookie。结果就是:智能体明明能读懂全网的资费表,却在付款这最后一步处处碰壁。

Roamzy 从 API 层开始重建,把这些默认假设逐一拆掉:从目录查询到下单支付,每一步都有为程序调用设计的接口。结果是一次五分钟的安装,让 Claude Desktop 能查询、估算,并(在你明确开启后)用 USDT 购买全球 eSIM——外加一个明确的安全模型,把令牌泄露的爆炸半径限定住。

装完之后你会得到什么

完成本教程后,你会得到这些:

  • Claude Desktop 注册好八个 Roamzy 工具(目录、国家详情、费用估算、状态,以及查询你自己的 eSIM 和订单的认证只读工具)
  • Claude 配置里多了一个 API 令牌,让智能体以你的身份行动,默认限定为只读
  • 等你准备好开放购买时,翻转一个环境变量即可,不用重装任何东西

总耗时:安装约 60 秒,再花 4 分钟让 Claude 做点有意思的事,比如替你比较几个目的地的资费。

第一步:在 Roamzy 后台创建 API 令牌

用 Google 或 Telegram 登录 roamzy.io/dashboard——两种方式都不需要额外的注册流程——打开 Settings → API & Agents,点击 Create new token

令牌明文只显示这一次——立刻把它复制进密码管理器。窗口关闭后,服务器不再保存明文,只保留用于校验的 SHA-256 哈希和用于展示的12位前缀提示(rk_live_abc1…)。这套设计意味着即便数据库泄露,攻击者拿到的也只是哈希。

第一次安装时,Allow purchases 复选框保持不勾选。只读令牌花不了 USDT——只能查目录、看状态。这是正确的默认值:先用只读令牌把流程跑熟,再考虑开权限。以后随时可以再创建一个开启购买权限的令牌。

第二步:找到 Claude Desktop 的配置文件

macOS:~/Library/Application Support/Claude/claude_desktop_config.json

Windows:%APPDATA%\Claude\claude_desktop_config.json

文件不存在就新建一个,纯 JSON 格式,没有任何别的讲究。

第三步:加入 Roamzy MCP 服务器

{
  "mcpServers": {
    "roamzy": {
      "command": "npx",
      "args": ["-y", "https://roamzy.io/mcp/roamzy-mcp-latest.tgz"],
      "env": {
        "ROAMZY_API_TOKEN": "rk_live_xxx",
        "ROAMZY_ENABLE_PURCHASE": "false"
      }
    }
  }
}

rk_live_xxx 换成你的真实令牌。npx 命令会直接从我们的域名下载 tarball——不需要 GitHub 或 NPM 凭证。令牌只存在于你本机的配置文件里,不会上传给任何第三方。

如果你已经配置了其他 MCP 服务器,把 roamzy 这个键合并进现有的 mcpServers 对象即可,不要整个文件替换。改完记得校验一下 JSON 合法性,逗号错位是最常见的翻车点。

第四步:重启 Claude Desktop

彻底退出 Claude Desktop(Mac 上按 Cmd-Q,不是只关窗口)再重新打开。启动时 Claude 会读取一次配置文件,并把每个 MCP 服务器作为子进程拉起。

你应该能在工具菜单(输入框右下角的小图标)里看到 Roamzy 的工具。如果十秒内没出现,去查 Claude Desktop 的日志——最常见的两个原因:JSON 配置里有笔误,或者令牌复制漏了字符。

第五步:问 Claude 点有意思的

试试这个提示词:

我下周飞东京,行程10天。如果预计总共用 2 GB 流量,通过 Roamzy 买 eSIM 要花多少钱?

Claude 在幕后做的事,其实是一条很短的工具调用链:

  1. 调用 roamzy_country_detail(country_slug="esim-japan"),确认日本在覆盖范围内,并拿到当前的每 MB 费率。
  2. 调用 roamzy_estimate(country_slug="esim-japan", mb_estimated=2048),估算 USDT 费用。
  3. 返回一段简明的回答,附上预估费用和最低充值额,全程不需要你打开任何网页。

按当前费率每 MB $0.0021 计,在日本用 2 GB 的预估费用约为 $4 USDT。Roamzy 的最低充值额是 $20,所以 Claude 会建议你至少充 $20 保险——多出来的余额不过期,下次旅行接着用。

开启购买(当你准备好时)

要让 Claude 真正下单买 eSIM,而不只是估算,两个条件必须同时成立:

  1. 令牌必须开启购买权限。在后台编辑令牌,或者吊销后勾选 Allow purchases 重新创建一个。
  2. MCP 服务器配置里必须有 ROAMZY_ENABLE_PURCHASE: "true"。这是独立于令牌权限的另一道开关——就算令牌带购买权限,这个环境变量不设置,MCP 服务器也不会暴露购买工具。纵深防御,防的就是配置手滑。

两条都满足后,重启 Claude Desktop,换个更进一步的提示词试试:

帮我为东京之行买一张 Roamzy eSIM,充值 $20。

Claude 会调用 roamzy_create_order,从令牌的每日预算(默认 $50)里扣减。API 返回一个 USDT 支付链接——Claude 把它交给你,你从自己的钱包付款,webhook 确认到账后,Claude 就能取到 QR 码图片链接并在对话里渲染出来。用手机相机扫一下,eSIM 完成安装。整个流程里,私钥和资金始终在你自己的钱包,Claude 经手的只是支付链接。

一段话讲完安全模型

五层防护,防的是失控的智能体。每个令牌有每日和每月消费上限(默认 $50/天、$500/月,最高可调至 $1000/$10000)。每个新令牌都有 7 天、累计 $50 的冷启动限额,不可调高。大额确认:超过 $200 USDT 的交易在 API 层直接拦截,需要你在后台确认。购买权限按令牌逐个开启。另有三个相互独立的紧急开关:按令牌吊销、按用户封禁智能体、全局智能体暂停,状态可在 /api/v1/status 查询。这五层互相独立,任何一层被绕过,其余仍然生效。

想看更深入的细节,见 /llms-full.txt——这是我们专门写给 AI 智能体和 AI 引擎的长文指引。

其他 AI 客户端呢?

Cursor、Continue、Cline、Windsurf 以及任何兼容 MCP 的客户端,用的都是同一段配置——放进各自的配置文件即可,配置逻辑完全一致:一个命令、两个环境变量。非 MCP 的客户端(LangChain、OpenAI function calling、n8n、自写 Python 脚本)直接调用 REST API:/api/v1/docs。同一个令牌,同一套安全模型。

教程到此结束。中途卡住了,就找 Roamzy 的 Telegram 支持机器人:@roamzy_support_bot