Google Ads MCP

Gestiona campañas de Google Ads y sus informes utilizando la API de Google Ads.

GitHub
709
Prueba este MCPPatrocinado

Documentación

MseeP.ai Security Assessment Badge

Google Ads MCP

Google Ads MCP

Una herramienta que conecta Google Ads con Claude AI, permitiéndote analizar tus datos publicitarios mediante conversaciones en lenguaje natural. Esta integración te brinda acceso a información de campañas, métricas de rendimiento, análisis de palabras clave y gestión de anuncios, todo a través de conversaciones simples con Claude.

¿Qué Puede Hacer Esta Herramienta por los Profesionales de Publicidad?

  1. Gestión de Cuentas

    • Ver todas tus cuentas de Google Ads en un solo lugar
    • Obtener detalles de la cuenta e información básica de campañas

  2. Analítica y Reportes de Campañas

    • Descubrir qué campañas están rindiendo mejor
    • Rastrear impresiones, clics, conversiones y métricas de costo
    • Analizar tendencias de rendimiento a lo largo del tiempo
    • Comparar diferentes períodos para detectar cambios
    • Visualiza tus datos con gráficos y tablas creados por Claude

  3. Rendimiento de Palabras Clave y Anuncios

    • Identificar palabras clave de alto y bajo rendimiento
    • Analizar la efectividad del texto de los anuncios
    • Verificar puntuaciones de calidad y métricas competitivas
    • Obtener información práctica sobre cómo mejorar tus campañas

  4. Gestión de Presupuestos y Pujas

    • Monitorear presupuestos y gastos de campañas
    • Analizar estrategias de puja y su rendimiento
    • Identificar oportunidades de optimización
    • Recibir recomendaciones para la asignación de presupuestos

Flujo de Arquitectura de Google Ads MCP

flowchart TB
    User(User) -->|Interacts with| Claude
    Claude(Claude AI Assistant) -->|Makes requests to| MCP[Google Ads MCP Server]
    User -->|Can also use| Cursor[Cursor AI Code Editor]
    Cursor -->|Makes requests to| MCP
    
    subgraph "MCP Server"
        FastMCP[FastMCP Server] 
        Tools[Available Tools]
        Auth[Authentication]
        
        FastMCP -->|Exposes| Tools
        FastMCP -->|Uses| Auth
    end
    
    subgraph "Google Ads Tools"
        ListAccounts[list_accounts]
        ExecuteGAQL[execute_gaql_query]
        CampaignPerf[get_campaign_performance]
        AdPerf[get_ad_performance]
        RunGAQL[run_gaql]
    end
    
    Tools -->|Includes| ListAccounts
    Tools -->|Includes| ExecuteGAQL
    Tools -->|Includes| CampaignPerf
    Tools -->|Includes| AdPerf
    Tools -->|Includes| RunGAQL
    
    subgraph "Authentication"
        OAuth[OAuth 2.0 Client ID]
        ServiceAccount[Service Account]
        Credentials[Google Ads API Credentials]
        
        OAuth -->|Provides| Credentials
        ServiceAccount -->|Provides| Credentials
    end
    
    MCP -->|Communicates with| GoogleAdsAPI[Google Ads API]
    GoogleAdsAPI -->|Returns| AdData[Advertising Data]
    AdData -->|Analyzed by| Claude
    AdData -->|Visualized by| Claude
    AdData -->|Can be used by| Cursor
    
    Credentials -->|Authorizes| GoogleAdsAPI
    
    subgraph "Configuration"
        EnvVars[Environment Variables]
        ConfigFiles[Configuration Files]
        
        EnvVars -->|Configures| MCP
        ConfigFiles -->|Configures| Claude
        ConfigFiles -->|Configures| Cursor
    end

Herramientas Disponibles

Esto es lo que puedes pedirle a Claude que haga una vez que hayas configurado esta integración:

