Ozon Performance MCPでMeta Museと連携

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

Ozon Performance (Ads) + Meta Muse

セラーの広告アカウント向けの Ozon Performance API です。クリック課金、注文課金、バナーの各キャンペーンとその商品と入札額、競合の入札額と入札額の上限・下限、日別統計と支出統計、詳細なキャンペーンレポートを扱います。キャンペーンの停止と入札額の変更もできます。必要なのはサービスアカウントの client ID と client secret だけです。

前提条件

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

OZON_PERFORMANCE_CLIENT_ID, OZON_PERFORMANCE_CLIENT_SECRET

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

セットアップは約 3 分です。Ozon のセラーアカウントとその広告アカウント（Ozon Performance）が必要で、そこでサービスアカウントとそのキーを作成します。

1. Ozon のセラーポータルで Settings → API keys → Performance API（seller.ozon.ru/app/settings/api-keys?currentTab=performanceApi）を開きます。
2. サービスアカウントがまだない場合は Create new account で作成します。サービスアカウントの名前をクリックし、Add new key をクリックします。
3. client ID を OZON_PERFORMANCE_CLIENT_ID にコピーします。末尾が @advertising.performance.ozon.ru なので、全体をそのまま貼り付けてください。キーを追加したときに client ID と一緒に表示される client secret を OZON_PERFORMANCE_CLIENT_SECRET にコピーします。secret を失くした場合は、新しいキーを追加します。
4. コネクターをインストールし、ozon_performance_list_campaigns（引数なし）で接続を確認します。キャンペーンが、ほかのすべてのツールで使う ID 付きで一覧表示されます。

Ozon Seller コネクターとは別です: このコネクターは広告アカウントだけを扱い、専用の認証情報を使います。Seller API のキーはここでは使いません。注文、商品、在庫、価格には Ozon Seller コネクターを使ってください。

Cloud とセルフホストは同じ手順です: 同じ 2 つの値を貼り付けるだけで、設定する Redirect URL はありません。

トークンは自動で更新されます: コネクターは client ID と secret を POST /api/client/token（grant type client_credentials）で有効期間 30 分の bearer トークンに交換し、期限が切れる前、または 401 を受け取ったときに新しいトークンを取得します。トークン取得時の 401 は、client ID か secret が誤っているか、キーが削除されたことを示します。両方をもう一度コピーするか、サービスアカウントに新しいキーを追加してください。403 は、サービスアカウントにそのメソッドまたはキャンペーンへのアクセス権がないことを示します。

キャンペーンの種類: SKU はクリック課金（Оплата за клик）、SEARCH_PROMO は注文課金（Оплата за заказ）で、ほかに BANNER と VIDEO_BANNER があります。クリック課金キャンペーンの商品と入札額は ozon_performance_list_campaign_products で、注文課金プロモーションの商品は ozon_performance_list_cpo_products で取得します。

すぐに返る統計: ozon_performance_get_daily_statistics、ozon_performance_get_expense_statistics、ozon_performance_get_cpc_campaign_statistics は JSON の行ですぐに応答します。日付を指定しない場合は直近 7 日間が対象です。日付は日単位（2026-10-01）で、Ozon はモスクワ時間で集計します。ozon_performance_get_cpc_campaign_statistics はレポートの上限に数えられません。

詳細レポートは非同期です: ozon_performance_request_campaign_report は、最大 10 キャンペーン、最長 62 日間の商品別レポートを日、週、月単位で注文し、UUID を返します。AI は state が OK（または ERROR）になるまで数秒おきに ozon_performance_get_report_status を確認し、その後 ozon_performance_download_report でレポートを取得します。1 キャンペーンなら CSV テキスト（セミコロン区切り、列名はロシア語）、複数キャンペーンならキャンペーンごとに 1 つの CSV を含む ZIP ファイルです。同時に実行できるレポートはアカウントごとに 1 つだけで、1 日最大 2000 件です。以前に注文したレポートは ozon_performance_list_api_reports で探せます。ozon_performance_request_search_phrases_report は、上位表示プロモーションの検索フレーズについて同じ流れで動きます。このメソッドは Ozon がテスト中としています。

