インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Amazon Ads をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
Amazon Ads(Sponsored Products)のアカウントを読み取ります。広告プロファイル、キャンペーン、広告グループ、商品広告、キーワード、除外キーワード、ターゲットを確認し、Sponsored Products、Brands、Display の Reporting v3 パフォーマンスレポートをリクエストできます。NA、EU、FE リージョンのセラー、ベンダー、代理店向けです。
こう聞いてみよう
Amazon Ads のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Amazon Ads をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Amazon Ads + ChatGPT
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 — 認証情報を取得
-
Amazon Ads API へのアクセス権があることを確認します。承認済みの API アプリケーションと、それに関連付けた Login with Amazon(LWA)のセキュリティプロファイルが必要です。API アクセスは Amazon Ads(Partner Network、または
https://advertising.amazon.com/API)で申請します。API が承認されていないと、サインインはできても Amazon がすべての呼び出しを拒否します。 -
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)。 -
同じページの Client ID と Client Secret(Show Secret)を
AMAZON_ADS_CLIENT_IDとAMAZON_ADS_CLIENT_SECRETにコピーします。クライアント ID はamzn1.application-oa2-client.で始まります。 -
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 回ずつインストールしてください。
- 北米(US、CA、MX、BR):
-
AMAZON_ADS_REFRESH_TOKENは空のままにします。ただし、このセキュリティプロファイルを別の場所で Amazon Ads API 用にすでに認可している場合はそのトークンを貼り付けます(Atzr|で始まります)。コネクターをインストールし、Authorize with Provider をクリックして、広告アカウントにアクセスできる Amazon アカウントでサインインします。スコープはadvertising::campaign_managementです。 -
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 — ChatGPT にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
ChatGPT は開発者モード(Developer mode)で MCP サーバーをカスタムアプリとして接続します。有料プランで利用でき、無料プランでは使えません。Business・Enterprise のワークスペースでは、先に管理者が許可する必要がある場合があります。
- ChatGPT で Settings → Security and login を開き、Developer mode をオンにします。
- chatgpt.com/plugins を開き、+ をクリックします。
- 名前と短い説明を入力します(例: Name:
Amazon Ads)。 - Connection に MCP サーバー URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、接続を作成します。 - ChatGPT に求められたら AnythingMCP にサインイン(OAuth)し、アクセスを許可します。
利用可能なツール
| Tool | What it does |
|---|---|
amazon_ads_list_profiles | List the advertising profiles the authorized Amazon account can reach in this region: profileId, countryCode, currencyCode, timezone… |
amazon_ads_get_profile | Get one advertising profile by id: marketplace (countryCode), currency, timezone, daily budget and the account it belongs to |
amazon_ads_list_sp_campaigns | List Sponsored Products campaigns of a profile: campaignId, name, state, targetingType (MANUAL or AUTO), budget, bidding strategy and… |
amazon_ads_list_sp_ad_groups | List Sponsored Products ad groups of a profile with adGroupId, campaignId, name, state and default bid |
amazon_ads_list_sp_product_ads | List Sponsored Products product ads (the advertised ASINs or SKUs) with adId, adGroupId, campaignId, asin, sku and state |
amazon_ads_list_sp_keywords | List Sponsored Products keywords with keywordId, adGroupId, campaignId, keywordText, matchType (EXACT, PHRASE, BROAD), bid and state |
amazon_ads_list_sp_negative_keywords | List Sponsored Products ad-group negative keywords with keywordId, adGroupId, campaignId, keywordText, matchType (NEGATIVE_EXACT… |
amazon_ads_list_sp_targets | List Sponsored Products targeting clauses (product, category and auto targets) with targetId, adGroupId, campaignId, expression… |
amazon_ads_create_report | Request an asynchronous performance report (Reporting v3) and get back its reportId with status PENDING |
amazon_ads_get_report | Get the status of a report requested with amazon_ads_create_report: PENDING, PROCESSING, COMPLETED or FAILED (with failureReason) |
プロンプトの例
- 「広告プロファイルを、マーケットプレイスと通貨付きで一覧にしてください。」
- 「過去 30 日間の Sponsored Products のキャンペーン別レポートをリクエストし、完成したらダウンロードリンクを教えてください。」
- 「マニュアルキャンペーンで部分一致を使っているキーワードはどれですか。入札額も教えてください。」
- 「最大のキャンペーンの除外キーワードを見せてください。新しく追加する前に、漏れがないか確認したいです。」
FAQ
ChatGPT の無料プランでカスタム MCP コネクタは使えますか? いいえ。カスタム MCP 接続には開発者モードが必要で、有料プランでのみ利用できます。
次のステップ
このガイドは役に立ちましたか?