Google ya ofrece un servidor MCP oficial y de código abierto para Google Ads. Este artículo explica cómo autenticarte, añadirlo a Claude Desktop o Claude Code, lanzar consultas GAQL en lenguaje natural, evitar las trampas de datos y costos, y convertir los hallazgos en creatividades para anuncios.
Haz una pregunta a tu cuenta de anuncios en lenguaje natural y obtén la respuesta en segundos. Esa es la promesa del servidor MCP de Google Ads, un puente de código abierto de Google que permite a un asistente de IA como Claude leer los datos de tus campañas en tiempo real, en lugar de esperar a exportar otro CSV. Es la vía oficial: Google lo publica en su organización de GitHub googleads bajo la licencia Apache 2.0, y hoy es estrictamente de solo lectura. Puede revisarlo todo, pero no cambiar nada.
Este artículo explica cómo conectar Google Ads a Claude, qué preguntas conviene hacer primero y qué trampas producen cifras incorrectas sin que te des cuenta. Hay un cambio reciente que importa: Google dejó de admitir los tokens de desarrollador el 9 de septiembre de 2026, así que muchos tutoriales antiguos describen un paso de configuración que ya no necesitas. Todo lo que sigue se basa en la documentación actual de Google y en el README del proyecto.
El Model Context Protocol (MCP) es un estándar que permite a un cliente de IA llamar a herramientas expuestas por un programa separado. El servidor de Google envuelve la API de Google Ads en tres de esas herramientas, de modo que Claude puede encontrar tus cuentas, ejecutar consultas y consultar las definiciones de los campos sin que escribas una sola línea de código de integración. El servidor se ejecuta en tu equipo a través de stdio, y Claude se comunica con él igual que con cualquier otro servidor MCP.
Esto es lo que cambia frente a la rutina semanal de exportación que siguen la mayoría de los anunciantes:
| Paso | Rutina de exportación | Con el servidor MCP |
|---|---|---|
| Obtener datos | Crear y descargar informes a mano | Claude ejecuta la consulta |
| Cambiar el rango de fechas | Volver a exportar | Dilo en una frase |
| Hacer una pregunta de seguimiento | Abrir una hoja de cálculo nueva | Pregunta de nuevo en el mismo chat |
| Actualidad de los datos | Lo que contuviera el archivo | Datos de la cuenta en tiempo real |
| Herramienta | Qué devuelve | Cuándo la llama Claude |
|---|---|---|
list_accessible_customers | Los ID de cliente a los que el usuario que ha iniciado sesión tiene acceso directo | Primero, para encontrar la cuenta correcta |
search | Resultados de una consulta en Google Ads Query Language (GAQL): métricas, presupuestos, estado | En cada pregunta real sobre el rendimiento |
get_resource_metadata | La estructura y los campos disponibles de un tipo de recurso | Antes de escribir una consulta con campos que no conoces |
En la práctica nunca escribes la consulta tú. Dices "¿qué campañas gastaron más la semana pasada?", Claude comprueba qué campos existen, construye la consulta GAQL, la ejecuta con search y resume las filas. Aun así puedes leer la consulta que ha ejecutado, y así detectas los errores.
La documentación de Google es clara: la implementación "no puede modificar pujas, pausar campañas ni crear nuevos recursos". Eso descarta:
💡 La solo lectura es una ventaja. Una respuesta equivocada del modelo te cuesta una mala tarde, no un presupuesto agotado, porque no tiene forma de aplicar un cambio en la cuenta.
Tres cosas deben estar listas antes de que el archivo de configuración importe: un proyecto de Google Cloud con el nivel de acceso adecuado, credenciales que funcionen y las herramientas locales para ejecutar el servidor. Si omites cualquiera, aparecerán errores que parecen no tener relación con la causa real.
El ID de tu proyecto de Google Cloud va en la configuración como GOOGLE_PROJECT_ID. Abre la página de descripción general de la API de Google Ads en la consola de Cloud y confirma que el proyecto tiene uno de los tres niveles de acceso que aparecen allí: el nivel de entrada, Basic o Standard. Si no tiene ninguno, solicita uno. Los niveles de acceso ya están vinculados al proyecto de Cloud, y por eso los tokens de desarrollador dejaron de ser necesarios.
La documentación de Google indica que los tokens de desarrollador (GOOGLE_ADS_DEVELOPER_TOKEN) dejaron de admitirse el 9 de septiembre de 2026 y ya no son necesarios en la versión más reciente del servidor. El README de GitHub sigue indicando que esa variable es opcional, así que si fijas una versión anterior quizá todavía necesites definirla. En la versión actual, omítela.
💡 Revisa la fecha de cualquier tutorial. Si te indica que solicites un token de desarrollador y esperes la aprobación, describe el flujo antiguo.
Necesitas una de dos cosas: un par de ID de cliente y secreto de OAuth 2.0 creado en el mismo proyecto, o un conjunto de Application Default Credentials (ADC). El ámbito necesario es https://www.googleapis.com/auth/adwords. ADC mediante la CLI de gcloud es el camino más corto para un solo usuario, y es lo que usan los comandos de abajo.
Ten estos elementos listos antes de continuar:
pipx instalado, la herramienta de Python que ejecuta el servidor directamente desde GitHubgcloud instalada y con sesión iniciadaEjecuta el comando de inicio de sesión con los dos ámbitos que necesita el servidor, apuntando al archivo del cliente OAuth que descargaste:
gcloud auth application-default login \
--scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
--client-id-file=YOUR_CLIENT_JSON_FILE
Se abre una ventana del navegador, apruebas los ámbitos y gcloud escribe un archivo JSON de credenciales. Anota dónde queda, porque esa ruta pasará a ser GOOGLE_APPLICATION_CREDENTIALS. Los equipos que prefieran cuentas de servicio pueden usar --impersonate-service-account=SERVICE_ACCOUNT_EMAIL con los mismos ámbitos.
Abre el archivo de configuración de Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %APPDATA%\Claude\claude_desktop_config.json en Windows. Añade el servidor:
{
"mcpServers": {
"google-ads-mcp": {
"command": "pipx",
"args": [
"run",
"--spec",
"git+https://github.com/googleads/google-ads-mcp.git",
"google-ads-mcp"
],
"env": {
"GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
}
}
}
}
Cierra Claude Desktop por completo y vuelve a abrirlo. El primer inicio descarga el servidor mediante pipx, así que espera una breve pausa. Para configuraciones que quieras repetir, el README sugiere fijar una versión publicada con pipx run --spec "google-ads-mcp==X.Y.Z" google-ads-mcp en lugar de seguir el estado más reciente del repositorio.
Claude Code puede registrar el mismo servidor desde la terminal:
claude mcp add google-ads-mcp \
--env GOOGLE_PROJECT_ID=your-project-id \
--env GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json \
-- pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp
Después, ejecuta /mcp dentro de Claude Code y confirma que google-ads-mcp aparece como conectado.
Haz la pregunta de ejemplo de la documentación de Google: "¿A qué clientes tengo acceso?". Claude debería llamar a list_accessible_customers y devolver los ID y nombres de las cuentas. Si algo falla, esta tabla recoge los motivos más habituales:
| Síntoma | Causa probable | Solución |
|---|---|---|
| No aparece ninguna herramienta | JSON no válido o Claude no se reinició | Valida el JSON, cierra Claude por completo y vuelve a abrirlo |
| Error de permisos o de acceso | El proyecto aún no tiene un nivel de acceso a la API | Revisa la página de descripción general de la API de Google Ads |
| Lista de cuentas vacía | Las credenciales pertenecen a un usuario sin acceso a las cuentas | Repite el inicio de sesión con gcloud con el usuario correcto |
| Errores en cuentas de clientes | Falta el ID de la cuenta de administrador | Define GOOGLE_ADS_LOGIN_CUSTOMER_ID |
Estas son las causas más probables, no un catálogo oficial de errores, así que lee el mensaje real que muestra Claude antes de cambiar nada.
Empieza por localizar tus cuentas. "¿A qué clientes tengo acceso?" te da los ID de cliente de 10 dígitos, sin guiones, que necesitará cada consulta posterior. Indica a Claude una vez en qué ID estás trabajando, y lo reutilizará durante el resto del chat. Después pasa a preguntas que te ahorren tiempo de verdad. Las consultas de abajo muestran lo que Claude suele construir entre bastidores, para que puedas comprobarlo.
La segunda pregunta de ejemplo de Google es "¿Cómo va el rendimiento de mis campañas esta semana?". Una consulta razonable detrás de ella tiene este aspecto:
SELECT
campaign.name,
metrics.cost_micros,
metrics.clicks,
metrics.conversions
FROM campaign
WHERE segments.date DURING LAST_7_DAYS
ORDER BY metrics.cost_micros DESC
LIMIT 10
Fíjate en cost_micros. Google Ads guarda el dinero en micros, así que 12.500.000 significa 12,50 en la moneda de la cuenta. Un modelo que olvide dividir informará de un gasto un millón de veces mayor, así que pídele que convierta el valor y que indique la moneda.
El primer proyecto más útil es una revisión de términos de búsqueda. Esta consulta encuentra los términos que gastaron más de 5 unidades monetarias en 30 días y nunca convirtieron:
SELECT
search_term_view.search_term,
campaign.name,
metrics.clicks,
metrics.cost_micros,
metrics.conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
AND metrics.conversions = 0
AND metrics.cost_micros > 5000000
ORDER BY metrics.cost_micros DESC
LIMIT 25
Devuélvele las filas a Claude y pídele que las agrupe por temas: buscadores de empleo, buscadores de contenido gratuito, producto equivocado, ubicación equivocada. Esos temas se convierten en tu lista de términos negativos, que después añades tú mismo en la interfaz de Google Ads, porque el servidor no puede escribir.
Algunos prompts más que conviene guardar en una nota:
| Objetivo | Prompt que escribir | Recurso probable |
|---|---|---|
| Control del gasto | "¿Qué cinco campañas gastaron más este mes?" | campaign |
| Eficiencia | "Ordena las campañas por costo por conversión en los últimos 30 días" | campaign |
| Ritmo de gasto | "¿Qué campañas están limitadas por el presupuesto?" | campaign, campaign_budget |
| Calidad del anuncio | "Lista los anuncios con la tasa de clics más baja" | ad_group_ad |
💡 Indica siempre el rango de fechas y la moneda. Los prompts vagos dan pie a errores silenciosos. "Últimos 30 días, en euros" es mejor que "recientemente". Luego compara una cifra con la interfaz de Google Ads antes de fiarte del resto.
El README advierte de que el servidor "expondrá tus datos al agente o al LLM que conectes". También indica que se añade un encabezado adicional a tus llamadas a la API, que Google usa para mejorar el producto. Antes de conectar una cuenta de agencia que contenga datos de clientes, revisa tu contrato y la política de tu cliente. Trata la conexión como si enviaras un informe por correo: todo lo que devuelva una consulta llega al modelo.
Una medida de protección sencilla: inicia sesión con un usuario de Google cuyo acceso a la cuenta se limite a lo que necesita el trabajo. El servidor actúa con las credenciales del usuario que se autenticó, así que los permisos de ese usuario se aplican además del diseño de solo lectura del propio servidor.
Si accedes a una cuenta de cliente a través de una cuenta de administrador (MCC), define GOOGLE_ADS_LOGIN_CUSTOMER_ID con el ID de cliente del administrador en el bloque env. Google lo marca como obligatorio en esa situación.
La configuración local descrita arriba usa stdio y sirve para una sola persona. Google también documenta un despliegue en Cloud Run para equipos. Allí, el servidor necesita GOOGLE_ADS_MCP_OAUTH_CLIENT_ID, GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET y FASTMCP_HOST=0.0.0.0, y la configuración del cliente apunta un httpUrl a la ruta /mcp de tu servicio.
Existen muchos servidores MCP de Google Ads creados por la comunidad, y algunos pueden ofrecer acceso de escritura. Revisa los ámbitos y las capacidades antes de apuntar cualquiera de ellos a una cuenta activa.
| Servidor oficial | Servidores comunitarios | |
|---|---|---|
| Editor | Google, en la organización de GitHub googleads | Desarrolladores particulares |
| Acceso de escritura | Ninguno, estrictamente de solo lectura | Varía según el proyecto |
| Autenticación | OAuth o ADC | Varía según el proyecto |
| Licencia | Apache 2.0 | Varía según el proyecto |
El servidor MCP te dice qué corregir. No crea las imágenes. Una vez que Claude te ha mostrado qué temas de búsqueda convierten, todavía necesitas recursos visuales y textos nuevos para ellos, y ahí es donde entra PicassoIA. Nada de lo que se describe aquí conecta PicassoIA con tu cuenta de anuncios, así que trasladas tú mismo los hallazgos.
Supongamos que los datos muestran que "botas de montaña impermeables" convierte a una fracción del costo de "botas baratas". Pide a Claude tres ángulos visuales para el tema ganador: un primer plano de un sendero embarrado, una escena de estilo de vida en un día de lluvia y una bota en el umbral de una puerta. Después genera cada uno. Ajusta la relación de aspecto a la ubicación: 1:1 para los feeds, 16:9 para los banners anchos y 9:16 para el video vertical.
Un prompt que funciona bien para este tipo de concepto publicitario nombra el sujeto, el escenario, la luz y el objetivo, y dice claramente qué evitar:
Primer plano de botas de montaña impermeables embarradas en un sendero húmedo de bosque al amanecer, luz lateral suave, profundidad de campo reducida, objetivo de 50 mm, fotorrealista, sin texto, sin logotipos.
Genera dos o tres versiones, conserva la que encaje con el ángulo que favorecen tus datos y descarta el resto. Mantén un estilo natural: una foto creíble de un momento real encaja mejor en un anuncio de botas de montaña que un render brillante.
| Necesidad | Modelo en PicassoIA | Por qué encaja |
|---|---|---|
| Conceptos publicitarios rápidos | PicassoIA Image | Generaciones ilimitadas, siete relaciones de aspecto de 1:1 a 9:16, control de semilla |
| Retocar una foto existente | PicassoIA Image Editor Pro | Edita una foto de producto en lugar de empezar de cero |
| Anuncios de video cortos | PicassoIA Video | Video a partir de texto o de una imagen |
| Clips más largos | Seedance 2.5 Lite | Clips de hasta 10 segundos |
| Video de mayor resolución | Veo 3.1 | Video en 1080p a partir de texto |
Claude Sonnet 5 en PicassoIA es la mesa de redacción de este flujo de trabajo. No ejecuta el servidor MCP de Google Ads. Pegas lo que devolvió tu sesión MCP y redacta el texto del anuncio. Los pasos:
| Parámetro | Predeterminado | Consejo |
|---|---|---|
| Prompt | Obligatorio | Incluye los datos, el objetivo y el rango de fechas |
| System Prompt | Vacío | Fija el rol y los límites de caracteres una sola vez |
| Effort | low | Súbelo solo para tareas de planificación |
| Max Tokens | 8192 | Suficiente para 15 titulares y 4 descripciones |
| Image | Ninguna | Una captura de un gráfico añade contexto |
| Max Image Resolution | 0,5 megapíxeles | Valores más bajos ahorran tiempo y costo |
Los anuncios adaptables de búsqueda admiten hasta 15 titulares y 4 descripciones, así que una sola ejecución completa un anuncio. ¿Quieres una segunda opinión? Ejecuta el mismo prompt con Gemini 3.5 Flash o Claude Opus 4.7 y compara los borradores lado a lado.
Los datos dicen qué probar. Las imágenes deciden si alguien deja de hacer scroll. Abre PicassoIA Image, pega un prompt para tu tema que más convierte, elige 1:1 o 16:9 y genera todas las variaciones que quieras, ya que el modelo no tiene un límite por imagen. Fija una semilla cuando una composición funcione y cambia solo el texto para probar diferencias pequeñas.
PicassoIA también tiene una conexión MCP propia, así que el mismo Claude que lee tus datos de Google Ads puede pedir imágenes y videos en una sola conversación. Consulta la página de la API de PicassoIA para más detalles y comprueba qué plan incluye el acceso.
Pruébalo esta noche: conecta el servidor MCP de Google Ads, ejecuta la consulta de gasto desperdiciado, elige el tema que mejor convierte y genera cinco variaciones visuales en Picasso IA antes de escribir nada más. La semana que viene, repite la consulta de rendimiento semanal y mira qué versión consiguió los clics.
Elige tu idioma
