AI 에이전트를 위한 MCP 서버

Seldons 는 mcp.seldons.ai 에 Model Context Protocol 서버를 운영합니다. 이 사이트가 사람에게 제공하는 무역 도구 — HS 코드 추정, 착륙원가와 권장 정가, 인증 확인, 상세페이지 분석 — 을 AI 에이전트가 호출할 수 있는 툴로 노출합니다.

키 없이 첫 계산 해보기

계정이나 결제 없이 아래 요청을 터미널에서 실행해 보세요. 제조원가 10달러, 무게 0.5kg인 화장품을 미국에 판매하는 예시입니다.

curl https://mcp.seldons.ai/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calculate_export_price",
    "arguments": {
      "factory_cost": 10,
      "factory_currency": "USD",
      "weight_kg": 0.5,
      "destination_market": "us",
      "category": "cosmetics",
      "dimensions_cm": {
        "length": 10,
        "width": 10,
        "height": 10
      }
    }
  }
}'

recommended_retail은 권장 정가, breakdown_usd는 비용 내역입니다. assumptions와 warnings도 함께 확인하세요. 운임과 세율 등은 계산용 가정이며 실제 견적이나 통관 판정이 아닙니다.

상품 URL을 해외 출시 준비표로 바꾸려면

다음 상품군의 해외 출시를 준비하시나요? 상품 URL마다 analyze_product_page를 호출하고, 원문 근거·수정안·우선순위를 검토표에 기록하도록 에이전트를 연결하세요. 유료 MCP는 반복 업무에 쓸 수 있는 구조화된 데이터를 제공합니다. 같은 분석은 웹 도구에서 무료로 이용할 수 있습니다.

로컬 예시: 원산지 영문 표기 보완

가상 세럼 페이지에는 “제조국: 대한민국”이 한국어로 적혀 있습니다. 아래는 기존 테스트 응답을 실제 파서와 MCP 어댑터에 재생한 발췌입니다. 결과 활용법을 보여주는 예시이며, 새 AI 분석이나 실제 고객 사례·매출 개선 실적이 아닙니다.

입력: 도구 이름과 인자

tools/call 요청의 params 부분입니다. example.com 주소는 테스트용이므로 실제 요청에 넣지 마세요. 실사용할 때는 본인 상품의 공개 URL과 발급받은 키를 사용합니다. 이 예시는 영어 결과를 요청합니다.

{
  "name": "analyze_product_page",
  "arguments": {
    "product_url": "https://shop.example.com/products/serum-30ml",
    "language": "en"
  }
}

출력: 검토표에 옮길 부분

에이전트는 검토표에 “원산지 영문 표기 없음”, 그 근거, “영문 원산지 한 줄 추가”와 중간 우선순위를 기록할 수 있습니다. 담당자는 원문을 확인하고 수정을 결정합니다. 표 저장과 정기 실행은 에이전트에 연결할 작업이며, MCP 서버가 상품 페이지를 직접 고치지는 않습니다.

{
  "result": {
    "gaps": [
      {
        "point": "No country-of-origin in English",
        "evidence": "제조국 appears only in Korean",
        "fix": "Add an English origin line",
        "impact": "medium"
      }
    ]
  },
  "read": {
    "html_only": true,
    "paginated_reviews": false
  },
  "redirected": false
}

결정 전에 읽은 범위를 확인하세요

html_only는 JavaScript 실행 뒤에만 나타나는 내용을 읽지 못했다는 뜻입니다. 페이지를 넘겨야 보이는 리뷰도 읽지 않았습니다. redirected가 true라면 requested_url과 url을 비교하세요. 페이지에 표시가 없다고 인증 미보유나 판매 적법 여부를 단정할 수 없습니다.

다음 SKU에도 같은 열을 사용하면 문제와 원문 근거·수정안을 함께 검토할 수 있습니다. 성공한 분석은 아래 과금 규칙에 따라 8크레딧을 사용합니다. 이 예시로 시간 절감이나 전환율 개선이 실측된 것은 아닙니다. 본인 상품 한 건을 평가용 키로 확인한 뒤 반복 업무에 연결해 보세요.

내 상품을 웹에서 먼저 분석 · 평가용 키 요청

어떻게 연결하나요?

https://mcp.seldons.ai/mcp · Streamable HTTP.

키 없이도 전체 도구 목록을 볼 수 있습니다. 그중 check_business_number와 calculate_export_price는 무료로 실행할 수 있으며, 유료 도구 실행에는 키와 크레딧이 필요합니다.

Claude Code:

claude mcp add --transport http seldons https://mcp.seldons.ai/mcp \
  --header "Authorization: Bearer sk_live_YOUR_KEY"

mcpServers 블록을 읽는 클라이언트라면 어디든 — Claude Code 의 .mcp.json, Claude Desktop 설정 파일, Cursor 의 mcp.json:

{
  "mcpServers": {
    "seldons": {
      "type": "http",
      "url": "https://mcp.seldons.ai/mcp",
      "headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
    }
  }
}

키 없이 붙이려면 headers 블록을 빼면 됩니다.

어떤 툴이 있나요?

전체 스키마는 tools/list 로 받습니다. 각 설명은 그 툴이 무엇을 하는지와 어디서부터 믿으면 안 되는지를 함께 적습니다. 뒤쪽이 읽을 가치가 있는 부분입니다.

과금은 어떻게 되나요?

