How to Connect the Amazon Ads MCP Server to Claude
amazonadsmcp.comConnect Amazon's official Amazon Ads MCP Server to Claude Desktop and Claude Code: the config, the OAuth flow, profiles, and troubleshooting.
Updated June 15, 2026 · The Amazon Ads MCP editorial team
This guide connects Amazon’s official Amazon Ads MCP Server, the first-party server that reached open beta in February 2026, to Claude. Claude was one of the first clients to support the Model Context Protocol, so the process is quick once your API access is in place.
What you need first
Get these in place before you touch any config:
- Claude Desktop or Claude Code installed.
- An Amazon advertiser, Seller, or Vendor account with active campaigns. Amazon will not approve API access for an account with no ad spend.
- Amazon Ads API access for your account, set up with the steps below. A managed third-party server skips this, since the provider already holds the access.
Getting Amazon Ads API access (the real prerequisite)
This is the part that takes the longest, mostly the approval wait, so do it first.
- Go to the Amazon Developer portal and sign in with the exact email tied to your Seller or Vendor account, then complete developer registration.
- Open the Amazon Ads API onboarding guide and click Request Access. Choose “I want to manage my own advertising,” add your company name, and select the markets you advertise in.
- Wait for approval, typically one to three business days. If you are rejected, the usual cause is no active ad spend, so make sure campaigns are running and reapply.
- Create a Login with Amazon (LWA) security profile, then copy its Client ID (begins
amzn1.application-oa2-client.) and Client Secret (beginsamzn1.oa2-cs.v1.), and set an allowed return URL that matches what your server expects. - Link that security profile to your Amazon Ads API application in the Ads console, not the developer portal. Skipping this is the top reason authorization fails later.
The fuller version, with the full credentials breakdown, is in how to set up Amazon Ads MCP.
Two things from Amazon’s connection docs are worth knowing before you connect:
- Your region. The official server has a regional endpoint for North America, Europe, and the Far East. Use the one that matches your account.
- Your account context. You connect either as a single account (you set one profile) or a manager account (agencies reaching many client accounts under one application).
The five steps
- 1 Add the server URL to Claude Point Claude at the official Amazon Ads MCP Server endpoint. No install.
- 2 Reopen Claude Fully quit and relaunch so it loads the new server.
- 3 Run the OAuth flow Ask Claude to start it, approve with your Amazon account, then confirm.
- 4 Set an active profile Tell Claude which account and marketplace to manage.
- 5 Validate Run a read-only prompt and check the numbers before any writes.
Step 1: Add the server to Claude
You connect to the official server with a small JSON block that points at its URL. The server is not region agnostic, so use the endpoint that matches your account’s region:
| Region | Endpoint URL |
|---|---|
| NA (North America) | https://advertising-ai.amazon.com/mcp |
| EU (Europe) | https://advertising-ai-eu.amazon.com/mcp |
| FE (Far East) | https://advertising-ai-fe.amazon.com/mcp |
The examples below use the NA URL. Swap in your region’s URL if you are not in North America.
Claude Desktop reads claude_desktop_config.json (at
~/Library/Application Support/Claude/ on macOS, or %APPDATA%/Claude/ on Windows):
{
"mcpServers": {
"amazon-ads": {
"type": "streamable-http",
"url": "https://advertising-ai.amazon.com/mcp"
}
}
}
Claude Code can do the same two ways. Either add the block to ~/.claude/mcp.json, or run
one command in your terminal:
claude mcp add --transport http amazon-ads https://advertising-ai.amazon.com/mcp
Because the official server uses OAuth, you do not paste any key here. If a server uses a bearer
token instead, add it as a header: "headers": { "Authorization": "Bearer YOUR_TOKEN" }.
Step 2: Reopen Claude
Fully quit and relaunch Claude so it loads the change. You should now see amazon-ads listed as
an available tool or connector.
Step 3: Run the OAuth flow
The server is connected, but it cannot touch your account until you authorize it. Type each prompt and watch what comes back:
- “Start the OAuth flow for Amazon Ads.” Claude returns a unique authorization URL.
- Open that URL, sign in with your Amazon account, and click Allow. You should see an “authorization successful” page.
- “Check the OAuth status.” Claude should reply that you are authenticated.
Step 4: Set an active profile
Amazon Ads works in profiles, where each profile is one account in one marketplace.
- “List my Amazon Ads profiles.” Claude returns each profile’s ID, type, and account name.
- “Set the active profile to [your profile ID].” This is required before any reporting or campaign tool will run.
If you connect as a manager account (common for agencies), you set the client account you want to act on the same way, choosing from the accounts your application can reach.
Step 5: Validate before you trust it
Start with read-only prompts and confirm the numbers against the Amazon Ads console:
- “List my Sponsored Products campaigns.”
- “Show my top keywords by spend over the last 30 days.”
If those return accurate data, the connection works. Only then try a small, low-risk write and confirm it behaves before doing anything at scale. For ideas, see Amazon Ads MCP use cases.
Troubleshooting
- “Invalid redirect URI” in the browser. The callback URL in your Login with Amazon profile does not match what the server expects. Make them identical.
- Browser says success, but Claude says not authenticated. Your LWA security profile is not linked to your Amazon Ads API application. Link it in the Ads console, then re-run the status check.
amazon-adsdoes not appear in Claude. Recheck the JSON for typos, confirm the file path, and fully restart Claude.
Related reading
- About the server itself: the official Amazon Ads MCP Server
- The full setup picture: how to set up Amazon Ads MCP
- Using a different client: connect Amazon Ads MCP to ChatGPT
Sources
- Amazon Ads, “Introducing the Amazon Ads MCP Server” (open beta, connecting clients). advertising.amazon.com
- Amazon Ads, “Amazon Ads API authorization overview” (Login with Amazon, profiles). advertising.amazon.com
Frequently asked questions
Can I connect Claude to the Amazon Ads MCP server directly?+
Yes. If the server is hosted (Amazon's official server or a managed provider), you add its URL to Claude and complete an OAuth login. There is nothing to install locally. You only run something yourself if you choose to self-host an open-source server.
Do I need Docker to connect Amazon Ads MCP to Claude?+
No, not for a hosted server like the official one. You point Claude at the remote URL and authenticate, with nothing to install. Docker only matters if you choose to self-host an open-source server yourself.
Do I need my own Amazon Ads API credentials?+
For Amazon's official server and for self-hosting, yes, you set up Amazon Ads API access first. A managed third-party server holds those credentials for you, so you just authorize your account and connect.
What is an Amazon Ads profile and why must I set one?+
A profile is one advertiser account in one marketplace, so your US store and Canada store are different profiles. Claude needs an active profile set before it can run reporting or campaign tools, so it knows which account to act on.
Keep reading
- Ultimate GuideWhat Is an MCP Server? The Ultimate GuideA plain-English and technical guide to MCP servers: what they are, how they work, why the AI industry adopted them so fast, and the security risks.
- ComparisonMCP vs API: Differences and When to Use EachA data-backed comparison of MCP and traditional APIs: how they relate, where they differ, the costs of MCP, and a clear rule for choosing.
- GuideWhat Is Amazon Ads MCP? A Complete GuideAmazon Ads MCP lets AI assistants manage Amazon advertising through the Model Context Protocol. What it is, how it works, and what you can do.
- GuideThe Official Amazon Ads MCP Server (Open Beta), ExplainedAmazon's official Amazon Ads MCP Server reached open beta on February 2, 2026. What it does, what it supports, and how to connect to it.
- TechnicalHow Amazon Ads MCP Works: Under the HoodHow an Amazon Ads MCP server works under the hood: OAuth and tokens, profiles and regions, tool definitions, the async report cycle, and limits.
- How-toHow to Set Up Amazon Ads MCP: A Step-by-Step GuideHow to set up Amazon Ads MCP: request Amazon Ads API access, create a Login with Amazon profile, connect your AI client, and validate safely.