Cómo conectar Amazon Ads a ChatGPT 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 + ChatGPT

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 ChatGPT

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.

ChatGPT se conecta a servidores MCP como apps personalizadas en modo desarrollador (Developer mode), disponible en los planes de pago, no en el gratuito. En los espacios Business y Enterprise puede que un administrador tenga que habilitarlo antes.

1. En ChatGPT, abre Settings → Security and login y activa Developer mode.
2. Ve a chatgpt.com/plugins y pulsa +.
3. Escribe un nombre y una descripción breve, por ejemplo Name: Amazon Ads.
4. En Connection, introduce la URL del servidor MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y crea la conexión.
5. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP (OAuth) y permite el acceso.

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

¿Funciona el plan gratuito de ChatGPT con conectores MCP personalizados? No. Las conexiones MCP personalizadas necesitan el modo desarrollador, que solo está en los planes de pago.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse