Conectar OTTO MCP con Microsoft Copilot

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

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 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 OTTO Sponsored Product 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

• "¿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

¿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