본문으로 건너뛰기
전체 기사로 돌아가기

운임 견적·배송 조회용 MCP 서버

게시일 2026년 9월 16일 수정일 2026년 9월 17일
편집 책임 JTLGO Editorial Team
운영 검토 JTLGO Sourcing Operations Review 2026년 9월 16일
편집 정책
이 글의 내용
  1. 물류용 MCP 서버가 하는 일
  2. 운송용 MCP 서버가 제공해야 할 도구
  3. 운송 방식마다 견적이 다르고, 필요한 입력값도 다릅니다
  4. 서버 연결하기
  5. 공개 접근과 계정 접근
  6. 운송 커넥터를 믿기 전에 확인할 것
  7. 자주 묻는 질문
운임 견적·배송 조회용 MCP 서버

물류용 MCP 서버가 하는 일

운송용 MCP 서버는 운임 산정과 배송 조회를 타입이 정의된 도구로 제공해, 사람이 운임 포털을 여는 대신 어시스턴트가 직접 견적이나 배송 상태를 요청할 수 있게 해 줍니다. MCP, 즉 Model Context Protocol은 인터페이스 계층입니다. Claude, ChatGPT, Codex, Cursor, VS Code 같은 클라이언트가 서버에 어떤 도구가 있는지, 각 도구가 어떤 인수를 받는지, 응답이 어떤 형태로 돌아오는지 파악하는 방식을 정의합니다. 물류에서는 '얼마가 드나'와 '지금 어디쯤인가'라는 반복 업무 두 가지가 함수 호출로 바뀝니다.

이 글에서는 도구 유형별로 무엇을 기대할 수 있는지, 운송 방식에 따라 견적이 어떻게 다른지, 실제로 작동하는 서버를 어떻게 연결하는지 다룹니다. 예시는 중국발 노선의 견적과 배송 조회를 제공하는 공개 JTLGO Commerce MCP 커넥터를 사용합니다.

운송용 MCP 서버가 제공해야 할 도구

쓸모 있는 서버는 작습니다. 클라이언트는 설명만 보고 도구를 골라야 하므로, 모호한 도구 20개보다 명확하게 정의된 도구 4~6개가 낫습니다.

도구용도주요 입력값반환값
quote_shipping_rates노선 및 비용 견적중량, 도착 국가, 길이, 너비, 높이, 화물 유형과금 중량과 예상 운송 기간이 포함된 노선 옵션
track_shipment소포 또는 주문의 배송 상태운송장 번호 1건 또는 목록최신 타임라인 이벤트와 이상 징후 안내
search_products배송할 상품 찾기키워드, 플랫폼, 건수 제한식별자가 포함된 후보 상품
get_product_detail견적 전 상품 1건 확인상품 ID 또는 URL중량(공개된 경우)을 포함한 사양 필드
human_handoff확신이 낮을 때 사람에게 넘기기언어, 사유담당자가 이어받을 수 있는 지원 경로
get_mcp_config연결 확인없음커넥터 메타데이터와 도구 목록

마지막 두 개는 보기보다 중요합니다. 설정 도구가 있으면 운임 조회를 쓰지 않고도 커넥터에 연결되는지 확인할 수 있고, 명시적인 인계 도구가 있으면 답이 정말 불확실할 때 어시스턴트가 숫자를 지어내는 대신 넘어갈 곳이 생깁니다.

운송 방식마다 견적이 다르고, 필요한 입력값도 다릅니다

구매자들은 'LTL 견적용 MCP 서버', 'FTL 견적용 MCP 서버'처럼 운임 산정이 하나의 문제인 양 검색합니다. 에이전트 프로토콜 스택을 하나로 취급하는 것과 마찬가지입니다. 하지만 그렇지 않습니다. 운송 방식에 따라 견적 도구가 반드시 요구해야 할 입력값이 정해지며, 입력값을 너무 적게 받는 도구는 그럴듯한 엉터리 답을 내놓습니다.

운송 방식가격을 결정하는 요소견적 도구가 반드시 요구해야 할 입력값
소포·특송실중량과 부피중량 중 큰 값중량, 가로·세로·높이 세 치수, 도착지, 화물 유형
LTL(소량 화물 트럭 운송)화물 등급 또는 밀도, 부대 서비스팔레트 수, 치수, 등급 또는 밀도, 집하·배송 부대 서비스
FTL(트럭 단독 운송)구간, 차량 유형, 날짜출발지와 도착지, 트레일러 유형, 집하일
항공 화물부피 환산 계수로 계산한 운임 중량총중량, 치수, 출발·도착 공항, 품목 제한
해상 LCL·FCLCBM(입방미터) 또는 컨테이너 수와 종류부피 또는 컨테이너 종류, 출발·도착 항구, 인코텀즈

실무적으로 두 가지 결론이 나옵니다. 첫째, 치수 없이 중량만 받는 견적 도구는 추측하고 있는 것입니다. 거의 모든 운송 방식에서 과금 기준은 부피중량이기 때문입니다. 둘째, 도착 국가 내 LTL·FTL 운임 산정은 국제 수출 운임 산정과 데이터 출처가 다릅니다. 하나를 하는 서버가 다른 하나도 자동으로 하는 것은 아닙니다. 워크플로를 구축하기 전에 어느 쪽에 연결하는지 확인하세요.

JTLGO 커넥터는 중국발 노선의 견적을 제공합니다. 즉 중국에서 출발하는 특송, 항공, 해상 옵션이며, 과금 중량은 입력한 치수로 계산합니다. 도착 국가 내 트럭 운송 운임은 산정하지 않습니다. 같은 운임 엔진은 Rate and Ship에서, 같은 타임라인은 배송 조회에서 사람도 직접 이용할 수 있습니다. 이는 의도적으로 정한 범위이며, 에이전트 루프 안에서 뒤늦게 알게 되는 것보다 미리 알아 두는 편이 낫습니다.

