HARBEZ WB Feedbacks — MCP 커넥터

Wildberries의 리뷰와 질문이 Claude 채팅으로 바로 전달됩니다. 당신과 직원들이 어떤 기기에서든 조직의 어느 기기에서든 확인할 수 있습니다. Seller API 토큰은 서버 환경에만 저장됩니다. 대화 내용, 노트북, 프로젝트 파일 어디에도 없습니다.

Claude (проект «Коммерческий отдел»)
        │  HTTPS, streamable HTTP, персональный Bearer-ключ
        ▼
   Caddy (TLS, Let's Encrypt)
        │
   MCP-сервер (Docker, слушает только внутри сети compose)
        │  токены WB из .env
        ▼
   feedbacks-api.wildberries.ru

제공 기능

WB 요청은 스로틀링되며, 리뷰 텍스트는 600자로 잘립니다. wb_feedbacks_stats는 집계 결과만 반환합니다 — 컨텍스트를 과도하게 소모하지 않도록.

Related MCP server: wildberries-finances-mcp-server

VPS 배포

필요 사항: Ubuntu/Debian VPS, A 레코드가 연결된 서브도메인, 시작 시 root 권한.

# 1. На ВПС под root — пользователи, фаервол, Docker, клон репозитория
git clone git@github.com:Albertharbez/mcp-wb.git /srv/wb-mcp
bash /srv/wb-mcp/deploy/setup-vps.sh albert <логин-сотрудника>

# 2. Заполнить /srv/wb-mcp/.env (шаблон — .env.example)
#    MCP_DOMAIN, WB_TOKEN_*, MCP_CLIENT_KEYS

# 3. Поднять
cd /srv/wb-mcp && docker compose up -d --build
curl https://<MCP_DOMAIN>/healthz     # -> {"ok":true}

이후 코드 업데이트는 deploy/update.sh로 수행: git pull 실행, 재빌드, 서비스 재시작 및 /healthz 확인, 실패 시 로그 표시.

WB 토큰은 각 셀러 계정에서 생성: 설정 → API 액세스 → "질문 및 리뷰" 카테고리. 계정 하나당 토큰 하나.

한 VPS에서 두 명이 작업할 때

• 각자 별도의 SSH 사용자, 키로만 로그인, 비밀번호와 root 로그인은 비활성화. 공용 계정 없음 — 누가 무엇을 했는지 알 수 없기 때문.

• 둘 다 wb 그룹 (프로젝트 디렉터리 /srv/wb-mcp, setgid — 새 파일이 그룹을 상속) 및 docker 그룹 (서비스 시작 및 확인)에 속함.

• .env — 640 root:wb: 둘 다 읽을 수 있고, 서버의 외부인은 접근 불가.

• 코드는 서버에서 직접 수정하지 않고 git으로 관리: deploy/update.sh에서 git pull.

• 개인별 MCP_CLIENT_KEYS, 공용 아님. 로그에서 누가 접근했는지 확인 가능; 퇴사 시 해당 줄 삭제 후 재시작, WB 토큰 교체 불필요.

Claude 연결

Claude → Settings → Connectors → Add custom connector: URL https://<MCP_DOMAIN>/mcp, 헤더 Authorization: Bearer <개인 키>. 조직 소유자가 연결하면 커넥터를 부서 전체가 어떤 기기에서든 사용할 수 있습니다. 엔터프라이즈 요금제에서는 커스텀 커넥터를 먼저 조직 설정에서 허용해야 할 수 있습니다.

보안

• 토큰은 서버 env에만 존재. git에 포함되지 않으며 (.gitignore), 도구 응답에 나타나지 않고, 계정 toString에서 마스킹 처리됨.

• 인증은 fail-closed: 빈 MCP_CLIENT_KEYS — 서버가 시작되지 않음. 공개 모드는 명시적 MCP_ALLOW_NO_AUTH=true로만, localhost 전용.

• 외부에 열린 경로는 세 개: POST /mcp, GET /healthz (세부 정보 없음), GET /status (세부 정보, 키 필요). 그 외는 Caddy 수준에서 404.

• 서버 자체는 포트를 외부에 공개하지 않음: 유일한 진입점은 Caddy.

• 답변 게시는 유일한 되돌릴 수 없는 작업: destructiveHint, confirm=true, 서버의 WB_ALLOW_WRITES 차단 스위치.

• 이미 대화에 전송된 토큰은 유출된 것으로 간주. 즉시 폐기.

배포 시 수정된 사항

검증 완료 및 미검증

• 수정 사항의 구문과 로직은 검토 완료; tsc --noEmit 및 실행은 수행되지 않음 — 작업한 머신에 Node가 없음. 첫 빌드 실행은 VPS에서 (docker compose up -d --build), tsc도 이미지 내부에서 실행됨.

• 실토큰으로 WB 호출은 테스트되지 않음. .env 작성 후 wb_feedbacks_unanswered_count로 확인 — 가장 저렴한 호출.

• 필드 구성과 제한은 프로덕션 전에 확인: https://dev.wildberries.ru ("리뷰 및 질문" 섹션).