본문으로 건너뛰기

JTLGO Commerce MCP

공개 조회와 계정 작업을 하나의 MCP 연결로

JTLGO Commerce MCP는 AI 클라이언트를 구매·물류 도구에 연결하는 커넥터입니다. 공개 연결은 상품 검색, 중국발 운임 예상과 배송조회에 쓰고, 계정 연결은 OAuth 후 허용된 개인 정보를 다룹니다.

공개 엔드포인트 https://jtlgo.com/api/mcp

MCP 연결을 확인하고 있습니다…

프로토콜
—
도구
—
응답 시간
—

접근 방식 비교

필요한 접근 방식부터 선택하세요

공개 정보만 조회할지, OAuth로 계정 작업도 할지 결정하세요. URL 입력과 설정 파일은 같은 접속 주소를 지정하는 방식입니다.

계정 커넥터

하나의 URL에서 공개 도구와 권한이 있는 계정 도구를 사용합니다. 계정 접근이 필요할 때 MCP 클라이언트가 OAuth를 시작하며 이 웹페이지는 토큰을 처리하지 않습니다.

도구 10개 · 계정 정보가 필요할 때 OAuth

https://jtlgo.com/api/mcp/account

두 URL은 같은 공개 도구 6개를 제공합니다. 계정이 필요하면 계정 URL 하나만 설정하세요. 커넥터 두 개를 등록할 필요는 없습니다.

사용할 클라이언트 선택

익명 조회만 필요하면 공개 URL을 사용하세요. 계정이 필요하면 공개 도구도 포함한 계정 URL 하나를 설정합니다.

이 URL을 설정에 입력하세요

공개 도구 확인과 일반 조회에는 로그인이 필요하지 않습니다.

https://jtlgo.com/api/mcp

JSON 설정

클라이언트의 커넥터 입력란이나 설정 파일에 같은 URL을 넣으세요.

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

TOML 설정

[mcp_servers.jtlgo-commerce]
url = "https://jtlgo.com/api/mcp"

이 URL을 설정에 입력하세요

하나의 URL에서 공개 도구와 권한이 있는 계정 도구를 사용합니다. 계정 접근이 필요할 때 MCP 클라이언트가 OAuth를 시작하며 이 웹페이지는 토큰을 처리하지 않습니다.

https://jtlgo.com/api/mcp/account

JSON 설정

클라이언트의 커넥터 입력란이나 설정 파일에 같은 URL을 넣으세요.

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

TOML 설정

[mcp_servers.jtlgo-commerce]
url = "https://jtlgo.com/api/mcp/account"

계정 연결 설정

하나의 URL에서 공개 도구와 권한이 있는 계정 도구를 사용합니다. 계정 접근이 필요할 때 MCP 클라이언트가 OAuth를 시작하며 이 웹페이지는 토큰을 처리하지 않습니다.

https://jtlgo.com/api/mcp/account

인증 후 계정 도구

이 도구 4개는 클라이언트에서 OAuth를 완료한 뒤 사용할 수 있습니다.

get_account_summary

커넥터에 공개가 허용된 계정 요약과 고객 상태를 읽습니다.

list_customer_work_items

아직 처리해야 할 고객 작업을 나열합니다.

get_customer_work_item

작업 하나의 상세 정보를 열어 보조 작업을 이어갑니다.

create_support_ticket

부여된 권한 안에서 고객지원 티켓을 만듭니다.

공개 도구 6개

JTLGO 공개 커넥터에서 제공하는 도구입니다.

도구용도주요 입력반환 내용
search_products 상품 검색 keyword, site, limit 허용된 필드의 상품 후보
quote_shipping_rates 중국발 운임 예상 countryCode, weight, dimensions 노선 및 청구 중량 선택지
track_shipment 배송조회 운송장 번호 또는 번호 목록 최근 배송 기록과 이상 상황 안내
get_product_detail 상품 상세 확인 id 또는 상품 URL 허용된 상품 상세 정보
human_handoff 담당자 상담 language, reason 이메일과 WhatsApp 지원 경로
get_mcp_config 연결 설정 확인 입력 없음 커넥터 메타데이터와 도구 목록

인증 후 계정 도구

작동 방식 더 알아보기

아래 영문 글에서 에이전트 구매, 소싱 자동화의 한계와 물류 도구 연결 방식을 살펴볼 수 있습니다.

연결 전 자주 묻는 질문

공개 도구인데 연결 확인에 POST를 쓰는 이유는 무엇인가요?

JTLGO MCP 엔드포인트는 POST로 JSON-RPC를 받으며 같은 주소에 GET을 요청하면 405를 반환합니다. initialize, notifications/initialized, tools/list 순서로 하는 연결 확인은 구매나 결제 실행이 아닙니다.

연결 확인 순서 POST initialize → notifications/initialized → tools/list

계정 커넥터는 언제 사용하나요?

개인 계정 정보나 허용된 문의 생성을 AI에 요청할 때 사용합니다. 클라이언트가 OAuth를 진행하고 account:read, work_items:read, support:write 권한으로 접근합니다. 이 웹페이지는 토큰을 받지 않습니다.

두 URL을 모두 설정해야 하나요?

아닙니다. 공개 조회만 필요하면 공개 URL을 선택하세요. 계정 작업이 필요하면 계정 URL 하나에 공개 도구 6개도 포함돼 있습니다.