Cómo conectar OTTO Sponsored Product Ads a Claude vía MCP

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

OTTO Sponsored Product Ads + Claude

Sponsored Product Ads de OTTO Market: campañas, SKU anunciados (targets), palabras clave y pujas, además de los informes SPA (KPI por campaña y producto, informes CSV) para anunciantes en otto.de. OAuth 2.0 client credentials con el scope de publicidad.

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:

OTTO_ADS_CLIENT_ID, OTTO_ADS_CLIENT_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas una cuenta de partner de OTTO Market que contrate Sponsored Product Ads y una app en OTTO Partner Connect. No hay inicio de sesión de usuario: el conector usa client credentials.

1. En OTTO Partner Connect, crea una app para tu propia cuenta (o abre la que ya usas para la Partner API) y activa las interfaces de Sponsored Product Ads.
2. Copia el client id y el client secret de la app. El secret solo se muestra una vez, al crearlo; si ya no lo tienes, renuévalo en OTTO Partner Connect.
3. Pega el client id en OTTO_ADS_CLIENT_ID y el secret en OTTO_ADS_CLIENT_SECRET. AnythingMCP ejecuta el flujo client credentials de OTTO con el scope advertising-services; un token dura 30 minutos y se vuelve a pedir cuando caduca.
4. Instala el conector y ejecuta otto_ads_list_campaigns: lista tus campañas con estado, tipo y presupuesto.

Separado del conector OTTO Market: Sponsored Product Ads usa su propio scope OAuth. Pedidos, productos, stock y devoluciones siguen en el conector OTTO Market, y mantener la publicidad aparte significa que una app sin la interfaz de publicidad sigue funcionando allí.

Qué lee: campañas con estado, tipo (AUTOMATIC o MANUAL), presupuesto, tipo de presupuesto, pacing y fechas; los SKU anunciados (targets) con sus pujas; las palabras clave de cada target con tipo de concordancia, positivas o negativas, y puja; KPI por campaña y por SKU (visualizaciones, clics, costes, ventas atribuidas, SKU pedidos, tasa de clics, coste por clic y retorno de la inversión publicitaria); e informes CSV por campaña, por palabra clave (con el término que el comprador escribió de verdad) y por producto.

Los importes van en céntimos de euro: presupuestos, pujas y costes llegan como {"amount": 160, "currency": "EUR"}, es decir, 1,60 euros. El importe mínimo de puja y presupuesto es 20 (0,20 euros). Las columnas de informe TOTAL_COSTS y TOTAL_SALES también son céntimos.

Las pujas están en dos sitios: las campañas AUTOMATIC pujan por target (SKU) y las MANUAL por palabra clave positiva. Las palabras clave negativas (sin puja) funcionan en ambas y pertenecen a un solo target: para excluir un término de búsqueda de toda la campaña, la IA lo añade a cada target.

Informes: los KPI cubren como máximo los últimos 90 días y nunca hoy; sin fechas, OTTO usa los últimos 7 días. OTTO atribuye ventas hasta 14 días después del clic, también de otros artículos de la misma marca, así que los últimos días todavía cambian. Para un informe CSV, la IA lo solicita, consulta otto_ads_get_report_status hasta que esté READY y lo descarga con otto_ads_download_report. Un archivo se guarda 24 horas. Solicitar un informe no cambia ninguna campaña.

Pregunta antes de cada cambio: otto_ads_create_campaign, otto_ads_update_campaign, otto_ads_add_targets, otto_ads_update_target_bids, otto_ads_add_keywords y otto_ads_update_keywords cambian tu publicidad activa y gastan dinero. La IA te muestra la campaña, el target o la palabra clave y el importe en euros, lo confirma contigo y espera tu sí. Las escrituras son asíncronas: OTTO responde con una solicitud de cambio, y la IA la sigue con otto_ads_get_change_request hasta que esté ACCEPTED o REJECTED (con el motivo).

Desactivada al instalar: otto_ads_delete_keywords. Borra de 1 a 50 palabras clave de un target y no se puede deshacer; bajar una puja suele ser mejor opción. Un administrador puede activarla a propósito.

Límites: OTTO permite como máximo 200 informes cada 24 horas entre todos los tipos de informe, aunque un informe no cambie nada. Por campaña solo puede haber una solicitud de cambio pendiente a la vez. Las listas llegan en páginas de hasta 1000 entradas, que la IA recorre con nextCursor. Al consultar una solicitud de cambio espera cada vez un poco más (1, 2, 4 segundos) para evitar el 429.

Errores frecuentes: si se rechaza el token, el client id o el secret son incorrectos o la app no tiene activada la interfaz de Sponsored Product Ads: revisa la app en OTTO Partner Connect. 409 significa que otro cambio en la misma campaña sigue pendiente. Un rechazo como "Invalid status transition PAUSED to PAUSED" significa que la campaña ya tiene ese estado. 404 "Data not found" en los KPI significa que la campaña no tuvo impresiones en el periodo; en una descarga, 404 significa que el informe aún no está listo y 410 que ha caducado.

El conector no lee pedidos, productos, stock ni devoluciones (para eso está el conector OTTO Market), no muestra datos de hoy ni de hace más de 90 días y no borra campañas ni targets.

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 Claude

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.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo OTTO Sponsored Product Ads, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuál de mis campañas de OTTO tuvo el mejor retorno de la inversión publicitaria en los últimos 30 días, y cuánto costó cada una en euros?"
• "Pausa la campaña Muebles de jardín verano. Revisa antes su estado actual y avísame cuando OTTO haya aceptado el cambio."
• "Sube a 0,80 euros la puja del SKU BL-4711 en mi campaña automática Ropa de cama. Enséñame la puja antigua y la nueva antes de cambiarla."
• "Pide un informe de palabras clave de los últimos 30 días y lista los términos de búsqueda que costaron dinero pero no vendieron nada, como candidatos a palabras clave negativas."
• "Crea una campaña automática Chaquetas de invierno con un presupuesto diario de 25 euros repartido de forma uniforme, desde el próximo lunes, y añade los SKU JK-100 y JK-200 con una puja de 0,50 euros cada uno."

FAQ

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

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