# cmh-market-mcp

> 네이버 스마트스토어 관리자 자동화 및 지식 지도 Model Context Protocol (MCP) 서버

## 개요
`cmh-market-mcp`는 AI 에이전트(LLM)가 네이버 스마트스토어 관리자 화면을 조작할 때 필요한 **화면 구조, 메뉴 경로, 버튼/입력창 선택자, 톡톡 CS, 3단계 안전 승인, 공식 도움말(2,903편) RAG 지식**을 제공하는 MCP 서버입니다.

## 기능 요약
- **화면 및 선택자 지도**: `market_capabilities`, `market_find_screen`, `market_screen_brief`, `market_find_element`, `market_find_field`, `market_find_api`
- **3단계 안전 승인**: `market_approval_hold`, `market_approval_pending`, `market_approval_decide`
- **네이버 톡톡 CS 상담**: `talk_threads`, `talk_read`, `talk_send`, `talk_order_candidates`
- **네이버 공식 도움말 RAG**: `market_find_help`, `market_help_read`, `market_help_categories`
- **네이버 검색광고 API**: `market_keyword_volume`, `market_tag_suggest`
- **분산 작업 큐**: `market_task_pending`, `market_task_next`, `market_task_heartbeat`, `market_task_release`, `market_task_done`
- **자가학습 및 보고**: `market_lesson_save`, `market_element_fix`, `market_report_to_human`

## 환경 변수
```bash
SHOPWARE_API_URL=https://your-shopware-domain.com
SHOPWARE_API_CLIENT_ID=YOUR_INTEGRATION_CLIENT_ID
SHOPWARE_API_CLIENT_SECRET=YOUR_INTEGRATION_CLIENT_SECRET
```

## 설치 및 빌드
```bash
npm install
npm run build
```

## MCP 연동 설정
```json
{
  "mcpServers": {
    "cmh-market-mcp": {
      "command": "node",
      "args": ["/path/to/cmh-market-mcp/dist/index.js"],
      "env": {
        "SHOPWARE_API_URL": "https://your-shopware-domain.com",
        "SHOPWARE_API_CLIENT_ID": "YOUR_INTEGRATION_CLIENT_ID",
        "SHOPWARE_API_CLIENT_SECRET": "YOUR_INTEGRATION_CLIENT_SECRET"
      }
    }
  }
}
```