앱 사용법

AI 연결 (MCP)

평소 쓰는 AI(Claude Code, Codex, Hermes, Claude Desktop)에게 셀온의 주문·할 일·상품·문의 현황과 매출을 말로 물어볼 수 있게 연결합니다. 여러 스토어를 한 번에 모아 요약해 줍니다.

조회만 합니다

AI는 읽기만 합니다. 발주·발주확인·송장·문의 답변·설정 변경은 하지 않습니다. 주문자·수취인 이름은 가리고 주소·연락처는 보내지 않지만, 조회한 주문·문의·매출 내용은 연결한 AI 서비스로 전송됩니다.

연결하기

  1. 1

    AI 연결 켜기

    셀온의 앱 설정에서 AI 연결 (MCP) 카드를 찾아 연결 켜기를 누릅니다. 상태가 ✓ AI 연결 가능으로 바뀌면 됩니다.

  2. 2

    쓰는 AI 고르기

    연결할 AI에서 쓰는 AI를 고르면, 그 AI에 붙여 넣을 설정이 내 주소와 토큰이 채워진 채로 나옵니다. 복사를 누르세요.

  3. 3

    AI에 붙여 넣기

    앱 화면의 연결 방법에도 같은 순서가 나옵니다.

Claude Code

  1. 복사한 명령을 터미널(Windows는 PowerShell)에 붙여 넣어 실행합니다.
  2. claude mcp list 를 실행해 saleon 이 Connected 로 보이면 끝입니다.

모양 예시 — 실제 값은 앱에서 복사하세요.

claude mcp add --scope user --transport http saleon http://127.0.0.1:47321/mcp --header "Authorization: Bearer <토큰>"

Codex

  1. Codex 설정 파일(Mac ~/.codex/config.toml, Windows %USERPROFILE%\.codex\config.toml)을 열어 맨 아래에 붙여 넣고 저장합니다. 파일이 없으면 새로 만드세요.
  2. Codex를 다시 시작하고 /mcp 에서 saleon 이 보이는지 확인합니다.

모양 예시 — 실제 값은 앱에서 복사하세요.

[mcp_servers.saleon]
url = "http://127.0.0.1:47321/mcp"
http_headers = { Authorization = "Bearer <토큰>" }

Hermes

  1. 복사한 명령을 터미널에서 실행합니다.
  2. 인증을 물으면 Y 를 누르고, 셀온의 토큰 [복사]로 복사한 토큰을 붙여 넣습니다.
  3. 도구를 모두 켤지 물으면 Y 를 누릅니다.

모양 예시 — 실제 값은 앱에서 복사하세요.

hermes mcp add saleon --url http://127.0.0.1:47321/mcp

Hermes가 이 PC에서 실행될 때만 연결됩니다. 서버에서 돌리는 Hermes는 연결할 수 없습니다.

Claude Desktop

  1. Claude Desktop → 설정 → 개발자 → [구성 편집]으로 claude_desktop_config.json 을 엽니다.
  2. 파일이 비어 있으면 그대로 붙여 넣고, 이미 "mcpServers" 가 있으면 "saleon" 항목만 그 안에 추가해 저장합니다.
  3. Claude Desktop을 완전히 종료했다가 다시 실행합니다.

이 설정에는 셀온 실행 파일 경로가 들어갑니다. 예시를 손으로 옮겨 적지 말고 앱에서 복사하세요. 셀온을 다른 위치에 다시 설치했다면 다시 복사해야 합니다.

이렇게 물어보세요

예시 문장 그대로가 아니어도 됩니다.

현황셀온 현황 알려줘.
할 일오늘 처리해야 할 일 스토어별로 정리해줘.
발주 필요 주문오너클랜 발주 안 한 주문 보여줘.
주문 찾기주문번호 2026102012345 상태 알려줘.
상태별 건수배송중이랑 취소요청 몇 건씩이야?
상품 현황스토어별 상품 수랑 품절 상품 수 알려줘.
문의답변 안 한 문의 있어?
알림확인해야 할 알림 있어?
매출·판매건수지난 한달 모든 스토어 매출 알려줘.
자동화 설정자동발주 켜져 있는 스토어 어디야?
다시 조회지금 주문 다시 조회해줘.

언제 기준의 정보인가요?

주문·할 일·상품·문의 현황은 셀온이 마지막으로 수집한 결과로 바로 답하고, 기준 시각을 함께 알려 줍니다. 묻는 것만으로 판매자센터에 다시 접속하지 않으며, 최신으로 받으려면 "다시 조회해줘"라고 요청하세요. 매출만은 물을 때 판매자센터 통계를 읽어 오므로 수십 초 걸릴 수 있습니다.

알아 둘 것

셀온이 켜져 있어야 합니다AI는 이 PC의 셀온에 접속합니다. 셀온이 실행 중(창을 닫아도 트레이에 있으면 됨)이고 로그인돼 있어야 합니다.
토큰은 비밀번호입니다화면공유 중에는 [보기]를 누르지 마세요. 토큰을 [재발급]하면 지금 연결된 AI는 더 이상 접속할 수 없으니 AI 쪽 설정을 다시 해야 합니다.
포트기본 47321. 다른 프로그램과 겹칠 때만 1024~65535 사이로 바꾸세요. 바꾸면 AI 쪽 설정도 다시 해야 합니다.
연결을 열지 못했습니다대개 다른 프로그램이 같은 포트를 쓰고 있을 때입니다. 포트를 바꾸고 AI 설정을 다시 복사하세요.