Lumitec Amazon MCP — Setup

Generate your Claude Desktop / Cowork config snippet. Nothing leaves this page — the form runs in your browser and produces JSON you paste into your local config file. View on GitHub

1. Shared access

Issued by Lumitec. If you don't have one, email a.walters@lumitec.ai. Starts with lk_.
👁 show

2. SP-API credentials

From your Amazon SP-API developer account. If you haven't registered an SP-API app yet, do that first.

Developer Central → Your App → LWA Credentials
Same page as Client ID, revealed once on creation
From the seller authorisation flow — region-locked. Starts with Atzr|.
Must match the refresh token above
Default marketplace for tools that need one
Seller Central → Settings → Account Info → Merchant Token. Starts with A.

3. Ads API credentials

Separate from SP-API — registered in Amazon Advertising Console. Skip this section if you only use SP-API.

Your config snippet

Paste this inside the mcpServers object of your Claude config file. If the file already has other MCPs, merge these keys in; don't replace the whole object.

(fill the form above and click Generate)

Where to paste it

macOS
Windows
Linux

Open in your editor:

~/Library/Application Support/Claude/claude_desktop_config.json

Or from Terminal:

open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json

In Explorer address bar, paste:

%APPDATA%\Claude\claude_desktop_config.json

Or in PowerShell:

notepad $env:APPDATA\Claude\claude_desktop_config.json
~/.config/Claude/claude_desktop_config.json

Restart Claude

After saving, fully quit Claude (⌘Q on Mac / Alt+F4 on Windows) and reopen it. First launch downloads mcp-remote (~10 seconds); subsequent launches are instant.

Verify

In a new chat, try:

list my amazon marketplaces via the amazon-sp-api connector
check my amazon ads credentials

Both should return real data from your account.

Prerequisites: you must have Node.js installed — the config uses npx to run the bridge that forwards requests to Lumitec's hosted server.

Troubleshooting

"Some MCP servers could not be loaded" — you probably pasted the snippet outside the mcpServers object, or with a trailing comma issue. Validate the full file at jsonlint.com.

"missing or invalid X-Lumitec-Key" — the Lumitec key is wrong or expired. Email a.walters@lumitec.ai.

"Failed to authenticate with Amazon" — your Amazon Client ID / Secret / Refresh Token combination is wrong. Refresh tokens are region-locked: a token issued under the EU marketplace won't work with region: na. Re-run the seller authorisation flow for the right region.

MCPs don't appear after restart — check Claude Desktop is showing the right config file: Settings → Developer → MCP Config. If Node is missing, install it from nodejs.org.