앱 사용법
AI 연결 (MCP)
평소 쓰는 AI(Claude Code, Codex, Hermes, Claude Desktop)에게 셀온의 주문·할 일·상품·문의 현황과 매출을 말로 물어볼 수 있게 연결합니다. 여러 스토어를 한 번에 모아 요약해 줍니다.
조회만 합니다
AI는 읽기만 합니다. 발주·발주확인·송장·문의 답변·설정 변경은 하지 않습니다. 주문자·수취인 이름은 가리고 주소·연락처는 보내지 않지만, 조회한 주문·문의·매출 내용은 연결한 AI 서비스로 전송됩니다.
연결하기
- 1
AI 연결 켜기
셀온의
앱 설정에서AI 연결 (MCP)카드를 찾아연결 켜기를 누릅니다. 상태가✓ AI 연결 가능으로 바뀌면 됩니다. - 2
쓰는 AI 고르기
연결할 AI에서 쓰는 AI를 고르면, 그 AI에 붙여 넣을 설정이 내 주소와 토큰이 채워진 채로 나옵니다.복사를 누르세요. - 3
AI에 붙여 넣기
앱 화면의
연결 방법에도 같은 순서가 나옵니다.
Claude Code
- 복사한 명령을 터미널(Windows는 PowerShell)에 붙여 넣어 실행합니다.
- claude mcp list 를 실행해 saleon 이 Connected 로 보이면 끝입니다.
모양 예시 — 실제 값은 앱에서 복사하세요.
claude mcp add --scope user --transport http saleon http://127.0.0.1:47321/mcp --header "Authorization: Bearer <토큰>"Codex
- Codex 설정 파일(Mac ~/.codex/config.toml, Windows %USERPROFILE%\.codex\config.toml)을 열어 맨 아래에 붙여 넣고 저장합니다. 파일이 없으면 새로 만드세요.
- Codex를 다시 시작하고 /mcp 에서 saleon 이 보이는지 확인합니다.
모양 예시 — 실제 값은 앱에서 복사하세요.
[mcp_servers.saleon]
url = "http://127.0.0.1:47321/mcp"
http_headers = { Authorization = "Bearer <토큰>" }Hermes
- 복사한 명령을 터미널에서 실행합니다.
- 인증을 물으면 Y 를 누르고, 셀온의 토큰 [복사]로 복사한 토큰을 붙여 넣습니다.
- 도구를 모두 켤지 물으면 Y 를 누릅니다.
모양 예시 — 실제 값은 앱에서 복사하세요.
hermes mcp add saleon --url http://127.0.0.1:47321/mcpHermes가 이 PC에서 실행될 때만 연결됩니다. 서버에서 돌리는 Hermes는 연결할 수 없습니다.
Claude Desktop
- Claude Desktop → 설정 → 개발자 → [구성 편집]으로 claude_desktop_config.json 을 엽니다.
- 파일이 비어 있으면 그대로 붙여 넣고, 이미 "mcpServers" 가 있으면 "saleon" 항목만 그 안에 추가해 저장합니다.
- Claude Desktop을 완전히 종료했다가 다시 실행합니다.
이 설정에는 셀온 실행 파일 경로가 들어갑니다. 예시를 손으로 옮겨 적지 말고 앱에서 복사하세요. 셀온을 다른 위치에 다시 설치했다면 다시 복사해야 합니다.
이렇게 물어보세요
예시 문장 그대로가 아니어도 됩니다.
| 현황 | 셀온 현황 알려줘. |
|---|---|
| 할 일 | 오늘 처리해야 할 일 스토어별로 정리해줘. |
| 발주 필요 주문 | 오너클랜 발주 안 한 주문 보여줘. |
| 주문 찾기 | 주문번호 2026102012345 상태 알려줘. |
| 상태별 건수 | 배송중이랑 취소요청 몇 건씩이야? |
| 상품 현황 | 스토어별 상품 수랑 품절 상품 수 알려줘. |
| 문의 | 답변 안 한 문의 있어? |
| 알림 | 확인해야 할 알림 있어? |
| 매출·판매건수 | 지난 한달 모든 스토어 매출 알려줘. |
| 자동화 설정 | 자동발주 켜져 있는 스토어 어디야? |
| 다시 조회 | 지금 주문 다시 조회해줘. |
언제 기준의 정보인가요?
주문·할 일·상품·문의 현황은 셀온이 마지막으로 수집한 결과로 바로 답하고, 기준 시각을 함께 알려 줍니다. 묻는 것만으로 판매자센터에 다시 접속하지 않으며, 최신으로 받으려면 "다시 조회해줘"라고 요청하세요. 매출만은 물을 때 판매자센터 통계를 읽어 오므로 수십 초 걸릴 수 있습니다.
알아 둘 것
| 셀온이 켜져 있어야 합니다 | AI는 이 PC의 셀온에 접속합니다. 셀온이 실행 중(창을 닫아도 트레이에 있으면 됨)이고 로그인돼 있어야 합니다. |
|---|---|
| 토큰은 비밀번호입니다 | 화면공유 중에는 [보기]를 누르지 마세요. 토큰을 [재발급]하면 지금 연결된 AI는 더 이상 접속할 수 없으니 AI 쪽 설정을 다시 해야 합니다. |
| 포트 | 기본 47321. 다른 프로그램과 겹칠 때만 1024~65535 사이로 바꾸세요. 바꾸면 AI 쪽 설정도 다시 해야 합니다. |
| 연결을 열지 못했습니다 | 대개 다른 프로그램이 같은 포트를 쓰고 있을 때입니다. 포트를 바꾸고 AI 설정을 다시 복사하세요. |