Microsoft Ads en Claude Code, un comando
Claude Code
Para conectar Microsoft Ads a Claude Code, añade PaidSync.ai: ejecuta claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, escribe /mcp e inicia sesión con tu cuenta de PaidSync.
Claude Code accede a cuentas de Microsoft Ads con 156 tools: informes de campañas, grupos, palabras clave y términos, más pausas, presupuestos, negativas y grupos, palabras clave y anuncios nuevos en campañas existentes. Pregunta antes de cada tool.
Nivel Build. Claude Code trabaja dentro de tus campañas existentes, y cada nuevo grupo de anuncios, palabra clave y anuncio empieza en pausa salvo que digas lo contrario.
El comando
Claude Code se comunica con servidores MCP remotos mediante Streamable HTTP. PaidSync es uno de ellos. Añádelo una vez y la misma terminal que edita tu código podrá informar sobre tus campañas de Microsoft y gestionarlas.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor defecto, eso registra el servidor solo para el proyecto actual. Añade --scope user para que esté disponible en todos los proyectos de tu equipo.
Ejecuta claude mcp list para confirmar que está ahí, luego inicia una sesión y escribe /mcp para iniciar sesión.
Configuración en 5 pasos
1Regístrate en paidsync.ai/signup
Lleva 10 segundos. Inicio de sesión con Google o con correo. El plan gratuito incluye 100 tareas al mes, con un valor de $50, a $0, sin tarjeta.
2Conecta Microsoft Ads en el panel de PaidSync
Haz clic en Conectar en Microsoft Ads e inicia sesión con la cuenta de Microsoft que puede abrir tus cuentas de Microsoft Advertising. Microsoft Ads se autoriza mediante Microsoft OAuth, y PaidSync gestiona el token de desarrollador por su parte.
¿Ya estás dentro de Claude Code? Pídele que ejecute connect_microsoft_ads. La herramienta devuelve un enlace para abrir en tu navegador.
3Elige la cuenta publicitaria en la que debe trabajar Claude Code
Dentro de una sesión, list_ms_accounts muestra las cuentas de Microsoft Ads a las que llega tu inicio de sesión, y set_active_microsoft_account elige aquella en la que trabaja Claude Code.
4Añade PaidSync a Claude Code
En tu terminal, ejecuta:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicia una sesión, escribe /mcp, elige paidsync e inicia sesión con tu acceso de PaidSync en la ventana del navegador que se abre. Claude Code guarda el token OAuth por ti. No se pega ninguna clave en ningún sitio.
¿Lo configuras para un equipo? Sube un .mcp.json en la raíz del repositorio para que cada ingeniero reciba el mismo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}¿Prefieres una clave API, por ejemplo para ejecuciones sin interfaz? Envíala en una cabecera, nunca en la URL, donde acabaría en los registros:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"En un .mcp.json versionado, añade "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que la clave se quede en el entorno de cada ingeniero y nunca entre en git. Aplicar un cambio en Google Ads sigue requiriendo el inicio de sesión OAuth. En otras plataformas una clave también puede aplicar cambios, así que trátala como una contraseña y prefiere OAuth.
5Prueba la conexión
En una sesión de Claude Code pregunta: “Muéstrame mis campañas de Microsoft Ads de los últimos 30 días con gasto, clics, conversiones y ROAS”
Claude Code devuelve gasto, clics, impresiones, conversiones, ingresos, CTR, CPC medio y ROAS de cada campaña. La conexión está activa.
El plan gratuito incluye 100 tareas al mes. Pro desde $99 al mes, Team desde $249.
Prompts de Microsoft Ads en Claude Code
Cada prompt de abajo corresponde a herramientas del grupo Microsoft Ads de PaidSync. Claude Code elige la herramienta. La última columna indica si la llamada puede cambiar algo en la cuenta publicitaria.
| Petición | Herramientas que llama | Cambia tu cuenta |
|---|---|---|
| “Lista mis cuentas de Microsoft Ads y activa Acme” | list_ms_accounts, set_active_microsoft_account | No |
| “Muestra las campañas de los últimos 30 días con gasto, clics, conversiones y ROAS” | get_ms_performance | No |
| “Qué términos de búsqueda gastaron dinero en los últimos 30 días sin conversiones” | get_ms_search_query_performance | No |
| “Añade los cinco peores como negativas de concordancia exacta a la campaña Brand Search” | add_ms_negative_keywords | Sí, después de que confirmes |
| “Pausa la campaña Spring Sale” | pause_ms_campaign | Sí, después de que confirmes |
| “Sube el presupuesto diario de la campaña Brand Search a $80” | update_ms_campaign_budget | Sí, después de que confirmes |
| “Añade un grupo de anuncios llamado Trail Shoes a la campaña Running con cinco palabras clave de concordancia de frase y un anuncio de búsqueda responsivo” | create_ms_adgroup, add_ms_keywords, add_ms_responsive_search_ad | Sí, después de que confirmes |
Ejecútalo en modo headless con claude -p
El indicador -p ejecuta Claude Code sin la sesión interactiva. Inicia sesión una vez con /mcp y el token de OAuth guardado se mantiene. Un informe que termina en un archivo se ve así:
claude -p "Pull last 30 days Microsoft Ads search terms and list the terms that spent money with no conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/microsoft-ads-$(date +%F).jsonLas lecturas se ejecutan directamente, y las escrituras también. --allowedTools "mcp__paidsync" permite todas las herramientas de PaidSync, escrituras incluidas, sin aviso.
Para un trabajo desatendido, permite solo las herramientas de lectura que necesite, cada una por nombre como mcp__paidsync__tool_name.
Qué lee y qué escribe
De las 156 herramientas de Microsoft Ads, 82 solo leen y 72 pueden escribir. Las lecturas cubren el rendimiento de campañas, grupos de anuncios, palabras clave, términos de búsqueda, conversiones, ubicaciones y audiencias.
Leer más
Las escrituras cubren pausas, presupuestos, cambios de grupos de anuncios y palabras clave, palabras clave negativas, nuevos grupos de anuncios, palabras clave y anuncios de búsqueda responsivos, audiencias, etiquetas UET y objetivos de conversión.
Los cambios de presupuesto, palabras clave negativas, grupos de anuncios, palabras clave y anuncios se previsualizan por defecto con dry_run, y los nuevos grupos de anuncios, palabras clave y anuncios empiezan en pausa.
Con MCP, el paso de aprobación es el propio aviso de Claude Code. Pregunta antes de ejecutar una herramienta, salvo que la hayas permitido con --allowedTools o en tus ajustes. PaidSync añade comprobaciones por su parte. Las eliminaciones, pausas y cambios de presupuesto requieren confirm_destructive, y una comprobación de reglas previa a la escritura bloquea los argumentos inseguros. La tarjeta de aprobación, y Undo en una tarjeta aplicada cuyo cambio tiene una inversa segura, solo se aplican en el espacio de trabajo de PaidSync.
Añadir a ChatGPT: abre PaidSync.ai en el directorio de plugins de ChatGPT, instálalo e inicia sesión.
Añadir a Claude: abre PaidSync.ai en el directorio de conectores de Claude, haz clic en Conectar e inicia sesión.
Lo que Claude Code no puede en Microsoft
- PaidSync no crea campañas de Shopping ni de Audiencia en Microsoft Ads. Créalas en Microsoft Advertising, o impórtalas desde Google Ads, y PaidSync construye después dentro de ellas.
- No hay herramientas de Microsoft Ads para estrategias de puja ni etiquetas.
- Los anuncios adaptables de búsqueda son el único tipo de anuncio que PaidSync crea o edita en Microsoft Ads.
- PaidSync no elimina anuncios, grupos de anuncios ni palabras clave. En su lugar los pausa.
- Vuelve a activar una campaña en pausa con
enable_ms_campaign.
Preguntas frecuentes
¿Cómo conecto Microsoft Ads a Claude Code?
Regístrate en paidsync.ai, conecta Microsoft Ads en el panel y ejecuta claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp en tu terminal. Escribe /mcp dentro de una sesión, elige paidsync e inicia sesión con tu acceso de PaidSync.
¿Puede Claude Code crear campañas de Microsoft Ads?
PaidSync crea campañas de búsqueda y Performance Max, en pausa, y construye dentro de campañas existentes con nuevos grupos de anuncios, palabras clave y anuncios de búsqueda responsivos. Las campañas de Shopping y de Audiencia se crean en Microsoft Advertising.
¿Puede Claude Code cambiar los presupuestos de Microsoft Ads?
Sí. update_ms_campaign_budget cambia el presupuesto de una campaña. Primero se previsualiza como simulación, lee de vuelta de Microsoft el nuevo presupuesto una vez aplicado, y Claude Code te pregunta antes de ejecutar la herramienta.
¿Funciona en modo headless con claude -p?
Sí. Una vez que has iniciado sesión con /mcp, claude -p reutiliza el token de OAuth guardado. Las lecturas se ejecutan directamente. Las escrituras requieren cuidado. No hay nadie para responder al aviso de Claude Code, así que cualquier herramienta de escritura que hayas permitido con --allowedTools se ejecuta directamente. Para un trabajo desatendido, permite solo las herramientas de lectura que necesite.
Es gratis
Sí. El plan gratuito cuesta $0 por 100 tareas al mes, sin tarjeta. Pro empieza en $99 al mes y Team en $249 al mes.
Informes y cambios de campaña de Microsoft Ads. Un comando en Claude Code.