서버 연결하기

호스팅형 MCP 서버는 URL 하나입니다. 대부분의 클라이언트는 그것만 있으면 되며, 전송 방식은 HTTP POST 위의 JSON-RPC입니다.

{
  "mcpServers": {
    "jtlgo": {
      "url": "https://jtlgo.com/api/mcp"
    }
  }
}

클라이언트에 연결하기 전에 직접 연결을 확인하려면 initialize 호출을 보낸 뒤 도구 목록을 요청하세요. 엔드포인트는 POST 방식과 함께 JSON과 event-stream 형식을 모두 명시한 Accept 헤더를 요구하며, 일반 GET 요청은 의도적으로 거부됩니다.

curl -X POST https://jtlgo.com/api/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

견적 호출도 다른 도구 호출과 똑같습니다. 중량만이 아니라 치수도 함께 넣으세요.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "quote_shipping_rates",
    "arguments": {
      "weight": 12,
      "countryCode": "US",
      "length": 40,
      "width": 30,
      "height": 25,
      "goodsType": "general"
    }
  }
}

공개 접근과 계정 접근

운송 커넥터에는 보통 두 단계의 접근이 필요하며, 이 둘을 섞는 것이 가장 흔한 연동 실수입니다. 운임 산정이나 공개 배송 조회 같은 공개 도구는 보호할 계정 정보가 없으므로 로그인이 필요 없습니다. 반면 고객 본인의 주문, 작업 항목, 지원 이력을 읽는 도구는 로그인이 필요하며, OAuth가 들어갈 자리가 바로 여기입니다.

JTLGO는 하나의 서버에 두 개의 URL을 제공합니다. https://jtlgo.com/api/mcp는 공개 도구 6개용이고, https://jtlgo.com/api/mcp/account는 같은 6개에 계정 범위 도구 4개를 더한 것으로, 계정 데이터가 실제로 요청될 때만 클라이언트가 OAuth 흐름을 시작합니다. 어시스턴트가 특정 고객의 배송에 관한 질문에 답해야 한다면 계정 URL을, 그렇지 않다면 공개 URL을 선택하세요. 둘 다 설정해도 얻는 이점은 없습니다.

운송 커넥터를 믿기 전에 확인할 것

  • 도구 호출이 실제로 업스트림까지 도달하나요? tools/list에 응답한다고 해서 서버가 제대로 작동한다는 보장은 없습니다. 목록 호출은 보통 정적 스키마로 응답합니다. 실제 도구를 호출해 보세요.
  • 견적 도구가 치수를 요구하나요? 중량만으로 견적을 낸다면 가볍고 부피가 큰 물건, 즉 대부분의 소비재에서 결과가 틀립니다.
  • 배송 조회가 '아직 데이터 없음'과 '찾을 수 없음'을 구분하나요? 고객에게 둘은 다른 의미이며, 이를 하나로 뭉뚱그리는 커넥터는 어시스턴트가 자신 있게 틀린 안심을 주게 만듭니다.
  • 명시적인 에스컬레이션 경로가 있나요? 운임 엔진은 제한 품목이나 흔치 않은 구간에는 아무것도 반환하지 않습니다. 올바른 동작은 추정하는 것이 아니라 사람에게 넘기는 것입니다.
  • 지원 범위가 명확히 적혀 있나요? 출발 지역, 지원하는 운송 방식, 도착 국가 내 트럭 운송 운임 산정 포함 여부를 확인하세요.

자주 묻는 질문

운송용 MCP 서버란 무엇인가요?

Model Context Protocol을 통해 운임 산정과 배송 조회를 호출 가능한 도구로 제공하는 서비스입니다. 사람이 운임 포털을 쓰는 대신 AI 어시스턴트가 직접 견적이나 배송 상태를 요청할 수 있습니다.

MCP 서버로 LTL·FTL 운임 견적을 받을 수 있나요?

가능합니다. 해당 운송 방식의 운송사 운임 엔진에 연결되어 있고 올바른 입력값을 요구한다면 말이죠. LTL은 팔레트 수, 치수, 화물 등급이, FTL은 구간, 차량 유형, 집하일이 필요합니다. JTLGO를 포함한 많은 물류 커넥터는 도착 국가 내 트럭 운송이 아니라 국제 수출 운송을 다루므로, 활용하기 전에 범위를 확인하세요.

물류 MCP 서버를 쓰려면 API 키가 필요한가요?

공개 운임 산정과 배송 조회에는 보통 필요 없습니다. 특정 고객의 계정을 읽는 기능에는 필요하며, 이 경우 설정 파일에 키를 붙여 넣는 방식이 아니라 클라이언트가 시작하는 OAuth 흐름이어야 합니다.

어떤 MCP 클라이언트에서 쓸 수 있나요?

호스팅형 HTTP 서버를 지원하는 클라이언트라면 모두 가능하며, 현재 Claude, ChatGPT, Codex, Cursor, VS Code가 여기에 해당합니다. 커넥터는 URL이고, 전송은 클라이언트가 처리합니다.

엔드포인트가 GET 요청을 거부하는 이유는 무엇인가요?

MCP의 HTTP 전송 방식이 POST 기반 JSON-RPC이기 때문입니다. 메타데이터를 돌려주는 GET을 두면 문서화되지 않은 두 번째 인터페이스가 생기므로, 비공식적으로 지원하지 않고 405로 거부합니다.

출처와 참고 자료

이 기사 공유: