Cómo conectar Amazon Ads a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Amazon Ads, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Amazon Ads + Cursor

Lee cuentas de Amazon Ads (Sponsored Products): perfiles publicitarios, campañas, grupos de anuncios, anuncios de producto, palabras clave, palabras clave negativas y objetivos, y solicita informes de rendimiento de Reporting v3 para Sponsored Products, Brands y Display. Para vendedores, vendors y agencias, en las regiones NA, EU y FE.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

AMAZON_ADS_CLIENT_ID, AMAZON_ADS_CLIENT_SECRET, AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL, AMAZON_ADS_TOKEN_URL

Paso 1 — Obtener credenciales

1. Comprueba que tienes acceso a la Amazon Ads API: una aplicación de API aprobada y un security profile de Login with Amazon (LWA) vinculado a ella. El acceso a la API se solicita a Amazon Ads (Partner Network, o https://advertising.amazon.com/API). Sin la aprobación de la API, el inicio de sesión funciona, pero Amazon rechaza todas las llamadas.

2. En la consola de LWA (https://developer.amazon.com, Login with Amazon) abre el security profile, luego Web Settings, y añade https://cloud.anythingmcp.com/api/mcp-oauth/callback (si alojas AnythingMCP por tu cuenta: <your AnythingMCP URL>/api/mcp-oauth/callback) en Allowed Return URLs.

3. Copia el Client ID y el Client Secret (Show Secret) de la misma página en AMAZON_ADS_CLIENT_ID y AMAZON_ADS_CLIENT_SECRET. El client ID empieza por amzn1.application-oa2-client..

4. Configura AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL y AMAZON_ADS_TOKEN_URL para tu región, en ese orden:

   • Norteamérica (US, CA, MX, BR): https://advertising-api.amazon.com, https://www.amazon.com/ap/oa, https://api.amazon.com/auth/o2/token
   • Europa (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
   • Lejano Oriente (JP, AU, SG): https://advertising-api-fe.amazon.com, https://apac.account.amazon.com/ap/oa, https://api.amazon.co.jp/auth/o2/token

   Un conector solo ve los perfiles de su región, así que, si anuncias en varias, instálalo una vez por región.

5. Deja vacío AMAZON_ADS_REFRESH_TOKEN, salvo que ya hayas autorizado este security profile para la Amazon Ads API en otro lugar (ese token empieza por Atzr|). Instala el conector, haz clic en Authorize with Provider e inicia sesión con la cuenta de Amazon que tiene acceso a las cuentas publicitarias. El scope es advertising::campaign_management.

6. Ejecuta amazon_ads_list_profiles. Un perfil es un anunciante en un marketplace, y su ID se pasa a todas las demás herramientas. Una lista vacía significa que la cuenta no tiene cuenta publicitaria en esta región o nunca creó una campaña.

Solo lectura: la IA lista campañas de Sponsored Products, grupos de anuncios, anuncios de producto (los ASIN o SKU anunciados), palabras clave con pujas y tipos de concordancia, palabras clave negativas y objetivos por producto, categoría y automáticos.

El rendimiento viene de los informes: impresiones, clics, coste, ventas, ACOS y ROAS solo están disponibles como informes. amazon_ads_create_report inicia un trabajo de informe en Amazon (no cambia ninguna campaña) y amazon_ads_get_report comprueba su estado. Los informes suelen estar listos en minutos, pero en horas punta pueden tardar hasta una hora. La mayoría de los tipos de informe miran 95 días atrás, y un informe DAILY abarca como máximo 31 días. Las campañas de Sponsored Brands y Sponsored Display no se listan, pero su rendimiento está disponible mediante informes.

El archivo del informe: un informe terminado es un enlace de descarga a un archivo JSON comprimido con gzip, válido durante una hora aproximadamente. El conector no puede descomprimir ese archivo, así que la IA te da el enlace para que lo descargues y lo abras tú, o para pasarlo a una herramienta que pueda descomprimirlo. Los costes están en la moneda del perfil.

Límites y errores: Amazon limita las peticiones por cuenta y por endpoint y responde 429 con el tiempo que hay que esperar antes de reintentar. Los tokens de acceso duran una hora y se renuevan automáticamente. 401: autoriza de nuevo y comprueba que el client ID, la URL de inicio de sesión y la URL del token sean de la misma región que el endpoint de la API. 403: la cuenta de Amazon no tiene acceso a ese perfil, o el security profile no está aprobado para la Amazon Ads API. 425: ese mismo informe ya se solicitó, y la respuesta incluye su ID.

El conector no crea ni cambia campañas, pujas ni presupuestos, y no lista campañas de Sponsored Brands ni de Sponsored Display.

Paso 2 — Instalar el adapter

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

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Amazon Ads.

Herramientas disponibles

Ejemplos de prompts

• "Lista nuestros perfiles publicitarios con su marketplace y su moneda."
• "Solicita un informe de Sponsored Products por campaña de los últimos 30 días y dame el enlace de descarga cuando esté listo."
• "¿Qué palabras clave de nuestras campañas manuales usan concordancia amplia y cuáles son sus pujas?"
• "Muéstrame las palabras clave negativas de nuestra campaña más grande para revisar qué falta antes de añadir otras nuevas."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT