指南

把 AI 助手连接到 Atli eSIM MCP 服务器

把 ChatGPT、Claude、Gemini 或你自己的 AI 智能体连接到 Atli 的 MCP 服务器,即可搜索 eSIM 套餐、处理购买并提供安装说明。

一段 AI 对话,Atli 在其中给出日本套餐和一个安全付款链接,旁边是从手机里走出来的带翅膀的蓝色 Atli 吉祥物

Atli 提供一个公开的 MCP 服务器,让 AI 助手可以销售旅行 eSIM。接入后,助手可以搜索套餐、检查设备是否兼容、处理订单,并提供 eSIM 安装说明。

MCP 即 Model Context Protocol(模型上下文协议),是一个开放标准,让 AI 助手可以与外部工具和服务交互。通过 Atli 的 MCP 服务器,助手可以访问 Atli 的实时 eSIM 目录,因此套餐信息和价格直接来自 Atli,而不是来自 AI 助手原有的知识。

你的合作伙伴代码包含在 MCP 服务器 URL 中。以访客身份通过连接了这个 URL 的助手购买的新客户,都会归属到你的合作伙伴账户。这既适用于你自己开发的 AI 助手,也适用于配置了你的 MCP 地址的受支持第三方助手。

你的 MCP 地址

在 partners.heyatli.com 登录,打开 MCP 服务器。那里的地址带着你的合作伙伴代码,旁边有一个复制按钮。

partners.heyatli.com 的 MCP 服务器页面上的“你的地址”框,里面有服务器地址、复制按钮和“添加推荐码”按钮

如需直接构造 URL,请在 /r/ 后面加上你的合作伙伴代码:

https://mcp.heyatli.com/r/YOUR_CODE

通过你的 MCP URL 购买的新访客客户会归属到你的合作伙伴代码。如果你的代码带有折扣,折扣会用在他们的第一笔订单上。

标准 URL https://mcp.heyatli.com 也可以用来购买,但不会把销售归属给任何合作伙伴。请始终使用完整的推荐 URL,才能追踪符合条件的销售。

连接 ChatGPT、Claude 和 Gemini

AI 平台更新界面时,设置菜单可能会有变化。如果下面的步骤和你看到的不一样,请查阅该平台关于自定义 MCP 服务器或连接器的文档。菜单名称沿用各应用英文界面的写法,和截图里的一致。

ChatGPT。打开侧边栏里的 Plugins,选择 Add,再选择 Add custom MCP server。名称填 Atli eSIM,保持选中 Server URL,粘贴地址,并把 Authentication 设为 No authentication。勾选 I understand and want to continue,选择 Create as a plugin,然后安装这个插件,在新聊天里试一试。OpenAI 在 Business、Enterprise 和 Edu 版上完整支持自定义 MCP 服务器,由工作区管理员决定谁可以添加。Pro 版只允许读取和获取类操作,所以在 Pro 上查询套餐应该能用,购买则用不了。如果菜单里没有这个选项,说明你的套餐或工作区不提供这项功能。

把 Atli eSIM 添加到 ChatGPT:侧边栏中的 Plugins,然后是 Add 和 Add custom MCP server。表单中填写了名称 Atli eSIM、地址 https://mcp.heyatli.com/r/YOUR_CODE,并选择了 No authentication。点击 Create as a plugin 之前,风险确认框已勾选

Claude。打开 Customize,再进入 Connectors。选择 + Add,再选择 Add custom connector。名称填 Atli eSIM,粘贴地址,选择 Continue,然后在 Claude 检测到的认证设置那一步再选一次 Continue。在 Authentication 下选择 Sign in when needed,保留 Claude 推荐的 OAuth 客户端,再选择 Add。只有当某项操作需要访问账户时,Claude 才会提示用户登录 Atli。在 Team 和 Enterprise 版上,由所有者在 Organization settings 里添加连接器,成员再选择 Connect。免费版 Claude 只允许添加一个自定义连接器。

把 Atli eSIM 添加到 Claude:依次选择 Connectors、+ Add 和 Add custom connector,填写名称 Atli eSIM 和地址,再选择 Sign in when needed,使用 Claude 推荐的 OAuth 客户端,最后选择 Add

Gemini。在 gemini.google.com 上打开 Settings,再进入 Connected Apps。如果那里没有,就到 Personal Intelligence 下面找。在 Custom apps 下选择 Add a custom app,粘贴地址,选择 Next,然后按步骤操作。Gemini 不会让你填名称,Atli 的服务器会自己报上名字:Atli eSIM。Gemini 还有额外的使用条件。自定义应用需要个人 Google 账户,还要开启 History。它们只能用英语,而且你必须年满 18 岁、人在美国。通过网页版完成配置后,这个自定义应用在 Gemini 手机 App 里也可以使用。

把 Atli eSIM 添加到 Gemini:依次打开 Settings、Connected Apps,在 Custom apps 下选择 Add a custom app,然后填入地址 https://mcp.heyatli.com/r/YOUR_CODE 并选择 Next

Muse。这样对 Muse 说:“通过这个地址添加 Atli eSIM MCP:https://mcp.heyatli.com/r/YOUR_CODE”。如果 Muse 要求确认,就确认一下。

把 Atli eSIM 添加到 Muse:在新聊天中发一条消息,请 Muse 通过合作伙伴地址添加 Atli eSIM MCP,如果 Muse 要求确认,再确认一次

Claude Code。一条命令就能添加服务器:

Bash
claude mcp add --transport http atli-esim https://mcp.heyatli.com/r/YOUR_CODE

