Docs
开发者中心控制台esimoa.com
    • 简介
    • 快速开始
    • 身份验证
    • 概览
    • 搜索 eSIM
    • eSIM 详情
    • 在售国家
    • OpenAPI 规范
    • 追踪与佣金
    • 速率限制与错误
    • 概览
    • MCP 收录网站
    • Claude
    • ChatGPT
    • Gemini
    • 其他 MCP 客户端
    • 概览
    • 身份验证
    • 商品搜索
    • 商品详情
    • 在售国家
    • 错误与速率限制
  1. 文档
  2. AI 集成(MCP)
  3. 概览

概览

AI 集成(MCP)

连接 esimoa 官方 MCP 服务器,AI 即可搜索、比较 eSIM 并给出购买链接。

本页内容
  • 服务器地址
  • 填入合作伙伴密钥
  • 可用工具
  • 速率限制
  • 按客户端连接

服务器地址#

esimoa 官方 MCP 服务器 https://api.esimoa.com/mcp,AI 即可搜索、比较 eSIM 并给出购买链接。采用 Streamable HTTP(无状态 JSON),无需密钥也可使用(每个 IP 每分钟 120 次)。

url
https://api.esimoa.com/mcp

提示

第一次使用?从 Claude 开始吧——无需登录,只需填入一个 URL,大约一分钟即可连接。Claude 连接方法

填入合作伙伴密钥#

提示

合作伙伴请同时填入密钥,这样 AI 给出的链接会带上您的合作伙伴代码并累计佣金。在无法设置请求头的 Claude、ChatGPT 连接器界面中,在 URL 末尾加上 ?key= 即可:
url
https://api.esimoa.com/mcp?key=esk_live_your_key_here

支持请求头的客户端也可以通过 X-API-Key 或 Authorization: Bearer 发送。错误的密钥会被 401 拒绝,若不使用密钥请完全去掉。

可用工具#

字段类型说明
search_esimstool搜索 eSIM — country(ISO 代码或任意语言的国家名)·countries(多国同时)、days、data_gb·max_data_gb、unlimited、data_type(daily|total)、local_number(当地号码)、network(local|roaming)、multi_country、min_price_krw·max_price_krw、provider、hotspot·five_g、sort、limit(≤10)、lang
get_esimtool商品详情 — id、lang
compare_esimstool并排比较 2–5 个套餐 — ids(来自 search_esims 的 id)、lang。指出价格最低、流量最多、有效期最长和每 GB 价格最低的套餐
list_countriestool在售国家 — query、lang
search / fetchtoolChatGPT 兼容工具 — search {query}(自由文本:可识别无限流量、每日、当地号码、当地网络、热点和 5G),fetch {id}

在支持 MCP Apps 的应用(如 Claude、ChatGPT、VS Code)中,search_esims、get_esim、compare_esims 的结果会以套餐卡片显示。点击“查看套餐”会打开 esimoa 的商品页面,卡片本身不进行支付。

速率限制#

注意

公开 API 与已认证 MCP 共享每个伙伴的每小时配额(默认 20,000 次),添加或轮换密钥不会增加配额。

从首次请求起计 3,600 秒,并同时应用每分钟限制。按调用次数而非传输 MB 计算,实际配额可由运营配置调整。

MCP 批量请求最多 100 条消息,每条按一次调用计数。超出剩余配额时,在执行前返回 429。

X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset

这些响应头表示每小时上限、剩余次数及重置时间(Unix 秒)。超限返回 HTTP 429 和 Retry-After 秒数。每分钟限制拒绝的请求不计入小时配额。

不使用密钥时每个 IP 每分钟 120 次,使用合作伙伴密钥时每个密钥每分钟 600 次。Claude、ChatGPT 从自己的服务器发出的调用按平台而非 IP 计数。超出后返回 JSON-RPC 错误(-32002)与 HTTP 429。

按客户端连接#

MCP 收录网站

Claudeclaude.ai 连接器 · Claude CodeChatGPT开发者模式连接器GeminiGemini CLI · ~/.gemini/settings.json其他 MCP 客户端JSON-RPC 2.0 · POST

最后更新: 2026年10月2日

上一页速率限制与错误下一页MCP 收录网站

本页内容

  • 服务器地址
  • 填入合作伙伴密钥
  • 可用工具
  • 速率限制
  • 按客户端连接

将 esimoa eSIM 接入您产品的 API 与 MCP

资源

  • 文档
  • API 参考
  • 合作伙伴 API(B2B)
  • MCP 服务器
  • OpenAPI 规范

esimoa

  • 首页
  • eSIM 套餐
  • 开发者中心
  • 控制台
  • 合作伙伴门户

公司

  • 公司介绍
  • 合作咨询
  • 服务条款
  • 隐私政策
  • 交付与退款政策

支持

  • support@esimoa.com
  • 客服聊天

NBase Korea Co., Ltd.

京畿道龙仁市水枝区新水路767号, A栋902室(东川洞,盆唐水枝U-TOWER)

美国总部: NBASE CORP. · Corporate Park, Irvine, CA 92606, USA

© 2026 esimoa. All rights reserved.