Ozon Performance MCPでMicrosoft Copilotと連携

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

Ozon Performance (Ads) + Microsoft Copilot

セラーの広告アカウント向けの 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 — Microsoft Copilot にコネクタを追加

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

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。Ozon Performance (Ads) のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

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

利用可能なツール

プロンプトの例

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

FAQ

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

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