Cursor、VS Code 和其他应用。添加一个远程 MCP 服务器,如果应用要求填写名称,就填 Atli eSIM,然后粘贴地址,登录一栏留空。任何支持通过 Streamable HTTP 连接远程 MCP 服务器的应用都可以。

然后像旅行者那样提问:“日本 10 天的 eSIM 套餐,用欧元报价”。

助手能做什么

MCP 参考文档实时列出所有可用的工具及其输入参数。

  • 查找套餐。search_plans 按目的地、时长、流量和货币搜索套餐。get_plan 提供套餐的更多详情,包括支持的网络。list_destinations 获取可选的目的地,check_device_support 检查手机、平板和手表是否兼容 eSIM。
  • 购买。get_quote 获取含适用折扣的最终价格。start_purchase 创建订单并生成付款链接。get_order_status 查询订单进度,cancel_order 和 get_receipt 分别处理取消订单和收据。
  • 购买之后。get_install_instructions 提供两个链接,交给要使用这张 eSIM 的人:一个在 Atli App 里打开它,另一个在浏览器里安装它,不需要 Atli 账户也能显示剩余流量。它还提供二维码、iPhone 和 Android 的安装链接,以及手动安装说明。list_my_esims 获取客户的 eSIM,refresh_usage 更新流量使用信息。
  • 其他功能。服务器还支持 eSIM 分享、已保存的付款方式、优惠券、Atli Credits、帮助文章查询,以及 Atli Groups 群组管理。

在聊天中如何付款

银行卡信息不会提供给 AI 助手或其提供商。客户会收到 Atli 安全付款页面的链接,由 Stripe 在那里处理付款,并在确认前显示总金额。

保存过银行卡的客户也可以直接在聊天中付款。Atli 的服务器会指示助手,只有在客户核对过价格和所选的卡,并明确同意这两点之后,才能扣款。客户只是笼统地表示想买 eSIM,并不算这个同意。服务器本身并不会强制执行这一要求。

客户无需登录,也能以访客身份购买 eSIM。助手会保存一个与这段对话关联的访客密钥,客户回到同一段聊天里,就能查看安装说明或剩余流量。安装链接在聊天之外也能用。它们可以在 Atli App 或 heyatli.com 上打开 eSIM,heyatli.com 不需要账户就能显示剩余流量。

登录 Atli 的客户,可以在受支持的各个对话中访问与自己账户关联的 eSIM。身份验证在 heyatli.com 上完成,因此密码和验证码不会通过聊天传递。

构建你自己的智能体

自定义智能体可以通过 Streamable HTTP 连接到 Atli 的 MCP 服务器。下面的示例使用官方 TypeScript SDK:

JavaScript
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'my-travel-agent', version: '1.0.0' });
await client.connect(
  new StreamableHTTPClientTransport(new URL('https://mcp.heyatli.com/r/YOUR_CODE'))
);

const result = await client.callTool({
  name: 'search_plans',
  arguments: { destination: 'Japan', days: 10, currency: 'EUR' },
});
console.log(result.content[0].text);

第一次调用购买相关的工具时,会创建一个访客账户并返回 guest_key。请把这个密钥安全地保存在该用户的对话会话中,并在后续请求中带上它。

guest_key 用于识别这个访客账户,凭它可以访问该账户下的 eSIM。

测试时,请连接 Sandbox 服务器 https://staging.public.mcp.heyatli.com/r/YOUR_CODE。Sandbox 支持使用 Stripe 的测试卡号 4242 4242 4242 4242 进行测试付款。Sandbox 的 eSIM 来自测试运营商,无法安装到手机上,Sandbox 上的销售也永远不计分成。

MCP 参考文档切换到 Sandbox 后,还会提供 试用 按钮,用于逐个测试工具。

MCP 销售如何计入你名下

通过你的 MCP URL 购买的新访客客户会归属到你的合作伙伴代码。

登录已有 Atli 账户的客户,需要 Atli 另行开启这项功能后才能归属到你。客户一旦成功归属到你的合作伙伴账户,他之后在各个 Atli 渠道中符合条件的购买都会计入你的推荐收益。

分成和结算的详情见 Atli 推广联盟的分成方式。需要自定义界面的应用,见 Atli API 指南。

常见问题

Atli MCP 服务器需要 API 密钥吗?
不需要。MCP 服务器是公开访问的。客户不需要账户就能浏览套餐,购买需要时会自动创建访客账户。登录 Atli 是可选的。
助手会不经询问就花钱吗?
付款链接只有在客户于 Atli 付款页面上完成支付后,才会产生付款。使用已保存的卡或 Atli Groups 群组的卡时,Atli 会指示助手在扣款前请客户同意价格以及由哪张卡或哪个群组付款。服务器本身并不会强制执行这一要求。
哪些 AI 助手可以用?
任何支持通过 Streamable HTTP 连接远程 MCP 服务器的助手都可以,包括 ChatGPT 插件、Claude 自定义连接器、Gemini 自定义应用、Muse、Claude Code、Cursor 和 VS Code。
用户之后去哪里找自己的 eSIM?
通过付款后助手提供的安装链接。一个在 Atli App 里打开 eSIM,另一个在 heyatli.com 上打开它,不需要账户就能安装并查看剩余流量。任何拿到这些链接的人都能安装这张 eSIM,所以链接只应交给要使用它的人。访客客户也可以回到原来的对话;登录后购买的客户,可以在其他受支持的对话中通过自己的 Atli 账户访问 eSIM。
连接服务器要花钱吗?
不用。把 Atli 添加到助手是免费的,用户只为自己选的 eSIM 付钱。助手自身的套餐可能会限制能添加哪些连接器。