概要
AI連携(MCP)
esimoa公式MCPサーバーを接続すると、AIがeSIMを検索・比較し購入リンクを案内します。
サーバーURL#
esimoa公式MCPサーバー https://api.esimoa.com/mcp を接続すると、AIがeSIMを検索・比較し購入リンクを案内します。Streamable HTTP(ステートレスJSON)方式で、キーなしでも使えます(IPごとに毎分120回)。
https://api.esimoa.com/mcpヒント
パートナーキーの設定#
ヒント
https://api.esimoa.com/mcp?key=esk_live_your_key_hereヘッダーを設定できるクライアントでは X-API-Key または Authorization: Bearer ヘッダーで送っても構いません。誤ったキーは401で拒否されるため、キーなしで使う場合は完全に外してください。
提供ツール#
| フィールド | 型 | 説明 |
|---|---|---|
search_esims | tool | 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_esim | tool | 商品詳細 — id、lang |
compare_esims | tool | 2〜5件のプランを並べて比較 — ids(search_esims の結果の id)、lang。最安・データ最多・期間最長・GB単価最安のプランを示します |
list_countries | tool | 販売国 — query、lang |
search / fetch | tool | ChatGPT互換ツール — 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メッセージで、各メッセージを1回として数えます。残りの上限を超えるバッチは実行前に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が返ります。
