Claude e IA
Google Ads MCP: el servidor oficial, cómo instalarlo y sus límites
Google Ads MCP: qué hace el servidor oficial de Google, cómo instalarlo en Claude y Claude Code, por qué solo lee y cuándo te conviene un conector hospedado.
Este artículo también está en: Português · English
Google Ads MCP es un servidor que le da a Claude, o a cualquier cliente MCP, acceso a tu cuenta de Google Ads por la API, para que preguntes en lugar de exportar reportes. Google tiene uno oficial: google-ads-mcp, de código abierto. Trae tres herramientas, es estrictamente de solo lectura y lo hospedas tú, con un proyecto de Google Cloud y credenciales OAuth. Si quieres pegar una dirección en Claude y empezar, o que la IA también pause campañas y agregue palabras clave negativas, necesitas un conector hospedado con escritura. Aquí va qué hace el oficial, cómo se instala y cuándo conviene cada opción.
El panorama de todas las plataformas está en MCP oficiales de plataformas de anuncios. Este artículo se queda en Google Ads, con lo que revisé en la documentación de Google el 28 de octubre de 2026.
Qué hace el servidor oficial de Google Ads
Son tres herramientas y algunos recursos de referencia. Parece poco, pero search hace casi todo el trabajo: corre consultas en GAQL, el lenguaje de consultas de la Google Ads API.
| Herramienta o recurso | Qué hace |
|---|---|
list_accessible_customers | Lista las cuentas a las que el usuario autenticado accede directamente |
search | Corre una consulta GAQL: métricas, presupuestos, estado, todo lo que la API deja leer |
get_resource_metadata | Describe los campos de un tipo de recurso, como "campaign", para que el modelo sepa qué pedir |
| Recursos | Documento de descubrimiento de la API, referencia de métricas y segmentos, notas de versión |
En la práctica, el modelo convierte tu pregunta en GAQL, la corre y te responde. Eso da mucho alcance de lectura: términos de búsqueda, palabras clave, recursos de anuncio, configuración de pujas, lo que la API exponga.
Lo que no hace está escrito en la documentación: la versión actual es estrictamente de solo lectura y no modifica pujas, no pausa campañas ni crea recursos. Para escribir, Google te manda a otra herramienta, el Google Ads API Developer Assistant, que genera código para las bibliotecas cliente. El camino oficial para cambiar algo pasa por código, no por el chat.
Lo que cambió en septiembre de 2026: adiós al token de desarrollador
Si leíste una guía de antes de septiembre, decía que primero había que pedir un token de desarrollador y esperar la aprobación. Ya no. La página del MCP en el sitio de Google dice que los tokens de desarrollador se retiraron el 9 de septiembre de 2026 y no son necesarios en la versión más reciente del servidor. El nivel de acceso a la API ahora sigue al proyecto de Google Cloud que genera tus credenciales.
Se fue el paso más lento, la espera. Los pasos técnicos siguen ahí.
Cómo instalar el servidor oficial
Necesitas un proyecto de Google Cloud, una terminal y una cuenta de Google con acceso a las cuentas publicitarias.
- Instala pipx. El servidor está en Python y corre con
pipx run, sin instalación permanente. - Activa la Google Ads API en tu proyecto de Google Cloud.
- Crea las credenciales. Lo más corto es Application Default Credentials: crea un cliente OAuth en el proyecto, descarga su archivo JSON y corre
gcloud auth application-default logincon el alcancehttps://www.googleapis.com/auth/adwordsy ese archivo. El comando te muestra la ruta del archivo de credenciales que guardó. Anótala. - Configura tu cliente MCP con el comando de pipx apuntando al repositorio,
GOOGLE_APPLICATION_CREDENTIALScon esa ruta yGOOGLE_PROJECT_IDcon tu proyecto. Si entras a las cuentas de tus clientes por una cuenta de administrador (MCC), agregaGOOGLE_ADS_LOGIN_CUSTOMER_ID. - Prueba con una pregunta de lectura, como "lista las cuentas de Google Ads que puedes ver".
En Claude Desktop y en Claude Code
En Claude Desktop, el servidor va en el archivo de configuración de MCP, en Configuración → Desarrollador. En Claude Code es un solo comando, con esta forma: claude mcp add --transport stdio --env GOOGLE_PROJECT_ID=tu-proyecto --env GOOGLE_APPLICATION_CREDENTIALS=ruta-del-json google-ads -- pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp.
¿Y en Claude en el navegador?
Claude en la web no puede lanzar un proceso local, así que tienes que publicar el servidor. El repositorio documenta el despliegue en Google Cloud Run con OAuth, y la guía de Google dice que agregues en Claude un conector personalizado que apunte a la URL de Cloud Run con /mcp al final. Es infraestructura tuya: la aseguras, la monitoreas y la pagas. Google también tiene un piloto de endpoint hospedado, abierto solo a participantes invitados.
Las opciones lado a lado
| Oficial de Google | Conector hospedado (Vazante) | MCP de ETL o servidores de terceros | |
|---|---|---|---|
| Quién lo corre | Tú, local o en tu nube | Vazante | El proveedor, o tú si es un proyecto abierto |
| Instalación | pipx, proyecto de Google Cloud, OAuth | Pegar https://vazante.app/api/mcp y autorizar | Varía |
| Lee | Todo lo que alcanza GAQL | Gasto, impresiones, clics, CTR, CPC, conversiones, valor de conversión y CPA por campaña, cuenta o día; términos de búsqueda | Varía según el proveedor |
| Escribe | No | Sí, con confirmación y tope por acción | Varía; revisa la documentación de cada uno |
| Otras plataformas en la misma respuesta | No | Meta Ads, TikTok Ads, GA4, Search Console | Depende del catálogo |
| Costo | Software gratis, más tu nube si lo publicas | Plan de Vazante, desde MX$ 559,20 al mes en el plan anual en México | El plan de cada proveedor |
ETL como Windsor.ai y Supermetrics tienen su propio MCP, y en GitHub hay varios servidores de la comunidad. Lo que leen y escriben cambia mucho de uno a otro, así que lee la documentación antes de darle acceso a una cuenta de cliente.
Cuándo te alcanza el oficial
Elígelo cuando se cumplen tres cosas: alguien del equipo se mueve bien con terminal y Google Cloud, el trabajo es de lectura (auditoría, reporte, investigar una cuenta) y Google Ads es la única plataforma de la pregunta. Ahí es difícil ganarle: es de Google, sigue la API, no hay intermediario y GAQL llega a campos que ningún conector empaquetado expone.
Deja de alcanzar en tres casos:
- Cuando la respuesta pide una acción. "Pausa esa campaña" o "agrega ese término como negativa" no pasan por él.
- Cuando la decisión cruza plataformas. "¿Dónde salió más barato el lead esta semana, sumando Google, Meta y TikTok?" pide un conector que vea las tres.
- Cuando el equipo no es técnico. Pedirle a un trafficker que cree un cliente OAuth y corra
gcloudes pedirle que no lo use.
Cómo usar Vazante como tu Google Ads MCP
En Vazante entras con tu cuenta de Google, marcas las cuentas de Google Ads que quieres (incluidas las de MCC) y agregas el conector en Claude en Configuración → Conectores → Agregar conector personalizado, con https://vazante.app/api/mcp. Sin clave de API ni proyecto de Google Cloud. En Claude Code: claude mcp add --transport http vazante https://vazante.app/api/mcp y luego /mcp para autorizar. El paso a paso con preguntas listas está en cómo conectar Google Ads a Claude, y la página del conector es conector de Claude.
Límites que ningún Google Ads MCP resuelve
- Una conversión mal configurada sigue mal. El modelo lee lo que la cuenta registra. Si la etiqueta cuenta un clic a WhatsApp como compra, la respuesta sale mal y con toda seguridad.
- La consulta generada puede equivocarse de campo. Con el oficial, el modelo escribe GAQL y a veces pide una métrica que no corresponde al recurso. Para eso está la herramienta de metadatos. Compara las primeras respuestas con la interfaz de Google Ads; los términos de búsqueda son un buen primer cruce.
- Tus datos van al modelo. El propio repositorio de Google advierte que el servidor expone tus datos al agente o modelo que conectes. Vale para cualquier MCP; las preguntas de seguridad están en seguridad de datos con IA.
- Google Ad Manager es otro producto. Si buscaste "Ad Manager" pensando en Google Ads, ojo: Ad Manager es la plataforma de quien vende inventario, con otra API. Ni el oficial ni Vazante la cubren.
Siguiente paso
Si eres técnico y solo necesitas leer, instala el oficial hoy con la lista de arriba y corre una semana de preguntas de auditoría en Claude Code. Si quieres preguntar y actuar, o ver Google junto a Meta y TikTok en una sola respuesta, prueba un conector hospedado, empieza solo preguntando y compara con la interfaz de Google Ads unos días. Si el protocolo es nuevo para ti, empieza por qué es MCP en marketing.
Preguntas frecuentes
¿Existe un MCP oficial de Google Ads?
Sí. Es el proyecto de código abierto googleads/google-ads-mcp, documentado en el sitio de desarrolladores de Google Ads. Lo instalas y lo corres tú, en tu computadora o en tu nube; un endpoint hospedado por Google está en piloto solo para invitados.
¿El MCP de Google Ads puede pausar campañas o cambiar presupuestos?
El oficial, no. Su documentación dice que la versión actual es estrictamente de solo lectura: no modifica pujas, no pausa campañas y no crea recursos. Para actuar desde el chat necesitas un conector con escritura, como Vazante.
¿Necesito token de desarrollador para el MCP de Google Ads?
No en la versión más reciente. Según Google, los tokens de desarrollador se retiraron el 9 de septiembre de 2026 y el nivel de acceso ahora sigue al proyecto de Google Cloud. Sigues necesitando ese proyecto, con la Google Ads API activada, y credenciales OAuth.
¿Cómo conecto Google Ads a Claude Code?
El servidor oficial se agrega como servidor local con claude mcp add, apuntando al comando de pipx y a tus credenciales. Un conector hospedado se agrega con claude mcp add --transport http y su dirección, y luego autorizas con /mcp.
¿Google Ads MCP sirve para Google Ad Manager?
No. Google Ad Manager es la plataforma de quien vende espacio publicitario y tiene su propia API. El servidor oficial y Vazante trabajan con la Google Ads API, la de quien compra anuncios.