要给 AI 智能体配一张全球 eSIM，只需把任意支持 MCP 的客户端指向 Roamzy 的远程端点——三步，约两分钟，不用安装，也不用注册账号；桌面客户端则加一段 npm 配置，约五分钟搞定。智能体由此拿到 12 个工具、一张在 193 个国家和地区都能用的 eSIM，并可以用最低 $20 USDT 的稳定币充值直接下单。
市面上大多数“AI 帮你买东西”的演示都是花架子。智能体只是替你填了个表单，或者把你甩到一个结账页面，再或者默默假定旁边随时有个真人准备扫码、输密码、过实名。整条链路只要有一步必须由人接管，所谓的自动化就断在那里。而联网服务恰好是少数几个能在对话框里跑完整个闭环的品类：没有实物要发货，没有地址要填，交付物就是一段二维码，天生适合在聊天里完成。本文就是把这条闭环真正跑通的教程。
读完之后，你的智能体能回答“在日本用流量大概要花多少钱”，也能在你开口时真的给你开出一张 eSIM，把二维码和支付链接直接递进聊天窗口——全程不需要你注册 Roamzy 账号，不需要下载 App，也不需要在任何页面上留手机号。下面给出两条接入路径，任选其一，终点完全相同：远程端点适合网页版客户端，本地安装适合桌面端和代码编辑器。
接线之前，先花三十秒搞清楚你接的是什么
先了解接入对象很有必要，因为它和你以前用过的 eSIM 产品形态不一样。习惯了在旅游平台上挑“日本 8 天 5GB”这类商品的人，第一次接过来往往会找不到“要买哪一款”这一步——因为压根没有这一步：
- 只有一个产品，不是一份商品目录。一张通用 eSIM，193 个国家和地区通用。没有按国家划分的套餐要挑，也没有容量和天数要选。这一点和你在携程、飞猪上买流量包的体验完全不同：那边是先选目的地、再选天数和容量，这边是开一张卡、往里充钱，剩下的交给行程本身。多国连着走的时候差别最明显——一张卡走完全程，不用为每个国家单独下一单。
- 按兆字节计费，余额不过期。你用稳定币充入余额，设备在哪个国家就按当地每 MB 的费率扣款，没用完的余额永久留着，下一趟接着用。套餐买多了会浪费、买少了要补，这个模型把“猜用量”这件事整个去掉了。完整说明见按 MB 计费详解。
- 默认匿名。智能体不需要账号，也不需要令牌就能开始工作。第一次带鉴权的调用会自动生成一个匿名 Roamzy 账号，你不用提前去注册、验证邮箱、再把令牌粘回配置文件——这几步在别的接入里通常是最劝退的部分。要不要实名，等买完再说。
- 十二个工具。读取类工具（服务状态、国家列表、国家详情、费用估算、你名下的 eSIM 与订单）全部开放，随便调用，不花钱；只有购买工具会动钱，而它受下文那套消费额度约束。权限边界是按“会不会产生支出”划的，不是按功能模块划的。
如果你想看的是“为什么联网服务天然是智能体第一件会买的东西”这层论证，而不是接线细节，先读智能体商务与联网服务，再回来。
路径 A——远程端点，零安装（约 2 分钟）
这是最快的一条路，什么都不用装，也不需要本机有 Node 环境。适用于 Claude.ai，以及任何支持远程（Streamable HTTP）MCP 的客户端——也就是那类你只要填一个网址、工具就会出现在侧栏里的客户端。
- 打开客户端的连接器设置。Claude.ai 里是 Settings → Connectors → Add custom connector。
- 粘贴端点地址：
https://roamzy.io/mcp - 保存。十二个 Roamzy 工具随即出现。接入完成。
安装到此为止。没有令牌要粘贴，也没有安装包要下载。这个端点在设计上就是匿名优先的——它永远不会返回 401，所以客户端不必走一遍 OAuth 流程就能连上，并以一个全新的匿名账号开始操作。这在同类服务里并不常见：多数远程 MCP 端点第一句话就是“请先登录”，而登录本身往往就是接入失败的地方。（想用具名登录的客户端也有 OAuth 身份层可用，但起步阶段完全用不到。）可以直接跳到下面五分钟见效的部分。
路径 B——通过 npm 本地安装（约 5 分钟）
桌面端和编辑器客户端走这条：Claude Desktop、Cursor、Continue、Cline、Windsurf、Zed，以及任何以 stdio 方式运行本地 MCP 服务的工具。这条路的服务进程跑在你自己机器上，客户端通过标准输入输出和它对话，好处是可以配环境变量、可以锁版本，代价是本机需要装好 Node 和 npx。
往客户端的 MCP 配置文件里加一段即可——macOS 上的 Claude Desktop 对应 ~/Library/Application Support/Claude/claude_desktop_config.json：
{
"mcpServers": {
"roamzy": {
"command": "npx",
"args": ["-y", "@roamzy/mcp-server"]
}
}
}
不需要写环境变量那一段——把 ROAMZY_API_TOKEN 留空，正是让服务进入匿名模式的开关。如果你已经在跑别的 MCP 服务，请把 roamzy 这个键合并进现有的 mcpServers 对象，而不是整个覆盖文件。改完彻底重启客户端（Claude Desktop 要按 Cmd-Q 退出，光关窗口不算）。第一次带鉴权的工具调用就会生成你的匿名账号。
另有三个可选环境变量，匿名流程一个都用不上：
ROAMZY_API_TOKEN——填入控制台里的令牌，就能以具名账号而不是匿名账号的身份操作。ROAMZY_ENABLE_PURCHASE——具名令牌下默认为false（在你主动开启前只读），但匿名模式下自动打开。用具名令牌时，不把它设成true，购买工具就一直藏着——这是防止配置手滑就花钱的第二道防线。ROAMZY_API_BASE——覆盖 API 基地址，用于测试环境或自建后端。
五分钟见效：直接让它买
放示例对话之前，先纠正一个最容易绊人的认知。因为 Roamzy 是一张按兆字节计费的全球 eSIM，有两样东西你不该告诉智能体，而一个规矩的智能体也不会向你要：
- 不用报国家。这张 eSIM 全球通用；你买的不是“一张日本 eSIM”。行程临时改道、中途多加一个国家，都不用重新下单。
- 不用报流量。没有套餐容量要估。你买的不是多少 GB，而是往余额里充钱；用得少余额就留着，用得多就再充。
智能体真正需要你给的，是充值金额（最低 $20 USDT），以及你想用哪种稳定币、哪条链付款。链的选择不是技术细节，而是取决于你钱包里的资产实际在哪条链上——转错链的钱找回来很麻烦，所以这一步必须由你拍板。完整流程如下：
你：我下周去泰国，帮我把流量安排上。
智能体：Roamzy 是一张覆盖 193 个国家和地区的通用 eSIM，按当地费率以 MB 计费——没有套餐，也不过期。你想充多少？最低 $20 USDT。用哪种稳定币、哪条链支付——比如 TRON、BSC、TON 上的 USDT，或者 Solana 上的 USDC？
你：$20，Solana 上的 USDC。
智能体：搞定。你的 eSIM 号码是 2040XXXXXX。付款链接：[payment link]。请保存这个找回链接，方便你从别的对话里访问这张 eSIM：[claim link]。付款确认后我把二维码取回来给你。
底层逐个工具都发生了什么：
roamzy_status——快速确认服务是否在线、购买功能是否开启。相当于下单前先看一眼店门开没开，几十毫秒的事。roamzy_estimate(country_slug, mb_estimated)——可选，只有你问了“在某地大概要花多少”才会调用。这是一次参考计算，不是购买参数，不产生任何承诺，也不会占用余额。roamzy_payment_options——拉取实时的稳定币和网络清单，好让智能体给出真实可选项，而不是靠猜。购买前这一步是必须的：替你选链，可能把结账锁死在一条你手里根本没有资产的链上，那笔钱就转不出去了。roamzy_create_order(amount_usdt, pay_currency, country_slug)——开出 eSIM 和账单。这里的country_slug只是账单上的一个标签（默认取一个低费率的参考值），并不限制 eSIM 能在哪里用，写成日本也照样能在泰国上网。返回你的手机号（MSISDN）、支付链接，以及匿名模式下的找回链接。roamzy_order_status(order_id)——轮询到 USDT 付款确认为止，视网络不同一般一到十五分钟。确认之前 eSIM 已经存在，只是还没有余额可用。roamzy_get_esim(esim_id)——付款完成后返回激活入口：可以直接在聊天里渲染的二维码图片、二维码原始串，以及智能体和手机是同一台设备时用的一键安装链接。手机上聊天时用后者最省事，一点就装。
不做任何配置就自带的护栏
自主权只有在有边界时才合理，所以边界默认就开着。让一个程序拿着钱包自己下单，最怕的不是它买贵了，而是它在一个循环里连着买十次；下面这几条就是针对这类失控设计的。每一个智能体令牌——包括系统替你创建的那个匿名令牌——都带着：
- 消费上限。匿名会话受限于每天 $30、每月 $100，全新令牌另有 $30 的冷静期上限，同时只能有一张活跃 eSIM，超过 $50 的交易一律打回，需要人工确认。已认领的具名账号则是每天 $50、每月 $500、冷静期 $50、大额交易门槛 $200，最多五张 eSIM。
- 智能体看得见的预算。每次调用都会返回剩余额度，所以智能体是先算清还剩多少，而不是撞上限才知道有上限。这个区别在实践中很重要：额度对模型可见，它就会在回话里主动说“这笔超了，需要你确认”，而不是抛一个失败让你去猜发生了什么。
- 三个急停开关。三者互相独立——吊销单个令牌、封禁某个账号的智能体访问、或者全局暂停所有智能体购买——当前状态可从
roamzy_status读到。任何一个生效，购买就停，读取不受影响。
这些你一个都不用去打开。它们就是默认值，也就是说，哪怕你把这篇文章读到这里就去接线、什么都不配，边界依然在。更深的设计取舍写在开发者指南里。
从匿名升级为具名账号
匿名 eSIM 的功能是完整的——可以充值，可以一直用下去，不会因为没实名而被降级或者停用。等你想把它和一个真实身份绑定（为了提高额度、在浏览器里管理、换手机时能找回，或者干脆不想再依赖一个存下来的链接），就去认领它。打开找回链接，用 Google 或 Telegram 登录，输入一次性验证码；eSIM 连同余额一起转到你的具名账号名下，中间不需要重新买、也不会丢余额。这一步完全可选，而且发生在购买之后，绝不会挡在购买之前——这和“先注册再看价格”的常规顺序正好相反。无论用 USDT 还是 USDC 付款，余额并不在乎它挂在哪个账号下。
出问题时怎么办
- 一个 Roamzy 工具都没出现。几乎总是配置文件里的 JSON 写错了（多半是漏了逗号或者多了一个），或者重启没重启彻底。先拿任意一个 JSON 校验器过一遍；Claude Desktop 上要用 Cmd-Q 完全退出，而不是关掉窗口了事——关窗口后进程还活着，读的还是旧配置。
- 智能体能读，但不能买。匿名模式会自动暴露购买工具。用具名令牌时，你既需要令牌本身带购买权限，又需要把
ROAMZY_ENABLE_PURCHASE设成true，两个条件缺一不可。 - 智能体反问“去哪个国家？”这就是前面说的反面模式——这张 eSIM 是全球的。正确的智能体只会问充值金额和支付方式。如果你的智能体非要一个国家，说明它还在按套餐模型推理，而套餐模型在这里不适用；直接告诉它“这是全球通用卡，按 MB 计费”，一般就能纠正过来。
- 付款好像卡住了。USDT 和 USDC 的确认视网络不同大约需要一到十五分钟，链上拥堵时偏慢；智能体应当去轮询
roamzy_order_status，而不是直接判定失败重新下单——重复下单只会多开一张 eSIM。
接下来看什么
现在你已经有了一个能自己买流量的智能体。想了解 MCP 服务背后的架构和 API 设计取舍，读开发者指南。想知道我们和老牌消费级市场相比如何，Roamzy 对比 Airalo那篇把 Airalo 仍然强过我们的地方写得很清楚——套餐单价、品牌认知度这些方面，我们并不占优，该说的都说了。整个智能体接口的一页式总览在 面向 AI 智能体的 eSIM，REST API 文档在 /api/v1/docs，写给引擎读的长文档在 /llms-full.txt。卡住了就找支持机器人 @roamzy_support_bot。