Google Ads en Claude Code, un comando
Claude Code
Para conectar Google 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 llega a tus cuentas de Google Ads con 158 herramientas: auditorías, términos de búsqueda, palabras clave, presupuestos, pujas y campañas. Claude Code pregunta antes de cada herramienta, y la mayoría de las escrituras en Google Ads se simulan antes.
Un comando. Login OAuth, sin claves. Plan gratis, 100 tareas al mes, valor $50, sin tarjeta.
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á leer y cambiar tus cuentas de Google Ads.
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 correo. El plan gratuito son 100 tareas al mes a $0, sin tarjeta.
2Conecta Google Ads en el panel de PaidSync
Haz clic en Conectar en Google Ads e inicia sesión con la cuenta de Google que llega a tus cuentas publicitarias. Google Ads se autoriza con Google OAuth. PaidSync guarda los tokens cifrados en reposo con AES-256-GCM y nunca ve tu contraseña de Google.
¿Ya estás dentro de Claude Code? Pídele que ejecute connect_google_ads. La herramienta devuelve un enlace OAuth para abrir en tu navegador.
3Elige las cuentas que debe ver Claude Code
Tras iniciar sesión, PaidSync lista las cuentas de Google Ads a las que llega ese acceso. Marca las que pertenecen a este espacio de trabajo. Dentro de una sesión, list_accounts las muestra y set_active_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 el rendimiento de Google Ads de los últimos 7 días por campaña”
Claude Code devuelve impresiones, clics, coste y conversiones de cada campaña de la cuenta activa. La conexión está activa.
El plan gratuito incluye 100 tareas al mes. Pro desde $99 al mes, Team desde $249.
Prompts Google Ads en Claude Code
Cada prompt de abajo corresponde a herramientas del grupo Google Ads de PaidSync. Claude Code elige la herramienta. La última columna indica si la llamada puede cambiar algo en la cuenta.
| Petición | Herramientas que llama | Cambia tu cuenta |
|---|---|---|
| “Audita la cuenta y enumera las cinco correcciones con más gasto detrás” | run_account_audit | No |
| “Muestra el rendimiento de las campañas de los últimos 30 días ordenado por coste, con conversiones” | get_campaign_performance | No |
| “Qué términos de búsqueda gastaron dinero este mes sin ninguna conversión” | get_search_terms_report, get_wasted_spend_report | No |
| “Divide los términos de búsqueda de los últimos 30 días en n-gramas y sugiere negativas” | analyze_search_term_ngrams | No |
| “Añade esos cinco términos como negativas de concordancia de frase en la campaña Brand” | add_negative_keywords | Sí, después de que confirmes |
| “Reduce un 20 por ciento el presupuesto diario de la campaña Generic” | update_campaign_budget | Sí, después de que confirmes |
| “Pausa todas las campañas que gastaron dinero la semana pasada sin conversiones” | get_campaign_performance, pause_campaign | Sí, después de que confirmes |
| “Crea una campaña de Búsqueda en pausa para la nueva línea de producto” | create_search_campaign | 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 7 days Google Ads performance by campaign and flag any campaign that spent money with zero conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/google-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 158 herramientas de Google Ads, 64 solo leen y 94 pueden escribir.
Leer más
Las lecturas cubren rendimiento, palabras clave, términos de búsqueda, Quality Score, información de subastas, ritmo de presupuesto e historial de cambios, mediante herramientas como get_keyword_performance, get_quality_score_report, get_auction_insights, get_budget_pacing y get_change_history.
Las escrituras cubren presupuestos, pujas, palabras clave, negativas, anuncios, extensiones, audiencias y creación de campañas. Las herramientas de creación de Google Ads y la mayoría de las demás escrituras muestran una vista previa por defecto con dry_run, así que la primera llamada muestra el cambio y una segunda lo aplica.
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.
Límites a conocer
create_search_campaigncrea una campaña solo de Búsqueda en estado pausado. Los socios de búsqueda y la Red de Display empiezan desactivados, la segmentación geográfica es solo por presencia, y la puja es CPC manual salvo que nombres otra estrategia.- Un cambio de presupuesto de más del 50 por ciento necesita
confirm_large_changeademás deconfirm_destructive. Esa protección evita un presupuesto multiplicado por 10 por error o un presupuesto fijado en cero. remove_campaignes permanente en Google Ads. Una campaña eliminada no se puede volver a activar. Usapause_campaigncuando solo quieras detener la entrega.La auditoría de la cuenta cubre los últimos 30 días y analiza la porción superior de cada dimensión por coste, así que las puntuaciones reflejan adónde va el dinero y no cada palabra clave.
El informe de palabras clave devuelve las 100 principales y el informe de Quality Score las 200 principales.
Preguntas frecuentes
Cómo conectar Google Ads a Claude Code
Regístrate en paidsync.ai, conecta Google Ads con Google OAuth en el panel y luego 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 cuenta de PaidSync.
¿Puede Claude Code cambiar mis campañas de Google Ads?
Sí. Claude Code puede añadir negativas, cambiar presupuestos, pausar y activar campañas, y crear campañas de Búsqueda en pausa. Claude Code pregunta antes de ejecutar cada herramienta, salvo que lo hayas permitido. La mayoría de las escrituras se previsualizan primero como simulación, y las eliminaciones, pausas y cambios de presupuesto necesitan una confirmación explícita.
¿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.
¿Necesito un token de desarrollador de Google Ads?
No. PaidSync es un servidor alojado en https://mcp.paidsync.ai/mcp. Inicias sesión en Google Ads mediante Google OAuth en el panel de PaidSync y en PaidSync mediante /mcp en Claude Code.
Es gratis
Sí. El plan gratuito cuesta $0 por 100 tareas al mes y sin tarjeta. Pro empieza en $99 al mes y Team en $249 al mes. Claude Code en sí necesita un plan de Anthropic que lo incluya.
158 tools Google Ads. Un comando en Claude Code.