Conectar Amazon Ads MCP con Microsoft Copilot

💡 ¿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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Amazon Ads.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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