Lo Que Puedes SolicitarLo Que HaceLo Que Necesitarás Proporcionar
list_accountsMuestra todas tus cuentas de Google Ads¡Nada, solo pregunta!
execute_gaql_queryEjecuta una consulta de Google Ads Query LanguageTu ID de cuenta y una consulta GAQL
get_campaign_performanceMuestra métricas de campaña con datos de rendimientoTu ID de cuenta y el período de tiempo
get_ad_performanceAnálisis detallado del rendimiento de tus creatividades publicitariasTu ID de cuenta y el período de tiempo
run_gaqlEjecuta cualquier consulta GAQL con opciones de formatoTu ID de cuenta, consulta y formato (tabla, JSON o CSV)

Uso de las Herramientas de Consulta Avanzada

La herramienta run_gaql es especialmente potente, ya que te permite ejecutar cualquier consulta personalizada de Google Ads Query Language (GAQL). Aquí tienes algunos ejemplos de consultas que puedes usar:

Ejemplo 1: Métricas básicas de campaña

SELECT 
    campaign.name, 
    metrics.clicks, 
    metrics.impressions 
FROM campaign 
WHERE segments.date DURING LAST_7DAYS

Ejemplo 2: Rendimiento de grupos de anuncios

SELECT 
    ad_group.name, 
    metrics.conversions, 
    metrics.cost_micros 
FROM ad_group 
WHERE metrics.clicks > 100

Ejemplo 3: Análisis de palabras clave

SELECT 
    keyword.text, 
    metrics.average_position, 
    metrics.ctr 
FROM keyword_view 
ORDER BY metrics.impressions DESC

Para obtener una lista completa de todas las herramientas disponibles y sus descripciones detalladas, pídele a Claude que "liste las herramientas" después de la configuración.

Primeros Pasos (¡No se Requiere Experiencia en Programación!)

1. Configurar el Acceso a la API de Google Ads

Antes de usar esta herramienta, necesitarás crear credenciales de API que permitan a Claude acceder a tus datos de Google Ads. Puedes elegir entre dos métodos de autenticación:

Opción A: ID de Cliente OAuth 2.0 (Autenticación de Usuario)

Ideal para usuarios individuales o aplicaciones de escritorio:

  1. Ve a la Consola de Google Cloud
  2. Crea un nuevo proyecto o selecciona uno existente
  3. Habilita la API de Google Ads
  4. Ve a "Credenciales" → "Crear Credenciales" → "ID de Cliente OAuth"
  5. Elige "Aplicación de Escritorio" como tipo de aplicación
  6. Descarga el archivo de configuración del cliente OAuth (client_secret.json)
  7. Crea un token de desarrollador de la API de Google Ads (ver más abajo)

Opción B: Cuenta de Servicio (Autenticación Servidor a Servidor)

Mejor para sistemas automatizados o gestión de múltiples cuentas:

  1. Ve a la Consola de Google Cloud
  2. Crea un nuevo proyecto o selecciona uno existente
  3. Habilita la API de Google Ads
  4. Ve a "Credenciales" → "Crear Credenciales" → "Cuenta de Servicio"
  5. Descarga el archivo de clave de la cuenta de servicio (JSON)
  6. Otorga a la cuenta de servicio acceso a tus cuentas de Google Ads
  7. Crea un token de desarrollador de la API de Google Ads (ver más abajo)

Actualización de Tokens de Autenticación

La aplicación ahora incluye un manejo robusto de actualización de tokens:

  • Tokens OAuth 2.0: La herramienta actualizará automáticamente los tokens OAuth caducados cuando sea posible, o solicitará una nueva autenticación si el token de actualización no es válido.
  • Tokens de Cuenta de Servicio: Los tokens de cuenta de servicio se generan y actualizan automáticamente según sea necesario, sin intervención del usuario.

Comparación de Métodos de Autenticación

Elige el ID de Cliente OAuth 2.0 si:

  • Estás creando una aplicación de escritorio
  • Los usuarios necesitan otorgar acceso explícitamente
  • Estás gestionando una sola cuenta o unas pocas cuentas personales
  • Quieres que los usuarios tengan control sobre los permisos de acceso

Elige la Cuenta de Servicio si:

  • Estás creando un sistema automatizado
  • Necesitas autenticación servidor a servidor
  • Estás gestionando múltiples cuentas programáticamente
  • No quieres/necesitas interacción del usuario para la autenticación
  • Necesitas actualización automática de tokens sin intervención del usuario