크레딧은 선불이고 툴이 실행된 뒤에 차감합니다. 절대 먼저 깎지 않습니다. 툴마다 정해진 크레딧이 있고(위 표), 유료 응답에는 _meta.credits_remaining 이 실려 에이전트가 스스로 잔액을 알고 사용자에게 알릴 수 있습니다. 평가용 키는 100 크레딧으로 시작합니다 — 답의 품질을 판단하기에는 충분하고 실서비스로 쓰기에는 부족한 자리입니다.

과금하지 않는 경우 — 이 목록을 공개하는 것 자체가 정책입니다:

• 인증·검증·레이트 리밋 실패
• 우리 쪽 오류와 타임아웃
• isError: true 로 돌아온 모든 호출. 모델 요금을 이미 냈더라도 분석이 실패했으면 그건 우리 손실이지 고객 손실이 아닙니다
• 이미 답한 요청의 5분 이내 재시도

차감은 툴이 실행된 뒤에 합니다. 먼저 받고 나중에 돌려주지 않습니다. 유료 응답에는 _meta.credits_remaining 이 실려 있어 에이전트가 스스로 잔액을 알고 사용자에게 알릴 수 있습니다.

멱등. 에이전트는 재시도가 잦습니다. params._meta["ai.seldons/requestId"] 를 보내면 5분 안의 재요청은 첫 답을 그대로 무료로 돌려줍니다. 안 보내면 계정·툴·인자에서 우리가 만듭니다.

오류는 어떤 모양인가요?

툴 실패는 JSON-RPC 오류가 아니라 isError: true 인 정상 결과로 옵니다. MCP 규격이 그렇게 요구하고, 그래야 모델이 읽고 스스로 고칠 수 있습니다.

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits for this call.",
    "retryable": false,
    "required": 3,
    "remaining": 0
  }
}

코드: AUTH_REQUIRED · INSUFFICIENT_CREDITS · INVALID_INPUT · RATE_LIMITED · URL_UNREACHABLE · INTERNAL_ERROR · UPSTREAM_UNAVAILABLE. retryable 은 항상 들어갑니다. 없으면 에이전트가 무한 재시도하거나, 반대로 일시 장애를 영구 실패로 처리하고 자기 추측으로 답을 만듭니다.

호출 한도는 얼마인가요?

키 없이 분당 10회·일 100회(IP 기준). 키가 있으면 요금제에 따라 분당 20회·일 500회부터 시작합니다. 상한은 우리가 의존하는 원천 데이터의 한도에서 역산했습니다 — 우리 한도가 원천보다 느슨하면 원천이 먼저 막히고, 그때는 한 사람이 아니라 전원이 동시에 실패합니다.

키는 어떻게 받나요?

크레딧 팩을 구매하시면 Lemon Squeezy 가 라이선스 키를 메일로 보냅니다. 그 키를 클레임 페이지에 붙여넣으면 크레딧이 이미 충전된 sk_live_… 키를 그 자리에서 돌려드립니다. 먼저 만들 계정도, 저희를 기다릴 일도 없습니다.

사기 전에 유료 툴을 써보고 싶으시다면 무엇을 만드시는지 알려주세요. 100 크레딧이 든 평가용 키를 드립니다 — 답의 품질을 판단하기에는 충분하고 실서비스로 쓰기에는 부족한 자리입니다. 여기로 요청하세요.

크레딧은 만료되지 않고 구독이 아닙니다. Starter는 상품 페이지 분석 약 375회에 해당합니다. 수출가 계산은 무료이며 팩 크레딧을 차감하지 않습니다. 무료 호출에도 호출 횟수 제한은 적용됩니다. 팩은 호출 속도도 정합니다. Starter는 starter 티어, Team과 Scale은 team 티어입니다:

같은 이메일로 다시 구매하시면 쓰시던 계정에 충전됩니다 — 키가 하나 더 생기지 않고 쓰던 키를 그대로 쓰십니다. 환불하시면 크레딧을 회수하며, 이미 쓰셨다면 잔액이 음수가 됩니다. 숨기는 것보다 그대로 보여드리는 편이 낫다고 봅니다.

가격은 미국 달러이고 Lemon Squeezy 가 판매자(merchant of record)입니다. 부가세·GST 처리와 세금계산서는 저희가 아니라 그쪽에서 나갑니다.

키는 sk_live_… 모양입니다. 저장하는 것은 해시뿐이라 잃어버리면 다시 보여드릴 수 없습니다 — 폐기하고 새로 발급합니다.

왜 만들었나요?

이 사이트의 도구들은 브랜드가 국경을 넘어 팔 때 생기는 질문에 답합니다. 저 시장에 도착시키면 얼마인지, 어떤 인증이 필요한지, 국내에서 되던 페이지가 왜 해외에서 안 되는지. 사람은 브라우저에서 무료로 씁니다.

같은 일을 하는 에이전트는 브라우저 폼을 쓸 수 없습니다. 같은 답을 데이터로 받아야 하고, 가정에는 이름표가, 출처에는 출처가 붙어 있어야 하며, 조회가 실패하면 명확한 모르겠다가 와야 합니다. 마지막이 생각보다 중요합니다 — 깨끗한 "모름"을 받지 못한 에이전트는 빈칸을 추측으로 채우고 그것을 답으로 내놓습니다.

웹 도구와 이 서버는 같은 코드를 부릅니다. 여기서 받은 숫자는 이 사이트의 계산기가 주는 숫자와 같습니다 — 주장이 아니라 빌드마다 검사합니다.