개요
AI 연동 (MCP)
이심모아 공식 MCP 서버를 연결하면 AI가 eSIM을 검색·비교하고 구매 링크를 알려줘요.
서버 주소#
이심모아 공식 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 결과가 상품 카드로 보여요. 상품 보기를 누르면 이심모아 상품 페이지가 열리고, 카드에서 결제하지는 않아요.
요청 한도#
참고
공개 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 를 받아요.