Obtención de un Token de Desarrollador

  1. Inicia sesión en tu cuenta de Google Ads en https://ads.google.com
  2. Haz clic en Herramientas y Configuración (icono de llave inglesa) en la navegación superior
  3. En "Configuración", haz clic en "Centro de API"
  4. Si aún no lo has hecho, acepta los Términos de Servicio
  5. Haz clic en "Solicitar token"
  6. Completa el formulario de solicitud con detalles sobre cómo planeas usar la API
  7. Envía la solicitud y espera la aprobación (generalmente de 1 a 3 días hábiles)

Nota: Inicialmente, recibirás un Token de Desarrollador de prueba que tiene algunas limitaciones. Una vez que hayas probado tu implementación, puedes solicitar un token de producción que elimina estas restricciones.

Comprensión del ID de Cliente de Inicio de Sesión

El GOOGLE_ADS_LOGIN_CUSTOMER_ID es opcional y se utiliza principalmente cuando:

  • Estás trabajando con una Cuenta de Administrador de Google Ads (MCC)
  • Necesitas acceder a múltiples cuentas de cliente bajo esa cuenta de administrador

El ID de Cliente de Inicio de Sesión debe ser tu ID de Cuenta de Administrador (formato: XXX-XXX-XXXX) si:

  • Estás accediendo a múltiples cuentas bajo una cuenta de administrador
  • Quieres usar las credenciales de la cuenta de administrador para acceder a cuentas de cliente

Puedes omitir esta configuración si:

  • Solo estás accediendo a una única cuenta de Google Ads
  • Estás usando credenciales directamente de la cuenta a la que quieres acceder

Para encontrar tu ID de Cuenta de Administrador:

  1. Inicia sesión en tu Cuenta de Administrador de Google Ads
  2. Haz clic en el icono de configuración (engranaje)
  3. Tu ID de Cuenta de Administrador se mostrará en el formato XXX-XXX-XXXX
  4. Descarga el archivo de credenciales (un archivo JSON)

🎬 Mira este tutorial para principiantes en Youtube: PRÓXIMAMENTE

2. Instalar el Software Requerido

Necesitarás instalar estas herramientas en tu computadora:

  • Python (versión 3.11 o más reciente) - Esto ejecuta la conexión entre Google Ads y Claude
  • Node.js - Requerido para ejecutar el inspector de MCP y ciertos componentes de MCP
  • Claude Desktop - El asistente de IA con el que conversarás

Asegúrate de que tanto Python como Node.js estén correctamente instalados y disponibles en la ruta de tu sistema antes de continuar.

3. Descargar Google Ads MCP

Necesitas descargar esta herramienta a tu computadora. La forma más fácil es:

  1. Haz clic en el botón verde "Code" en la parte superior de esta página
  2. Selecciona "Download ZIP"
  3. Descomprime el archivo descargado en una ubicación que puedas encontrar fácilmente (como tu carpeta de Documentos)

Alternativamente, si estás familiarizado con Git:

git clone https://github.com/ixigo/mcp-google-ads.git

4. Instalar los Componentes Requeridos

Abre la Terminal (Mac) o el Símbolo del Sistema (Windows) de tu computadora:

  1. Navega a la carpeta donde descomprimiste los archivos:

    # Example (replace with your actual path):
cd ~/Documents/mcp-google-ads-main

  2. Crea un entorno virtual (esto mantiene las dependencias del proyecto aisladas):

    # Using uv (recommended):
uv venv .venv

# If uv is not installed, install it first:
pip install uv
# Then create the virtual environment:
uv venv .venv

# OR using standard Python:
python -m venv .venv

    Nota: Si recibes un error de "pip not found" al intentar instalar uv, consulta la sección "Si recibes el error 'pip not found'" a continuación.

  3. Activa el entorno virtual:

    # On Mac/Linux:
source .venv/bin/activate

# On Windows:
.venv\Scripts\activate

  4. Instala las dependencias requeridas:

    # Using uv:
uv pip install -r requirements.txt

# OR using standard pip:
pip install -r requirements.txt

# If you encounter any issues with the MCP package, install it separately:
pip install mcp

    Si recibes el error "pip not found":

    # First ensure pip is installed and updated:
