Vazante
EntrarEmpezar

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 recursoQué hace
list_accessible_customersLista las cuentas a las que el usuario autenticado accede directamente
searchCorre una consulta GAQL: métricas, presupuestos, estado, todo lo que la API deja leer
get_resource_metadataDescribe los campos de un tipo de recurso, como "campaign", para que el modelo sepa qué pedir
RecursosDocumento 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.

  1. Instala pipx. El servidor está en Python y corre con pipx run, sin instalación permanente.
  2. Activa la Google Ads API en tu proyecto de Google Cloud.
  3. 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 login con el alcance https://www.googleapis.com/auth/adwords y ese archivo. El comando te muestra la ruta del archivo de credenciales que guardó. Anótala.
  4. Configura tu cliente MCP con el comando de pipx apuntando al repositorio, GOOGLE_APPLICATION_CREDENTIALS con esa ruta y GOOGLE_PROJECT_ID con tu proyecto. Si entras a las cuentas de tus clientes por una cuenta de administrador (MCC), agrega GOOGLE_ADS_LOGIN_CUSTOMER_ID.
  5. 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 GoogleConector hospedado (Vazante)MCP de ETL o servidores de terceros
Quién lo correTú, local o en tu nubeVazanteEl proveedor, o tú si es un proyecto abierto
Instalaciónpipx, proyecto de Google Cloud, OAuthPegar https://vazante.app/api/mcp y autorizarVaría
LeeTodo lo que alcanza GAQLGasto, impresiones, clics, CTR, CPC, conversiones, valor de conversión y CPA por campaña, cuenta o día; términos de búsquedaVaría según el proveedor
EscribeNoSí, con confirmación y tope por acciónVaría; revisa la documentación de cada uno
Otras plataformas en la misma respuestaNoMeta Ads, TikTok Ads, GA4, Search ConsoleDepende del catálogo
CostoSoftware gratis, más tu nube si lo publicasPlan de Vazante, desde MX$ 559,20 al mes en el plan anual en MéxicoEl 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 gcloud es 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.

Sigue leyendo