金額と ID: キャンペーンの予算は 100 万分の 1 ルーブル単位です（1000000 = 1 ルーブル）。ozon_performance_get_bid_limits の入札額の上限・下限はルーブル単位、注文課金の入札額は商品価格に対するパーセントです。ID は数字の文字列です。

入札額の変更: ozon_performance_update_campaign_bids は、クリック課金キャンペーンにすでに入っている商品の入札額を変更します。その際 Ozon は、キャンペーンのストップワードとフレーズ別入札額を送信した内容で置き換えます。ozon_performance_add_campaign_products で追加できる商品は 1 キャンペーンあたり最大 500 件で、自動戦略のキャンペーンにはそのオートパイロットのカテゴリーの商品だけを追加できます。クリック単価の入札額は平均クリック単価の戦略でのみ使われ、コネクターが読み取る現在の入札額と同じ単位で指定します。指定しない場合、Ozon が競争力のある入札額を設定します。

レート制限: アカウントごとに 1 日最大 100,000 リクエストで、さらにキャンペーンの変更（たとえば 1 キャンペーンにつき 1 日 500 回までの予算または戦略の変更）とレポートにも上限があります。429 が返ったら、しばらく待ってから再試行してください。

読み取れるデータ: 種類、状態、支払い方法、掲載面、戦略、期間、予算を含むキャンペーン、キャンペーンが宣伝する SKU またはバナー、クリック単価の入札額、目標広告費率、検索順位の範囲を含むクリック課金キャンペーンの商品、同じ SKU に対するほかのセラーの入札額、プロモーション手段、掲載面、カテゴリーごとの入札額の下限と上限、価格、入札額、表示指数、表示回数を含む注文課金プロモーションの商品、キャンペーン別・日別の表示回数、クリック数、支出、注文数、注文額、前払いアカウントとボーナスに分けた支出、クリック課金キャンペーンの期間合計、そして商品別の詳細レポートと検索フレーズのレポートです。

インストール時はオフ: ozon_performance_activate_campaign、ozon_performance_remove_campaign_products。前者はキャンペーンを開始し、広告の表示と予算の消化が始まります。後者はクリック課金キャンペーンから商品を外し、その入札額は失われます。必要なものだけをコネクターのページで有効にしてください。AI は変更のたびに事前にあなたの確認を取ります。ozon_performance_deactivate_campaign、ozon_performance_add_campaign_products、ozon_performance_update_campaign_bids はオンです。キャンペーンの停止、クリック課金キャンペーンへの商品の追加、入札額の変更を行い、支出も変わりますが、必ず AI が変更内容を正確に示した後で実行されます。

対象外: キャンペーンの作成とコピー、予算と戦略、注文課金の入札額の変更、バナーと動画の統計、注文のアトリビューションレポート、外部トラフィックの分析。

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

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

Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。

1. Muse で Settings → Connectors を開き、Add custom connector を選びます。
2. MCP サーバーの URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を貼り付けます。
3. Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
4. チャットで、Ozon Performance (Ads) のツールが必要になる依頼を Muse にしてみましょう。

チャットから設定することもできます（Web、iOS・Android アプリ、WhatsApp）。Muse に次のメッセージを送ってください:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Muse は Meta のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

• 「いま配信中の Ozon 広告キャンペーンはどれですか。それぞれの日予算はいくらですか。」
• 「先週、各キャンペーンは 1 日あたりいくら使いましたか。そのうちボーナスで支払った額はいくらですか。」
• 「クリック課金キャンペーンの現在の入札額を、同じ SKU の競合の入札額と比べてください。」
• 「10 月のクリック課金キャンペーンについて、週ごとにまとめた商品別の詳細レポートを注文して、要約してください。」
• 「注文課金プロモーションの商品のうち、価格に対する入札率が最も高いのはどれですか。今週の表示回数も教えてください。」

FAQ

Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。

Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。

次のステップ

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