python3 -m ensurepip --upgrade
python3 -m pip install --upgrade pip

# Then try installing the requirements again:
python3 -m pip install -r requirements.txt

# Or to install uv:
python3 -m pip install uv

Cuando veas (.venv) al inicio de tu símbolo del sistema, significa que el entorno virtual está activo y las dependencias se instalarán allí sin afectar la instalación de Python de tu sistema.

5. Configuración del Entorno

Google Ads MCP ahora admite la configuración mediante archivos de entorno para una configuración más fácil.

Uso del Archivo .env (Recomendado)

  1. Copia el archivo .env.example a .env en tu directorio de proyecto:

    cp .env.example .env

  2. Edita el archivo .env con tus valores de configuración reales:

    # Edit the .env file with your favorite text editor
# For Mac:
nano .env

# For Windows:
notepad .env

  3. Establece los siguientes valores en tu archivo .env:

    # Authentication Type: "oauth" or "service_account"
GOOGLE_ADS_AUTH_TYPE=oauth

# Path to your credentials file (OAuth client secret or service account key)
GOOGLE_ADS_CREDENTIALS_PATH=/path/to/your/credentials.json

# Your Google Ads Developer Token
GOOGLE_ADS_DEVELOPER_TOKEN=your_developer_token_here

# Optional: Manager Account ID (if applicable)
GOOGLE_ADS_LOGIN_CUSTOMER_ID=your_manager_account_id

  4. Guarda el archivo.

La aplicación cargará automáticamente estos valores desde el archivo .env cuando se inicie.

Uso de Variables de Entorno Directas

También puedes establecer variables de entorno directamente en tu sistema o en los archivos de configuración de Claude o Cursor:

Para Claude Desktop
{
  "mcpServers": {
    "googleAdsServer": {
      "command": "/FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python",
      "args": ["/FULL/PATH/TO/mcp-google-ads-main/google_ads_server.py"],
      "env": {
        "GOOGLE_ADS_AUTH_TYPE": "oauth",
        "GOOGLE_ADS_CREDENTIALS_PATH": "/FULL/PATH/TO/mcp-google-ads-main/credentials.json",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN_HERE",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID_HERE"
      }
    }
  }
}
Para Cursor
{
  "mcpServers": {
    "googleAdsServer": {
      "command": "/FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python",
      "args": ["/FULL/PATH/TO/mcp-google-ads-main/google_ads_server.py"],
      "env": {
        "GOOGLE_ADS_AUTH_TYPE": "oauth",
        "GOOGLE_ADS_CREDENTIALS_PATH": "/FULL/PATH/TO/mcp-google-ads-main/credentials.json",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN_HERE",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID_HERE"
      }
    }
  }
}

6. Conectar Claude a Google Ads

  1. Descarga e instala Claude Desktop si aún no lo has hecho
  2. Asegúrate de tener tu archivo de credenciales de cuenta de servicio de Google guardado en algún lugar de tu computadora
  3. Abre la Terminal (Mac) o el Símbolo del Sistema (Windows) de tu computadora y escribe:
# For Mac users:
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

# For Windows users:
notepad %APPDATA%\Claude\claude_desktop_config.json

Agrega el siguiente texto (esto le indica a Claude cómo conectarse a Google Ads):

{
  "mcpServers": {
    "googleAdsServer": {
      "command": "/FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python",
      "args": ["/FULL/PATH/TO/mcp-google-ads-main/google_ads_server.py"],
      "env": {
        "GOOGLE_ADS_CREDENTIALS_PATH": "/FULL/PATH/TO/mcp-google-ads-main/service_account_credentials.json",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN_HERE",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID_HERE"
      }
    }
  }
}

Importante: Reemplaza todas las rutas y valores con la información real de tu cuenta:

  • La primera ruta debe apuntar al ejecutable de Python dentro de tu entorno virtual
  • La segunda ruta debe apuntar al archivo google_ads_server.py dentro de la carpeta que descomprimiste
  • La tercera ruta debe apuntar a tu archivo JSON de credenciales de cuenta de servicio de Google
  • Agrega tu Token de Desarrollador de Google Ads
  • Agrega tu ID de Cuenta de Administrador de Google Ads (si corresponde)

