Conector MCP — Amazon Seller Central

Servidor MCP que conecta Claude con tu cuenta de Amazon Seller Central vía la Selling Partner API (SP-API). Permite consultar pedidos, resumen de ventas, inventario FBA y eventos financieros bajo demanda.

Herramientas expuestas

Related MCP server: Amazon SP-API MCP Server

Instalar en un ordenador nuevo (vía uvx)

Requisito único: tener uv instalado (curl -LsSf https://astral.sh/uv/install.sh | sh). uv descarga Python y las dependencias automáticamente — no hay que crear entornos ni instalar nada más.

Registra el conector en Claude (Code o Cowork) con un solo comando:

claude mcp add amazon-seller \
  --env SPAPI_REFRESH_TOKEN=TU_REFRESH_TOKEN \
  --env SPAPI_LWA_APP_ID=TU_APP_ID \
  --env SPAPI_LWA_CLIENT_SECRET=TU_CLIENT_SECRET \
  --env SPAPI_MARKETPLACE=ES \
  -- uvx --from git+https://github.com/USUARIO/amazon-seller-mcp amazon-seller

(Sustituye USUARIO por tu usuario de GitHub y rellena tus credenciales.)

Reinicia Claude y pregúntame, por ejemplo:

• "¿Cuántas ventas llevo hoy?"

• "Dame los pedidos de las últimas 6 horas"

Conseguir las credenciales (una sola vez)

1. Seller Central → Settings → User Permissions → Develop apps for your account.

2. Crea una aplicación y solicita los roles: Orders, Inventory, Finance y Selling Partner Insights / Sales.

3. Tras la aprobación obtendrás LWA client_id y LWA client_secret.

4. Autoriza la app sobre tu propia cuenta (self-authorization) para generar el refresh token.

Desde 2024 la SP-API ya no requiere claves AWS IAM ni firma SigV4: basta con las credenciales LWA.

Las mismas credenciales valen para todos tus ordenadores. Se pasan como variables de entorno en la config de Claude (ver arriba); nunca van dentro del repositorio.

Desarrollo local

uv run amazon-seller          # arranca el servidor por stdio

Para pruebas locales puedes poner las credenciales en un .env (gitignored); en producción se pasan como --env en la config de Claude.

Notas

• La SP-API es pull, no streaming: consulto la API en el momento que preguntas. Amazon aplica throttling, evita consultas en bucle.

• El refresh_token da acceso continuo a tu cuenta; trátalo como una contraseña.

• inventario puede devolver 403 si la cuenta no tiene habilitada la API de inventario FBA; el resto de herramientas funcionan con credenciales LWA.