SHEIN Seller MCPをGemini CLIに接続

💡 インストール不要？cloud.anythingmcp.com に直接アクセスしてください。 サインインし、Connectors → SHEIN Seller をクリックし、App ID と App Secret を貼り付け、Authorize with Provider をクリックして、SHEIN のショップのメインアカウントで承認し、MCP API キーを生成すれば完了です。Docker は不要、git clone も不要、ローカルサーバーも不要です。

SHEIN セラー + Gemini

AI を使って SHEIN セラーショップでの注文、バイヤーの住所と追跡のアップロード、荷物の追跡、価格と在庫のある製品、在庫と価格の更新、カテゴリと属性、アフターセールスのケースや返品を行いましょう。

前提条件

コネクタに組み込まれた完全なセットアップ手順を参照してください（コネクタを選択したときにアプリ内ストアで表示されます）。このコネクタに必要な環境変数は次のとおりです：

SHEIN_API_HOST, SHEIN_APP_ID, SHEIN_APP_SECRET

ステップ 1 — 認証情報を取得する

必要なもの: SHEIN Open Platform の Seller Self-Developed タイプの開発者アカウント（ショップの商人情報で確認済み）、ショップの協力モードの承認されたアプリ、およびそれを承認するためのショップのメインアカウント。約 20 分の作業に加え、SHEIN のアカウントとアプリのレビューが必要です。

1. https://open.sheincorp.com に登録し、開発者タイプ Seller Self-Developed を選択し、求められる商人情報を提出します（すべてはセラーのバックエンドにあります）。承認後はタイプを変更できません。
2. コンソールで Application Management を開き、アプリケーションを作成します。ショップの協力モードのアプリケーションタイプを選択します：Self-Operated または Semi-Managed（複数のモードのショップにはモードごとに 1 つのアプリが必要です）。名前、アイコン、説明はセラーに表示され、提出後は編集できません。SHEIN がアプリをレビューします。承認されるまで有効な App ID または App Secret はありません。
3. アプリの詳細ページで API Permission Package を確認します：注文、製品、在庫、アフターセールス、返品の API に加入する必要があります（通常は承認時に付与されます；そうでない場合は Apply for Permission Package をクリックします）。このサーバーのアウトバウンド IP アドレスをアプリの IP whitelist に追加します：SHEIN は他のアドレスからの本番呼び出しを拒否します（openapi00002）。AnythingMCP Cloud ではセットアップページにアドレスが表示されます。
4. App ID を SHEIN_APP_ID に、App Secret を SHEIN_APP_SECRET にコピーし、SHEIN_API_HOST の API アドレスを選択します：自己運営および半管理アプリには https://openapi.sheincorp.com、完全管理、SHEIN 運営およびその他のアプリには https://openapi.sheincorp.cn を使用します。
5. コネクタをインストールし、Authorize with Provider をクリックします（セットアップガイドの最後のステップで行います）。SHEIN のページが開きます：ショップの メインアカウント でセラーのバックエンドにサインインし、承認ボタンをクリックします。SHEIN はブラウザを <SERVER_URL>/api/shein-auth/callback に戻します（AnythingMCP Cloud では https://cloud.anythingmcp.com/api/shein-auth/callback）で、コネクタは SHEIN が許可する 10 分以内にショップのキーを取得します。

ショップキー: SHEIN はショップの openKeyId と secretKey を渡します（secretKey は App Secret で暗号化されており、AnythingMCP が一度復号化します）；両方ともコネクタに暗号化された状態で保存されます。SHEIN はそれらの有効期限や更新について文書化していません。承認は、セラーがアプリのバインドを解除したり、キーをリセットしたり、ショップが閉鎖されたり、SHEIN がリセットまたはバインドを解除したり、または期限切れになると終了します：その場合、呼び出しは openapi00004（「ユーザーの期限が切れました」）で失敗し、コネクタは新しい承認が必要であることを示し、誰かが再度 Authorize with Provider をクリックします。

署名の仕組み: 各呼び出しには x-lt-openKeyId、x-lt-timestamp（Unix ミリ秒）、および x-lt-signature が含まれます：5 つのランダムな文字の後に openKeyId&timestamp&path の小文字の hex HMAC-SHA256 の Base64 が続き、secretKey とその 5 つの文字で鍵付けされます。クエリは署名されません。タイムスタンプは 5 分間有効であるため、サーバーの時計が正確である必要があります。

どこから始めるか: shein_get_store_info は承認を確認し、ショップの名前を返します；shein_list_sites はサイトコードと通貨を提供します。

