Amazon Ads MCPをMicrosoft Copilotに接続

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

Amazon Ads + Microsoft Copilot

Amazon Ads（Sponsored Products）のアカウントを読み取ります。広告プロファイル、キャンペーン、広告グループ、商品広告、キーワード、除外キーワード、ターゲットを確認し、Sponsored Products、Brands、Display の Reporting v3 パフォーマンスレポートをリクエストできます。NA、EU、FE リージョンのセラー、ベンダー、代理店向けです。

前提条件

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

AMAZON_ADS_CLIENT_ID, AMAZON_ADS_CLIENT_SECRET, AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL, AMAZON_ADS_TOKEN_URL

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

1. Amazon Ads API へのアクセス権があることを確認します。承認済みの API アプリケーションと、それに関連付けた Login with Amazon（LWA）のセキュリティプロファイルが必要です。API アクセスは Amazon Ads（Partner Network、または https://advertising.amazon.com/API）で申請します。API が承認されていないと、サインインはできても Amazon がすべての呼び出しを拒否します。

2. LWA コンソール（https://developer.amazon.com、Login with Amazon）でセキュリティプロファイルを開き、Web Settings の Allowed Return URLs に https://cloud.anythingmcp.com/api/mcp-oauth/callback を追加します（AnythingMCP をセルフホストしている場合は <your AnythingMCP URL>/api/mcp-oauth/callback）。

3. 同じページの Client ID と Client Secret（Show Secret）を AMAZON_ADS_CLIENT_ID と AMAZON_ADS_CLIENT_SECRET にコピーします。クライアント ID は amzn1.application-oa2-client. で始まります。

4. AMAZON_ADS_API_URL、AMAZON_ADS_AUTHORIZATION_URL、AMAZON_ADS_TOKEN_URL を、リージョンに合わせて次の順に設定します。

   • 北米（US、CA、MX、BR）: https://advertising-api.amazon.com、https://www.amazon.com/ap/oa、https://api.amazon.com/auth/o2/token
   • 欧州（UK、DE、FR、IT、ES、NL、SE、PL、TR、AE、SA、EG、IN）: https://advertising-api-eu.amazon.com、https://eu.account.amazon.com/ap/oa、https://api.amazon.co.uk/auth/o2/token
   • 極東（JP、AU、SG）: https://advertising-api-fe.amazon.com、https://apac.account.amazon.com/ap/oa、https://api.amazon.co.jp/auth/o2/token

   コネクターから見えるのは、そのリージョンのプロファイルだけです。複数のリージョンで広告を出している場合は、リージョンごとに 1 回ずつインストールしてください。

5. AMAZON_ADS_REFRESH_TOKEN は空のままにします。ただし、このセキュリティプロファイルを別の場所で Amazon Ads API 用にすでに認可している場合はそのトークンを貼り付けます（Atzr| で始まります）。コネクターをインストールし、Authorize with Provider をクリックして、広告アカウントにアクセスできる Amazon アカウントでサインインします。スコープは advertising::campaign_management です。

6. amazon_ads_list_profiles を実行します。プロファイルは 1 つのマーケットプレイスにおける 1 つの広告主で、その ID をほかのすべてのツールに渡します。一覧が空の場合、そのアカウントにはこのリージョンの広告アカウントがないか、キャンペーンを一度も作成していません。

読み取り専用です: AI は Sponsored Products のキャンペーン、広告グループ、商品広告（広告対象の ASIN または SKU）、入札額とマッチタイプ付きのキーワード、除外キーワード、商品、カテゴリー、オートの各ターゲットを一覧にします。

パフォーマンスはレポートで取得します: インプレッション、クリック、費用、売上、ACOS、ROAS はレポートでしか取得できません。amazon_ads_create_report が Amazon 側でレポートジョブを開始し（キャンペーンは変更しません）、amazon_ads_get_report がその状態を確認します。レポートは通常数分で完成しますが、混雑時には最大 1 時間かかることがあります。ほとんどのレポートタイプは 95 日前までさかのぼれ、DAILY レポートの対象は最大 31 日です。Sponsored Brands と Sponsored Display のキャンペーンは一覧にできませんが、そのパフォーマンスはレポートで取得できます。

レポートファイル: 完成したレポートは、gzip 圧縮された JSON ファイルへのダウンロードリンクで、有効期間は約 1 時間です。コネクターはこのファイルを展開できないため、AI はリンクをあなたに渡します。ご自身でダウンロードして開くか、展開できるツールに渡してください。費用はプロファイルの通貨で表示されます。

制限とエラー: Amazon はアカウントとエンドポイントごとにリクエストを制限し、429 と再試行までの待ち時間を返します。アクセストークンの有効期間は 1 時間で、自動的に更新されます。401: もう一度認可し、クライアント ID、サインイン URL、トークン URL が API エンドポイントと同じリージョンのものか確認してください。403: Amazon アカウントにそのプロファイルへのアクセス権がないか、セキュリティプロファイルが Amazon Ads API 用に承認されていません。425: 同じレポートがすでにリクエストされています。応答にそのレポートの ID が含まれます。

このコネクターは、キャンペーン、入札額、予算の作成や変更は行わず、Sponsored Brands と Sponsored Display のキャンペーンの一覧も取得しません。

ステップ 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 ウィンドウで試します。Amazon 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 は使えません。

利用可能なツール

プロンプトの例

• 「広告プロファイルを、マーケットプレイスと通貨付きで一覧にしてください。」
• 「過去 30 日間の Sponsored Products のキャンペーン別レポートをリクエストし、完成したらダウンロードリンクを教えてください。」
• 「マニュアルキャンペーンで部分一致を使っているキーワードはどれですか。入札額も教えてください。」
• 「最大のキャンペーンの除外キーワードを見せてください。新しく追加する前に、漏れがないか確認したいです。」

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 に接続
• ChatGPT に接続
• Cursor に接続
• Gemini に接続
• Meta Muse に接続