Ejemplos:

  • Mac:
    • Ruta de Python: /Users/ernesto/Documents/mcp-google-ads/.venv/bin/python
    • Ruta del script: /Users/ernesto/Documents/mcp-google-ads/google_ads_server.py
  • Windows:
    • Ruta de Python: C:\\Users\\ernesto\\Documents\\mcp-google-ads\\.venv\\Scripts\\python.exe
    • Ruta del script: C:\\Users\\ernesto\\Documents\\mcp-google-ads\\google_ads_server.py

  1. Guarda el archivo:

    • Mac: Presiona Ctrl+O, luego Enter, luego Ctrl+X para salir
    • Windows: Haz clic en Archivo > Guardar, luego cierra el Bloc de Notas

  2. Reinicia Claude Desktop

  3. Cuando Claude se abra, ahora deberías ver las herramientas de Google Ads disponibles en la sección de herramientas

5a. Conectar a Cursor (Editor de Código con IA)

Cursor es un editor de código impulsado por IA que se puede mejorar con herramientas MCP. Puedes integrar esta herramienta Google Ads MCP con Cursor para analizar datos publicitarios directamente dentro de tu entorno de codificación.

Configuración de la Integración con Cursor

  1. Si aún no lo has hecho, descarga e instala Cursor

  2. Crea un archivo de configuración MCP de Cursor:

    Para configuración específica del proyecto: Crea un archivo .cursor/mcp.json en tu directorio de proyecto.

    Para configuración global (disponible en todos los proyectos): Crea un archivo ~/.cursor/mcp.json en tu directorio de inicio.

  3. Agrega la siguiente configuración a tu archivo de configuración MCP:

    {
  "mcpServers": {
    "googleAdsServer": {
      "command": "/FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python",
      "args": ["/FULL/PATH/TO/mcp-google-ads-main/google_ads_server.py"],
      "env": {
        "GOOGLE_ADS_CREDENTIALS_PATH": "/FULL/PATH/TO/mcp-google-ads-main/service_account_credentials.json",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN_HERE",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID_HERE"
      }
    }
  }
}

    Importante: Reemplaza todas las rutas y valores con la información real de tu cuenta, igual que en la configuración de Claude Desktop.

  4. Reinicia Cursor o recarga el espacio de trabajo para aplicar la nueva configuración.

  5. Google Ads MCP ahora aparecerá en la sección "Herramientas Disponibles" de Cursor y podrá ser utilizado por el agente de IA de Cursor cuando sea necesario.

Uso de Google Ads MCP en Cursor

Cuando trabajes en Cursor, puedes pedirle al agente de IA que use las herramientas de Google Ads directamente. Por ejemplo:

  • "Usa Google Ads MCP para listar todas mis cuentas y muéstrame cuáles tienen el mayor gasto."
  • "¿Puedes analizar el rendimiento de mis campañas de los últimos 30 días usando Google Ads MCP?"
  • "Ejecuta una consulta GAQL para encontrar mis palabras clave con mayor conversión usando las herramientas de Google Ads." Cursor te pedirá que apruebes el uso de la herramienta (a menos que hayas activado el modo Yolo) y luego mostrará los resultados directamente en la interfaz de chat.

Funciones específicas de Cursor

Al usar Google Ads MCP con Cursor, puedes:

  1. Combinar código y análisis de anuncios: Pídele a Cursor que analice tu código relacionado con marketing junto con los datos reales de rendimiento de campañas.
  2. Generar visualizaciones de datos: Solicita gráficos y visualizaciones del rendimiento de tus anuncios directamente en tu entorno de desarrollo.
  3. Implementar recomendaciones: Deja que Cursor sugiera mejoras de código basadas en tus datos publicitarios reales.

Esta integración es especialmente valiosa para desarrolladores que trabajan en automatización de marketing, paneles de análisis o aplicaciones de comercio electrónico donde el rendimiento de los anuncios afecta directamente las decisiones de código.

6. ¡Empieza a analizar tus datos publicitarios!

Ahora puedes hacer preguntas a Claude sobre tus datos de Google Ads. Claude no solo puede recuperar los datos, sino también analizarlos, explicar tendencias y crear visualizaciones para ayudarte a comprender mejor el rendimiento de tu publicidad.

Aquí tienes algunos ejemplos de prompts que puedes usar con cada herramienta:

Nombre de la herramientaEjemplo de prompt
list_accounts"Lista todas mis cuentas de Google Ads y dime cuáles tienen el mayor gasto este mes."
execute_gaql_query"Ejecuta esta consulta para la cuenta 123-456-7890: SELECT campaign.name, metrics.clicks FROM campaign WHERE metrics.impressions > 1000"
get_campaign_performance"Muéstrame las 10 mejores campañas para la cuenta 123-456-7890 en los últimos 30 días, resalta las que tengan un ROAS inferior a 2 y sugiere estrategias de optimización."
get_ad_performance"Haz un análisis exhaustivo de qué elementos de los textos de anuncios están generando el mejor CTR en mis campañas de búsqueda y dame recomendaciones accionables."
run_gaql"Ejecuta esta consulta y formatéala como CSV: SELECT ad_group.name, metrics.clicks, metrics.conversions FROM ad_group WHERE campaign.name LIKE '%Brand%'"

También puedes pedirle a Claude que combine varias herramientas y analice los resultados. Por ejemplo:

  • "Encuentra mis 20 palabras clave con mayor conversión, verifica sus puntuaciones de calidad y cuota de impresiones, y crea un informe que destaque las oportunidades de escalado."

  • "Analiza la tendencia de rendimiento de mi cuenta en los últimos 90 días, identifica mis campañas de crecimiento más rápido y comprueba si hay limitaciones de presupuesto que las estén frenando."

  • "Compara el rendimiento de mis anuncios en escritorio vs. móvil, visualiza las diferencias con gráficos y recomienda campañas específicas que necesiten ajustes de oferta móvil según las brechas de rendimiento."

  • "Identifica campañas donde estoy gastando más en términos de búsqueda que no están en mi lista de palabras clave, y sugiere cuáles deberían añadirse como palabras clave de coincidencia exacta."

Claude utilizará las herramientas de Google Ads para obtener los datos, presentarlos en un formato fácil de entender, crear visualizaciones cuando sea útil y proporcionar información accionable basada en los resultados.

Capacidades de visualización de datos

Claude puede ayudarte a visualizar tus datos de Google Ads de diversas formas:

  • Gráficos de tendencias: Observa cómo cambian las métricas a lo largo del tiempo
  • Gráficos comparativos: Compara diferentes campañas o grupos de anuncios
  • Distribuciones de rendimiento: Comprende cómo se desempeñan tus anuncios en diferentes dispositivos o audiencias
  • Análisis de correlación: Identifica relaciones entre el gasto y las métricas de conversión
  • Mapas de calor: Visualiza conjuntos de datos complejos con representaciones codificadas por colores

Simplemente pídele a Claude que "visualice" o "cree un gráfico" al analizar tus datos, y generará visualizaciones apropiadas para ayudarte a comprender mejor la información.

Solución de problemas

Comando de Python no encontrado

En macOS, el comando de Python predeterminado suele ser python3 en lugar de python, lo que puede causar problemas con algunas aplicaciones, incluidas las integraciones de Node.js.

Si encuentras errores relacionados con que Python no se encuentra, puedes crear un alias:

  1. Crea un alias de Python (configuración única):

    # For macOS users:
sudo ln -s $(which python3) /usr/local/bin/python

# If that doesn't work, try finding your Python installation:
sudo ln -s /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 /usr/local/bin/python

  2. Verifica que el alias funcione:

    python --version

Esto crea un enlace simbólico para que cuando las aplicaciones llamen a python, en realidad usen tu instalación de python3.

Problemas de configuración de Claude

Si tienes problemas para conectarte:

  1. Asegúrate de que todas las rutas de archivo en tu configuración sean correctas y usen la ruta completa
  2. Comprueba que tu cuenta de servicio tenga acceso a tus cuentas de Google Ads
  3. Verifica que tu Developer Token sea válido y esté ingresado correctamente
  4. Reinicia Claude Desktop después de realizar cualquier cambio
  5. Busca mensajes de error en la respuesta de Claude cuando intentes usar una herramienta
  6. Asegúrate de que tu entorno virtual esté activado al ejecutar el servidor manualmente

Limitaciones de la API de Google Ads

Si encuentras problemas relacionados con cuotas o permisos de la API:

  1. Verifica los límites de cuota de la API de Google Ads en Google Cloud Console
  2. Asegúrate de que tu Developer Token tenga el nivel de acceso adecuado
  3. Verifica que hayas otorgado los permisos correctos a tu cuenta de servicio

Otros problemas inesperados

Si encuentras cualquier otro problema inesperado durante la instalación o el uso:

  1. Copia el mensaje de error exacto que estás recibiendo
  2. Contacta a Ernesto Cohnen en ernesto@ixigo.com para obtener soporte, incluyendo:
    • Qué estabas intentando hacer
    • El mensaje de error exacto
    • Tu sistema operativo
    • Los pasos que ya has intentado

También puedes consultar a asistentes de IA, que a menudo pueden ayudar a diagnosticar y resolver problemas técnicos sugiriendo soluciones específicas para tu situación.

Recuerda que la mayoría de los problemas ya han sido encontrados por otros antes, y generalmente hay una solución sencilla disponible.

Probando tu configuración

El repositorio incluye archivos de prueba que te permiten verificar que tu conexión con la API de Google Ads funciona correctamente antes de usarla con Claude o Cursor.

Prueba de funcionalidad básica

  1. Asegúrate de que tu entorno virtual esté activado:

    # On Mac/Linux:
source .venv/bin/activate

# On Windows:
.venv\Scripts\activate

  2. Configura las variables de entorno en el archivo de prueba o establécelas en tu entorno:

    • Abre test_google_ads_mcp.py en un editor de texto
    • Encuentra la sección que comienza con if not os.environ.get("GOOGLE_ADS_CREDENTIALS_PATH"):
    • Actualiza los valores de los marcadores de posición con tus credenciales reales o comenta esta sección si las has configurado como variables de entorno

  3. Ejecuta la prueba:

    python test_google_ads_mcp.py

  4. La prueba:

    • Listará todas tus cuentas de Google Ads
    • Usará el primer ID de cuenta para probar la recuperación del rendimiento de campañas
    • Probará los datos de rendimiento de anuncios
    • Recuperará los creativos de anuncios
    • Ejecutará una consulta GAQL de muestra

Prueba de autenticación y renovación de tokens

Para probar específicamente los mecanismos de autenticación y renovación de tokens:

  1. Asegúrate de que tu entorno virtual esté activado y que tu archivo .env esté configurado.

  2. Ejecuta la prueba de renovación de tokens:

    python test_token_refresh.py

  3. Esta prueba:

    • Verificará que las credenciales se puedan cargar desde tu tipo de autenticación configurado (OAuth o cuenta de servicio)
    • Mostrará información sobre el estado actual del token y su expiración
    • Probará la función de formato del ID de cliente
    • Para tokens OAuth, intentará renovar el token y verificar que funcionó

La prueba de renovación de tokens puede ayudar a confirmar que tanto las credenciales OAuth como las de cuenta de servicio estén configuradas correctamente antes de usar el servidor con Claude o Cursor.

Si todas las pruebas se completan con éxito, tu configuración funciona correctamente y está lista para usarse con Claude o Cursor.

Contribuciones

¿Encontraste un error o tienes una idea para mejorar? ¡Agradecemos tu aportación! Abre un issue o envía un pull request en GitHub, o contacta directamente a Ernesto Cohnen en ernesto@ixigo.com.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

Acerca de ixigo

ixigo es la aplicación de viajes líder en India, que ayuda a millones de viajeros a encontrar las mejores ofertas en vuelos, trenes, autobuses y hoteles. Para más información, visita ixigo.com.

ixigo logo

ixigo es una empresa de tecnología que crea productos para ayudar a las personas a encontrar las mejores ofertas en vuelos, trenes, autobuses y hoteles. Somos un equipo de entusiastas de los viajes apasionados por hacer que los viajes sean más asequibles y accesibles para todos.