개요

AI 연동 (MCP)

이심모아 공식 MCP 서버를 연결하면 AI가 eSIM을 검색·비교하고 구매 링크를 알려줘요.

이 페이지 내용

서버 주소#

이심모아 공식 MCP 서버 https://api.esimoa.com/mcp 를 연결하면 AI가 eSIM을 검색·비교하고 구매 링크를 알려줘요. Streamable HTTP(무상태 JSON) 방식이고, 키 없이도 쓸 수 있어요(IP당 분당 120회).

url

https://api.esimoa.com/mcp

팁

파트너라면 키를 함께 넣으세요 — 그래야 AI가 알려주는 링크에 내 파트너 코드가 붙어 커미션이 쌓여요. 헤더를 설정할 수 없는 Claude·ChatGPT 커넥터 화면에서는 URL 끝에 ?key= 를 붙이면 돼요:

url

https://api.esimoa.com/mcp?key=esk_live_your_key_here

헤더를 쓸 수 있는 클라이언트에서는 X-API-Key 또는 Authorization: Bearer 헤더로 보내도 돼요. 틀린 키를 넣으면 401 로 거부되니 키 없이 쓰려면 아예 빼세요.

필드	타입	설명
`search_esims`	tool	eSIM 검색 — country(ISO 코드 또는 아무 언어의 국가명), days, data_gb, unlimited, sort, limit(≤10), lang
`get_esim`	tool	상품 상세 — id, lang
`list_countries`	tool	판매 국가 — query, lang
`search / fetch`	tool	ChatGPT 호환 도구 — search {query}, fetch {id}

참고

공개 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회예요. 넘으면 JSON-RPC 오류(-32002)와 HTTP 429 를 받아요.