• 注文: shein_list_orders（最大 48 時間のウィンドウが必須）、次に shein_get_orders で一度に最大 30 件を取得します。在庫モード 3 の注文のみがセラーによって出荷されます；printOrderStatus 1 は、注文が現在処理可能であることを意味します。
• 自分で出荷する: shein_get_order_address（handle_type 2 は注文を出荷するために移動します）、shein_list_warehouse_addresses、shein_list_shipping_channels、次に shein_upload_tracking_numbers を各品目（goodsId）ごとに行います。shein_get_logistics_track は荷物を追跡します。SHEIN は運送業者がスキャンしたときに注文を出荷済みとしてマークします。shein_confirm_out_of_stock はインストール時にオフになっています。
• 製品: shein_search_products（コード、棚の状態、価格、在庫、キャンペーンロック）、shein_list_products（すべてのコード）、shein_get_product（1 つの SPU の全情報）。新しいリストについては: shein_get_category_tree、shein_get_attribute_templates、shein_list_brands。shein_set_skc_shelf_status はインストール時にオフになっています。
• 在庫と価格: shein_list_warehouses、shein_get_stock、shein_update_stock（各行に対して冪等性キーを使用）、shein_update_prices（価格の引き上げは SHEIN の価格レビューを待つ場合があります）。shein_get_sku_sales は管理ショップの販売単位を提供します。
• アフターセールス: shein_list_after_sales_orders と shein_get_after_sales_orders、shein_list_return_orders と shein_get_return_orders は読み取り専用です；shein_sign_return_order はインストール時にオフになっています。

コード、時間、金額: SPU、SKC、SKU コード（spuName、skcName、skuCode）は SHEIN のもので、supplierCode と supplierSku はセラー自身のものです。複数回販売された SKU は各品目ごとに 1 つの goodsId を持ち、追跡番号、キャンセル、返品レシートは goodsId ごとに機能します。goodsId の値は 64 ビットの数字です：コネクタは JavaScript の数値として長すぎるすべての id をその正確な桁数でテキストとして読み取り、ツールは id をテキストとして受け取り、SHEIN に数値として送信しますので、注文や返品が表示される通りに正確にコピーしてください。注文、アフターセールス、返品のウィンドウは北京時間（UTC+8）で yyyy-MM-dd HH:mm:ss 形式；注文の詳細は yyyy-MM-dd'T'HH:mm:ss.SSSZ で応答し、追跡イベントは Unix ミリ秒で表示されます。金額は隣に名前の付けられた通貨（orderCurrency、currency、currencyCode）で小数点表示されます。

制限: 各 API にはアプリごとの呼び出し制限があります（製品検索は 20、他は 30 から 300）。制限を超えると openapi00006 または 832213 で応答されます。注文と返品リストは 30 件ずつページングされ、製品検索は 10 件ずつです；注文ウィンドウは最大 10,000 件の注文を返し、製品リストは最大 50,000 コードを返します。同じ SKC とサイトは 20 分ごとに棚の状態を変更できます。

応答とエラー: SHEIN は code "0" と info に結果を返します；他の code はエラーで、msg と SHEIN サポートに 3 日以内に引用するための traceId が含まれます。コネクタは英語のメッセージを要求します（language: en）。openapi00001: 署名が拒否されました；サーバーの時計が正確であれば、これはショップキーが変更されたことを意味します（再承認または他の場所でリセットされた）、再度承認してください。openapi00002: このサーバーの IP アドレスがアプリのホワイトリストにありません。openapi00003: アプリにはこの API の権限がありません、API はショップのモードに適していないか、開発者アカウントが無効です。openapi00004: 承認が終了しました；再度承認してください。リストを取る書き込み呼び出しは code 0 を返し、拒否された行を名前付きで示します（failedList、failure_results または info）。

ステップ 2 — アダプターをインストールする

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加する

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう — Gemini CLI が SHEIN セラー のツールを呼び出せるようになりました。

利用可能なツール

例のプロンプト

• "過去 24 時間の SHEIN 注文の中で、今処理できるものはどれですか？"
• "注文 GSH12345678901 の両方の品目に対して UPS 追跡番号 1Z999AA10123456784 をアップロードします。"
• "在庫が 10 未満の SKU はどれですか？"
• "私のメイン倉庫で SKU コード I8xk2m4p0q の在庫を 60 に設定します。"
• "今週届いた返品注文とアフターセールスケースはどれで、バイヤーは何と言っていますか？"

FAQ

ショップキーやトークンを貼り付けますか？ いいえ。承認された SHEIN アプリの App ID と App Secret を貼り付け、Authorize with Provider をクリックします。SHEIN のページがショップのメインアカウントに承認を求め、コネクタがショップのキーを自動的に取得して保存します。承認が終了したら、再度 Authorize with Provider をクリックしてください。

どのショップに対応していますか？ 注文、追跡、在庫更新、返品は自己運営および半管理ショップ向けです；価格は自己運営ショップのみが設定できます。製品、カテゴリ、ブランド、サイト、在庫の読み取りも完全管理ショップで機能します。アプリのタイプに応じた API アドレスを選択してください：自己運営および半管理用は openapi.sheincorp.com、完全管理用は openapi.sheincorp.cn です。SHEIN はアプリの IP ホワイトリストにあるアドレスからの呼び出しのみを受け入れます；AnythingMCP Cloud ではセットアップページに追加するアドレスが表示されます。

どのツールがオフになっていますか？ shein_confirm_out_of_stock（注文行をキャンセルする）、shein_set_skc_shelf_status（製品を棚から外す）、および shein_sign_return_order（返品を確認する）がオフになっています。コネクタ内にはお金を動かしたり、支払済みの物流を予約したり、アフターセールスケースを決定したりするものはありません。

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディングページ
• Claude に接続する