MCP 経由で Ozon Seller を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Ozon Seller をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Ozon Seller + Cursor

AI エージェントから Ozon の出品者アカウントを運営します。商品、在庫と価格、FBS と FBO の出荷、返品、財務の計上明細と残高レポート、販売分析、倉庫、プロモーション、レビューと購入者の質問を扱い、価格と在庫の更新もできます。Client ID と API キーが 1 組あれば使えます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

OZON_CLIENT_ID, OZON_API_KEY

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

設定は Ozon の出品者アカウントで 3 分ほどです。このコネクターは実際の Ozon データでテスト済みで、読み取りツールは稼働中の出品者アカウントで確認されています。

1. セラーポータルで Settings → Seller API（seller.ozon.ru/app/settings/api-keys）を開き、Generate key をクリックします。
2. キーに名前を付けてロールを選びます。Admin ならすべてのツールが使え、より限定的なロールではそのロールの範囲のツールが使えます。キーの用途を聞かれたら、外部サービスを選んで AnythingMCP と入力します。
3. Ozon はキーを一度しか表示しないので、すぐに OZON_API_KEY にコピーし、同じページにある Client ID（数字）を OZON_CLIENT_ID にコピーします。コネクターをインストールします。
4. ozon_get_api_key_info を実行します。キーのロールと有効期限が表示されます。Ozon のキーの有効期間は 3 か月 なので、期限が切れる前に新しいキーを作成してください。

読み取れる内容：出品者の品番（offer_id）、Ozon の商品 ID、SKU による商品と、その名前、バーコード、価格、VAT、ステータス、審査エラー、FBO・FBS・rFBS ごとの在庫と自社倉庫ごとの在庫、最低価格・プロモーション適用後の価格・価格指数・FBO と FBS の販売手数料を含む価格、期間を指定した FBS・rFBS・FBO の出荷と、配送・追跡・キャンセル・商品ごとの支払額まで含む個別の FBS 出荷、理由とステータス付きの返品、Finance → Balance と同じ残高レポート、1 日分のすべての計上明細と最大 200 件の出荷にかかる計上明細、販売分析、自社倉庫、参加できる Ozon のプロモーション、レビューと購入者の質問です。購入者の連絡先は返されません。

財務：Ozon は 2026 年 9 月に旧来の取引一覧を廃止しました。コネクターはすでにその後継となるメソッド、つまり最長 30 日の残高レポート、日別の計上明細一覧、出荷ごとの計上明細を使っています。

出荷一覧には期間が必要：FBS と FBO の一覧では、AI は必ず開始日と終了日（最長 1 年）を指定します。今日の FBS 注文は、梱包待ちのステータスで絞り込みます。

サブスクリプション：レビューには Review management または Premium Pro、購入者の質問には Premium Plus のサブスクリプションが必要で、ない場合 Ozon はその呼び出しを拒否します。Premium Plus がないと、販売分析で取得できるのは売上と注文数のみで、対象は直近 3 か月、1 日 50 回までです。販売分析はいずれの場合も 1 分に 1 回までです。

変更の前に必ず確認：ozon_update_prices と ozon_update_stocks は稼働中のストアを変更します。AI は商品ごとに変更前と変更後の価格または在庫を示してあなたの承認を待ち、その後 Ozon の応答を確認して値を読み直します。在庫の値は現在の在庫を置き換え、引き当て済みの数量を含めてはいけないため、AI は先に引き当て数を読み取ります。各商品の価格変更は 1 時間に 10 回までです。レビューへの返信（ozon_reply_to_review）と質問への回答（ozon_answer_question）は商品ページで公開されるため、AI は公開前に正確な文面を見せます。

インストール時はオフ：ozon_ship_fbs_posting（FBS 注文を梱包単位にまとめる）と ozon_cancel_fbs_posting（FBS 注文のキャンセル。取り消しできず、出品者評価に影響することがあります）。管理者が意図して有効にした場合に限り使え、AI は毎回あなたの明確な確認を求めます。

レート制限：Client ID ごとに毎秒最大 50 リクエストで、さらにメソッドごとの制限があります。429 が返った場合、AI は Ozon が Retry-After で示す時間だけ待ちます。同じリクエストや失敗するリクエストを大量に送るキーは、Ozon にブロックされることがあります。

よくあるエラー：401 Invalid Api-Key は、キーが誤っている、期限切れ、または別の Client ID のものであることを意味します。403 "missing a required role" は、キー自体は有効でもそのロールではこのツールを使えないという意味です。ozon_get_api_key_info でロールを確認してください。403 "restricted to specific IP addresses" の場合は、キーですべてのネットワークを許可してください。

このコネクターは、商品カードの作成や編集、FBO の納品申請、ラベルや受け渡し書類の印刷、購入者とのチャット、プロモーションへの参加や管理、Performance（広告）API の利用は行いません。

ステップ 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 — Cursor にコネクタを追加

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

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Ozon Seller のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「今、梱包待ちの FBS 注文はどれ？ どの倉庫から出荷する？」
• 「10 月前半の Ozon 残高を見せて。計上額、支払額、売上、返品、手数料の内訳も。」
• 「自社倉庫で在庫切れの商品はどれ？ Ozon の倉庫にはまだ何個ある？」
• 「出荷 89491381-0072-1 について、Ozon が何を請求して何を支払ったか、計上明細を分解して説明して。」
• 「品番 ART-123 の価格を 1,990 ルーブルから 2,190 ルーブルに上げて。変更前に旧価格と新価格を見せて。」
• 「今週の新しい星 1 と星 2 のレビューを見せて、私が承認する返信の下書きを作って。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続