Google Ads, verificado
Servidor MCP de Google · Verificado
Query Google Ads accounts with GAQL and inspect campaign data and performance metrics through the Google Ads API.
Instalar Google Ads
Se ejecuta en tu equipo. Tu cliente lo inicia con este comando:
Requiere pipx (Python) en tu equipo. Los pasos de configuración de abajo muestran dónde va el comando en cada cliente.
GOOGLE_ADS_DEVELOPER_TOKENsecreto opcional Google Ads API developer token.GOOGLE_PROJECT_IDGoogle Cloud project ID (credentials come from ADC or GOOGLE_APPLICATION_CREDENTIALS).
Compartir este servidor
El enlace abre esta página, con el comando de instalación y los pasos de configuración.
mcp.tc/i/google-adsDescripción
Connects to the Google Ads API so an assistant can search account data, run GAQL queries, look up resource metadata and list the customer accounts the signed-in user can access. Resources expose the API discovery document, available metrics and segments, and release notes.
Runs locally over stdio with pipx (pipx run google-ads-mcp). It needs Google credentials (Application Default Credentials or a credentials file) and a Google Cloud project with the Google Ads API enabled and at least Explorer access for production accounts. An optional OAuth proxy mode serves streamable HTTP.
Qué puedes hacer
- Run searches and GAQL queries against Google Ads accounts
- Get metadata and available fields for a Google Ads resource such as campaign
- List customer accounts accessible to the authenticated user
- Read the Google Ads API discovery document, metrics and segments
- Read the latest Google Ads API release notes
- Enable or rename tools through a tools_config.yaml file
Herramientas
Google Ads solo muestra sus herramientas después de iniciar sesión, así que no podemos listarlas aquí. Tu cliente te las mostrará cuando te conectes.
Prompts de ejemplo
List the Google Ads customer accounts I can access
Show clicks, cost and conversions per campaign for the last 30 days
What fields can I query on the ad_group resource?
Which campaigns had the highest cost per conversion last week?
Configuración
Todos los clientes inician Google Ads en tu equipo con el mismo comando. Elige el tuyo; la página recuerda tu elección.
Claude Code
- Ejecútalo en un terminal, en la carpeta de tu proyecto:
claude mcp add --transport stdio google-ads --env "GOOGLE_ADS_DEVELOPER_TOKEN=<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>" --env "GOOGLE_PROJECT_ID=<YOUR_GOOGLE_PROJECT_ID>" -- pipx run google-ads-mcp- Inicia Claude Code y escribe
/mcp. google-ads debería aparecer como conectado.
Añade --scope user para que esté disponible en todos los proyectos. Sustituye los marcadores por tus propios valores.
Claude Desktop
- Abre Settings → Developer → Edit Config. Se abre
claude_desktop_config.json. Añade:
{
"mcpServers": {
"google-ads": {
"command": "pipx",
"args": [
"run",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
}
}
}
}- Guarda el archivo y reinicia Claude Desktop. Sustituye los marcadores por tus propios valores.
Necesita pipx (Python) en tu equipo. El archivo está en ~/Library/Application Support/Claude/ en macOS y en %APPDATA%\Claude\ en Windows.
Cursor
Añadir a Cursor (se abre en una pestaña nueva)
O añádelo a mano en ~/.cursor/mcp.json (todos los proyectos) o en .cursor/mcp.json (este proyecto):
{
"mcpServers": {
"google-ads": {
"command": "pipx",
"args": [
"run",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
}
}
}
}Necesita pipx (Python) en tu equipo. Sustituye los marcadores por tus propios valores.
VS Code
Añádelo a .vscode/mcp.json. VS Code pide el secreto la primera vez y lo guarda de forma segura:
{
"servers": {
"google-ads": {
"type": "stdio",
"command": "pipx",
"args": [
"run",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "${input:google-ads-developer-token}",
"GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "google-ads-developer-token",
"description": "GOOGLE_ADS_DEVELOPER_TOKEN",
"password": true
}
]
}Necesita pipx (Python) en tu equipo.
Devin Desktop
- Añádelo a
~/.config/devin/mcp_config.json(macOS y Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"google-ads": {
"command": "pipx",
"args": [
"run",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
}
}
}
}- Actualiza la lista de servidores MCP en Cascade. Sustituye los marcadores por tus propios valores.
Devin Desktop es el nuevo nombre de Windsurf.
Codex
codex mcp add google-ads --env "GOOGLE_ADS_DEVELOPER_TOKEN=<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>" --env "GOOGLE_PROJECT_ID=<YOUR_GOOGLE_PROJECT_ID>" -- pipx run google-ads-mcpO edita directamente ~/.codex/config.toml:
[mcp_servers.google-ads]
command = "pipx"
args = ["run", "google-ads-mcp"]
env = { GOOGLE_ADS_DEVELOPER_TOKEN = "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>", GOOGLE_PROJECT_ID = "<YOUR_GOOGLE_PROJECT_ID>" }Necesita pipx (Python) en tu equipo. Sustituye los marcadores por tus propios valores.
Gemini CLI
gemini mcp add -e "GOOGLE_ADS_DEVELOPER_TOKEN=<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>" -e "GOOGLE_PROJECT_ID=<YOUR_GOOGLE_PROJECT_ID>" google-ads pipx run google-ads-mcpAsí lo añades al proyecto actual. Añade -s user para usarlo en todas partes.
Cualquier cliente
La mayoría de los clientes que inician servidores locales aceptan esta forma:
{
"mcpServers": {
"google-ads": {
"command": "pipx",
"args": [
"run",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
}
}
}
}Zed pone los servidores bajo context_servers en sus ajustes, con los mismos campos command, args y env.
Necesita pipx (Python) en tu equipo. Sustituye los marcadores por tus propios valores.
Insertar
Muestra Google Ads en un README o en tu web. Cada inserción enlaza a esta página, usa el comando de instalación del servidor y no instala cookies. Cómo funcionan las inserciones
La tarjeta, el iframe y el JSON están en inglés. Añade ?lang=it, fr, de o es a su dirección para otro idioma.
Insignia para README
[](https://mcp.tc/i/google-ads)<a href="https://mcp.tc/i/google-ads"><img src="https://mcp.tc/i/google-ads/badge.svg" alt="Google Ads on mcp.tc" height="20"></a>Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.
Tarjeta para web
<script src="https://mcp.tc/w/google-ads.js" async></script>La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.
iframe
<iframe src="https://mcp.tc/embed/google-ads" title="Google Ads on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.
JSON
La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).
https://mcp.tc/i/google-ads.jsonPrompt para la IA
Pégalo en un asistente de programación con IA, como Claude Code o Cursor, y añadirá la tarjeta de Google Ads a tu web.
Añade a mi web la tarjeta de mcp.tc de Google Ads, un servidor MCP. Es un solo script estático: sin paso de build, sin paquetes que instalar, sin cookies.
Pon esta etiqueta donde deba aparecer la tarjeta. La tarjeta se muestra justo antes de ella:
```html
<script src="https://mcp.tc/w/google-ads.js" async></script>
```
Para mostrarla en otro sitio, pon allí este marcador y carga el mismo script una sola vez, por ejemplo antes de `</body>`. Deja el enlace dentro: lo ven los visitantes sin JavaScript.
```html
<div data-mcptc="google-ads"><a href="https://mcp.tc/i/google-ads">Google Ads on mcp.tc</a></div>
```
Opciones:
- `data-theme="light"` o `"dark"` en la etiqueta o el marcador fija los colores. Sin él, la tarjeta sigue el modo claro u oscuro del visitante.
- `data-size="compact"` da una tarjeta más pequeña, sin el eslogan.
- La variable CSS `--mcptc-max-width` en el marcador o en un elemento padre fija el ancho (por defecto `520px`).
- `?lang=` en la URL del script fija el idioma de la tarjeta: `en`, `it`, `fr`, `de` o `es`.
Si el sitio tiene una Content Security Policy, permite `script-src https://mcp.tc` e `img-src data:` (el icono va incrustado).
Para un README u otra documentación en Markdown, usa la insignia:
```markdown
[](https://mcp.tc/i/google-ads)
```
Referencia: https://mcp.tc/es/embedHistorial de cambios
Este servidor se ejecuta en tu ordenador, así que seguimos su paquete de PyPI: cada versión nueva aparece aquí, junto con las ediciones de su responsable.
Preguntas frecuentes
¿Puedo pegar mcp.tc/i/google-ads en mi cliente MCP?
No. Google Ads se ejecuta en tu propio equipo, iniciado por tu cliente, así que no tiene una dirección web a la que conectarse. El enlace rápido es la página para compartir; el comando de instalación es pipx run google-ads-mcp.
¿Google Ads necesita una clave de API?
Sí. Lee GOOGLE_ADS_DEVELOPER_TOKEN y GOOGLE_PROJECT_ID de su entorno, y GOOGLE_ADS_DEVELOPER_TOKEN es un secreto. Pon el valor en la configuración de tu cliente en tu propio equipo, nunca en un archivo compartido.
¿Google Ads es un servidor remoto o local?
Local. Tu cliente lo inicia como un proceso en tu equipo con pipx run google-ads-mcp, que necesita pipx (Python).
¿Qué clientes pueden usarlo?
Cualquier cliente que inicie servidores locales: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed y otros. claude.ai y ChatGPT solo se conectan a servidores remotos.
¿mcp.tc sigue los cambios de Google Ads?
En parte. Se ejecuta en tu ordenador, así que seguimos su paquete de PyPI: su pestaña Historial muestra cada versión nueva y las ediciones de su responsable. Sigue la ficha para recibir un correo cuando cambie.
¿Quién escribió esta página?
El robot de mcp.tc leyó los metadatos públicos de Google Ads (las páginas de su paquete y de su repositorio), y un modelo de IA redactó el texto a partir de ellos. Una persona revisa todo lo que las comprobaciones no pueden confirmar. Aun así, el texto puede contener errores, así que si encuentras uno, usa Reportar esta ficha en esta página.
mcp.tc no tiene relación con Google. Esta página se creó a partir de los metadatos públicos de Google Ads, comprobados por última vez el 3 oct 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha.