AI 클라이언트 연동(MCP)

Claude나 ChatGPT와의 대화에서 Shopee 등록 작성, 매출·이익 확인, 상품 검색, 재고 조회와 업데이트를 할 수 있습니다. SellBridge 계정으로 연결하기만 하면 당신의 테넌트 범위 안에서만 조작합니다.

필요한 것

  • Basic 이상 요금제의 SellBridge 계정. Free 요금제에서는 AI 클라이언트 연동을 이용할 수 없습니다.
  • 연결된 Shopee 스토어가 1개 이상 있을 것.
  • MCP를 지원하는 AI 클라이언트(아래 참조).

엔드포인트는 https://mcp.sell-bridge.com/mcp입니다. 전송 방식은 MCP 표준 Streamable HTTP, 인증은 OAuth 2.1로, 사전 앱 등록이나 키 수동 입력이 필요 없습니다.

연결 방법

Claude.ai / Claude Desktop

  1. 설정 → ‘커넥터’ → ‘커스텀 커넥터 추가’를 엽니다
  2. URL에 https://mcp.sell-bridge.com/mcp를 입력합니다
  3. 표시되는 SellBridge 로그인 → 동의 화면에서 ‘허용’을 누릅니다

Claude Code

claude mcp add --transport http sell-bridge https://mcp.sell-bridge.com/mcp

ChatGPT

  1. 커넥터(커스텀 커넥터 / MCP) 추가 화면을 엽니다
  2. URL에 https://mcp.sell-bridge.com/mcp를 입력하고 OAuth 동의를 완료합니다

Cursor

~/.cursor/mcp.json에 추가합니다.

{
  "mcpServers": {
    "sell-bridge": { "url": "https://mcp.sell-bridge.com/mcp" }
  }
}

VS Code

.vscode/mcp.json에 추가합니다.

{
  "servers": {
    "sell-bridge": { "type": "http", "url": "https://mcp.sell-bridge.com/mcp" }
  }
}

처음 도구를 호출할 때 클라이언트가 자동으로 OAuth를 시작합니다. 동의 화면에는 연결하는 앱의 이름이 표시됩니다. 짐작 가는 데가 없는 앱 이름이라면 허용하지 마세요.

사용 예

연결한 뒤에는 평소 말투로 부탁하기만 하면 됩니다.

  • “SellBridge에 연결된 Shopee 스토어를 목록으로 보여 줘”
  • “지난달 매출과 이익률을 알려 줘”
  • “Amazon ASIN B0BZ8DZJQ6를 Shopee용으로 초안을 만들고, 카테고리 후보와 필수 속성을 확인해 줘”
  • “이 상품명과 설명이 Shopee에 등록할 수 있는지 컴플라이언스를 확인해 줘”

할 수 있는 일

모두 당신의 테넌트 데이터에 대해서만 동작합니다.

카테고리내용
스토어연결된 스토어 목록과 연동 상태 확인
카테고리 / 속성등록에 필요한 카테고리·속성·브랜드·배송 채널 가져오기
리서치Amazon ASIN으로 등록 정보 초안 작성
컴플라이언스금지·주의 단어 판정, 금지·제한 품목 규칙 검색
가격 계산권장 가격 산출과 지정 가격에서의 이익 시산
매출·이익 분석KPI, 주간·월간 매출과 주문 수, 이익 테이블, 저이익 주문
상품·재고 조회상품 카탈로그 검색과 상세, 재고 레코드와 상태별 건수
주문 조회주문 목록 정기 조회, 주문 명세, 주문 단위 이익 요약
Shopee 실데이터 조회Shopee상의 등록·옵션·카테고리별 등록 상한 직접 조회
이미지상품 이미지 업로드와 브랜딩 프레임 합성
등록 템플릿저장된 등록 템플릿 목록과 내용 가져오기
등록 작성⚠️단품／옵션이 있는 등록 작성
등록 편집⚠️기존 등록의 재고·가격·상품명·SKU·할부 설정·공개 상태 업데이트
내리기 / 삭제⚠️등록 내리기와 삭제(복원 불가)

⚠️ 표시가 있는 카테고리는 재고·가격·등록 상태를 실제로 변경합니다. 등록 삭제와 내리기는 취소할 수 없습니다. AI에게 전부 맡기지 말고 실행 내용을 확인한 뒤 허용하기를 권장합니다.

권한과 데이터 처리

  • 테넌트 분리: 모든 호출은 당신이 동의한 1개 테넌트의 자격 증명으로 실행됩니다. 다른 테넌트의 ID를 인수로 넘겨도 해당 테넌트에서는 해석되지 않아 접근할 수 없습니다.
  • 대화 내용은 저장하지 않습니다: 서버가 기록하는 것은 호출된 도구 이름·응답 시간·성공 여부입니다. 재고나 가격, 등록 상태를 변경하는 조작에 대해서는 대상 ID나 건수를 중심으로 한 요약만 추가로 기록하며, 상품 설명이나 이미지 URL 등은 기록하지 않습니다. AI 클라이언트 측의 대화 기록이나 파일을 읽지도 않습니다.
  • 해제: SellBridge 설정 → ‘외부 연동’ → ‘API 키’ 탭에서 연결된 커넥터를 언제든지 해제할 수 있습니다. 해제하면 액세스 토큰과 동의 기록이 무효화됩니다.
  • 무인 처리: cron이나 배치 등 브라우저 조작이 없는 처리에는 같은 ‘API 키’ 탭에서 발급하는 API 키(sk_로 시작하는 문자열)를 사용합니다. 용도별로 범위를 좁히고 개별로 무효화할 수 있습니다.
  • 요금제에 따른 차이: AI 클라이언트에서의 연결은 Basic 이상에서 이용할 수 있지만, 위의 ‘API 키’ 탭(커넥터 해제와 API 키 발급)은 Standard 이상의 화면입니다. Basic인 경우 지원팀에 문의해 주세요.

잘 안 될 때

  • 인증을 계속 요구함 / 401: 토큰이 만료되었습니다. 클라이언트에서 다시 연결해 주세요.
  • 특정 도구만 거부됨: 범위 또는 요금제가 부족합니다. 계약 요금제와 조작 내용을 확인해 주세요. Free 요금제에서는 모든 도구가 거부됩니다.
  • ‘미검증 앱’ 경고: 연결하는 앱이 SellBridge의 검증을 받지 않았다는 안내입니다. 앱 이름에 짐작 가는 데가 없다면 허용하지 마세요.

해결되지 않으면 support@sell-bridge.com로 문의해 주세요.

For reviewers (English)

SellBridge is a SaaS dashboard for Japanese cross-border sellers on Shopee. This MCP server lets an AI client work with the seller's own SellBridge tenant: read sales, profit, inventory, catalog and orders, and create or maintain Shopee listings.

  • Endpoint: https://mcp.sell-bridge.com/mcp (Streamable HTTP)
  • Auth: OAuth 2.1 with dynamic client registration and PKCE. No manual client setup is required — the client starts the flow on first use.
  • Plan requirement: the free plan is deliberately not entitled to these tools. Every call from a free-plan account is refused. Use a basic-or-higher account.
  • Scope of data: every call is scoped to the single tenant the credential belongs to. The tools that write to a live Shopee store are the ones marked ⚠️ in the table above; your client asks for approval before running a tool.

To test in about ten minutes: add the endpoint as a custom connector, complete the OAuth consent, then ask for the connected stores, last month's sales, a listing draft from an Amazon ASIN, and a compliance check — the four prompts listed under 사용 예 above.