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アクセス → **「質問とレビュー」**カテゴリ。1アカウントにつき1トークン。

1つのVPSでの2人での作業

• 各人に個別の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ではプレースホルダーに置き換えられる。

• 認証はフェイルクローズ：MCP_CLIENT_KEYSが空だとサーバーは起動しない。オープンモードは明示的なMCP_ALLOW_NO_AUTH=trueでのみ、かつlocalhostのみ。

• 外部に公開されているのは3つのパス：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（「レビューと質問」セクション）。