Google Ads MCP

Gerencie campanhas e relatórios do Google Ads usando a API do Google Ads.

Documentação

Google Ads MCP

Uma ferramenta que conecta o Google Ads ao Claude AI, permitindo que você analise seus dados de publicidade por meio de conversas em linguagem natural. Essa integração dá acesso a informações de campanhas, métricas de desempenho, análises de palavras-chave e gerenciamento de anúncios—tudo por meio de conversas simples com o Claude.

O Que Esta Ferramenta Pode Fazer por Profissionais de Publicidade?

Gerenciamento de Contas
- Veja todas as suas contas do Google Ads em um só lugar
- Obtenha detalhes da conta e informações básicas de campanhas
Análise e Relatórios de Campanhas
- Descubra quais campanhas estão com melhor desempenho
- Acompanhe impressões, cliques, conversões e métricas de custo
- Analise tendências de desempenho ao longo do tempo
- Compare diferentes períodos para identificar mudanças
- Visualize seus dados com gráficos e tabelas criados pelo Claude
Desempenho de Palavras-Chave e Anúncios
- Identifique palavras-chave de melhor e pior desempenho
- Analise a eficácia do texto dos anúncios
- Verifique pontuações de qualidade e métricas competitivas
- Obtenha insights acionáveis sobre como melhorar suas campanhas
Gerenciamento de Orçamento e Lances
- Monitore orçamentos e gastos de campanhas
- Analise estratégias de lances e desempenho
- Identifique oportunidades de otimização
- Receba recomendações para alocação de orçamento

Fluxo da Arquitetura do 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

Ferramentas Disponíveis

Aqui está o que você pode pedir ao Claude para fazer depois de configurar esta integração:

O Que Você Pode Pedir	O Que Isso Faz	O Que Você Precisará Fornecer
`list_accounts`	Mostra todas as suas contas do Google Ads	Nada - basta pedir!
`execute_gaql_query`	Executa uma consulta na Google Ads Query Language	Seu ID de conta e uma consulta GAQL
`get_campaign_performance`	Mostra métricas de campanha com dados de desempenho	Seu ID de conta e período de tempo
`get_ad_performance`	Análise detalhada do desempenho dos seus criativos de anúncio	Seu ID de conta e período de tempo
`run_gaql`	Executa qualquer consulta GAQL arbitrária com opções de formatação	Seu ID de conta, consulta e formato (tabela, JSON ou CSV)

Usando as Ferramentas de Consulta Avançada

A ferramenta run_gaql é especialmente poderosa, pois permite executar qualquer consulta personalizada na Google Ads Query Language (GAQL). Aqui estão alguns exemplos de consultas que você pode usar:

Exemplo 1: Métricas básicas de campanha

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

Exemplo 2: Desempenho de grupos de anúncios

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

Exemplo 3: Análise de palavras-chave

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

Para uma lista completa de todas as ferramentas disponíveis e suas descrições detalhadas, peça ao Claude para "listar ferramentas" após a configuração.

Primeiros Passos (Sem Necessidade de Experiência em Programação!)

1. Configurar o Acesso à API do Google Ads

Antes de usar esta ferramenta, você precisará criar credenciais de API que permitam ao Claude acessar seus dados do Google Ads. Você pode escolher entre dois métodos de autenticação:

Opção A: ID de Cliente OAuth 2.0 (Autenticação de Usuário)

Ideal para usuários individuais ou aplicativos de desktop:

Acesse o Google Cloud Console
Crie um novo projeto ou selecione um existente
Ative a API do Google Ads
Vá em "Credenciais" → "Criar Credenciais" → "ID de Cliente OAuth"
Escolha "Aplicativo de Desktop" como tipo de aplicativo
Baixe o arquivo de configuração do cliente OAuth (client_secret.json)
Crie um token de desenvolvedor da API do Google Ads (veja abaixo)

Opção B: Conta de Serviço (Autenticação Servidor a Servidor)

Melhor para sistemas automatizados ou gerenciamento de múltiplas contas:

Acesse o Google Cloud Console
Crie um novo projeto ou selecione um existente
Ative a API do Google Ads
Vá em "Credenciais" → "Criar Credenciais" → "Conta de Serviço"
Baixe o arquivo de chave da conta de serviço (JSON)
Conceda à conta de serviço acesso às suas contas do Google Ads
Crie um token de desenvolvedor da API do Google Ads (veja abaixo)

Atualização Automática de Tokens de Autenticação

O aplicativo agora inclui um gerenciamento robusto de atualização de tokens:

Tokens OAuth 2.0: A ferramenta atualizará automaticamente tokens OAuth expirados quando possível, ou solicitará nova autenticação se o token de atualização for inválido.
Tokens de Conta de Serviço: Os tokens de conta de serviço são gerados e atualizados automaticamente conforme necessário, sem intervenção do usuário.

Comparação de Métodos de Autenticação

Escolha o ID de Cliente OAuth 2.0 se:

Você está criando um aplicativo de desktop
Os usuários precisam conceder acesso explicitamente
Você está gerenciando uma única conta ou algumas contas pessoais
Você quer que os usuários tenham controle sobre as permissões de acesso

Escolha a Conta de Serviço se:

Você está criando um sistema automatizado
Você precisa de autenticação servidor a servidor
Você está gerenciando múltiplas contas programaticamente
Você não quer/precisa de interação do usuário para autenticação
Você precisa de atualização automática de tokens sem intervenção do usuário

Obtendo um Token de Desenvolvedor

Entre na sua conta do Google Ads em https://ads.google.com
Clique em Ferramentas e Configurações (ícone de chave inglesa) na navegação superior
Em "Configuração", clique em "Central da API"
Se ainda não tiver feito, aceite os Termos de Serviço
Clique em "Solicitar token"
Preencha o formulário de inscrição com detalhes sobre como você planeja usar a API
Envie a inscrição e aguarde a aprovação (geralmente de 1 a 3 dias úteis)

Observação: Inicialmente, você receberá um Token de Desenvolvedor de teste que tem algumas limitações. Depois de testar sua implementação, você pode solicitar um token de produção que remove essas restrições.

Entendendo o ID de Cliente de Login

O GOOGLE_ADS_LOGIN_CUSTOMER_ID é opcional e é usado principalmente quando:

Você está trabalhando com uma Conta de Gerente do Google Ads (MCC)
Você precisa acessar múltiplas contas de cliente sob essa conta de gerente

O ID de Cliente de Login deve ser o ID da sua Conta de Gerente (formato: XXX-XXX-XXXX) se:

Você está acessando múltiplas contas sob uma conta de gerente
Você quer usar credenciais da conta de gerente para acessar contas de cliente

Você pode pular esta configuração se:

Você está acessando apenas uma única conta do Google Ads
Você está usando credenciais diretamente da conta que deseja acessar

Para encontrar o ID da sua Conta de Gerente:

Entre na sua Conta de Gerente do Google Ads
Clique no ícone de configurações (engrenagem)
O ID da sua Conta de Gerente será exibido no formato XXX-XXX-XXXX
Baixe o arquivo de credenciais (um arquivo JSON)

🎬 Assista a este tutorial para iniciantes no Youtube: EM BREVE

2. Instalar o Software Necessário

Você precisará instalar estas ferramentas no seu computador:

Python (versão 3.11 ou mais recente) - Isso executa a conexão entre o Google Ads e o Claude
Node.js - Necessário para executar o inspetor MCP e certos componentes MCP
Claude Desktop - O assistente de IA com quem você conversará

Certifique-se de que Python e Node.js estejam instalados corretamente e disponíveis no caminho do seu sistema antes de continuar.

3. Baixar o Google Ads MCP

Você precisa baixar esta ferramenta para o seu computador. A maneira mais fácil é:

Clique no botão verde "Code" no topo desta página
Selecione "Download ZIP"
Descompacte o arquivo baixado em um local de fácil acesso (como sua pasta Documentos)

Alternativamente, se você estiver familiarizado com Git:

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

4. Instalar os Componentes Necessários

Abra o Terminal (Mac) ou Prompt de Comando (Windows) do seu computador:

Navegue até a pasta onde você descompactou os arquivos:

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

Crie um ambiente virtual (isso mantém as dependências do projeto isoladas):
```
# 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
```
Observação: Se você receber um erro "pip not found" ao tentar instalar o uv, consulte a seção "Se você receber o erro 'pip not found'" abaixo.

Ative o ambiente virtual:

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

# On Windows:
.venv\Scripts\activate

Instale as dependências necessárias:

# 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

Se você receber o erro "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

Quando você vir (.venv) no início do prompt do seu comando, significa que o ambiente virtual está ativo e as dependências serão instaladas lá, sem afetar a instalação do Python do seu sistema.

5. Configuração do Ambiente

O Google Ads MCP agora suporta configuração por arquivo de ambiente para facilitar a configuração.

Usando o Arquivo .env (Recomendado)

Copie o arquivo .env.example para .env no diretório do seu projeto:
```
cp .env.example .env
```

Edite o arquivo .env com seus valores reais de configuração:

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

# For Windows:
notepad .env

Defina os seguintes valores no seu arquivo .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

Salve o arquivo.

O aplicativo carregará automaticamente esses valores do arquivo .env quando iniciar.

Usando Variáveis de Ambiente Diretas

Você também pode definir variáveis de ambiente diretamente no seu sistema ou nos arquivos de configuração do Claude ou 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 o Claude ao Google Ads

Baixe e instale o Claude Desktop se ainda não tiver feito
Certifique-se de ter o arquivo de credenciais da sua conta de serviço do Google salvo em algum lugar do seu computador
Abra o Terminal (Mac) ou Prompt de Comando (Windows) do seu computador e digite:

# For Mac users:
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

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

Adicione o seguinte texto (isso informa ao Claude como se conectar ao 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: Substitua todos os caminhos e valores pelas informações reais da sua conta:

O primeiro caminho deve apontar para o executável do Python dentro do seu ambiente virtual
O segundo caminho deve apontar para o arquivo google_ads_server.py dentro da pasta que você descompactou
O terceiro caminho deve apontar para o arquivo JSON de credenciais da sua conta de serviço do Google
Adicione seu Token de Desenvolvedor do Google Ads
Adicione o ID da sua Conta de Gerente do Google Ads (se aplicável)

Exemplos:

Mac:
- Caminho do Python: /Users/ernesto/Documents/mcp-google-ads/.venv/bin/python
- Caminho do script: /Users/ernesto/Documents/mcp-google-ads/google_ads_server.py
Windows:
- Caminho do Python: C:\\Users\\ernesto\\Documents\\mcp-google-ads\\.venv\\Scripts\\python.exe
- Caminho do script: C:\\Users\\ernesto\\Documents\\mcp-google-ads\\google_ads_server.py

Salve o arquivo:
- Mac: Pressione Ctrl+O, depois Enter, depois Ctrl+X para sair
- Windows: Clique em Arquivo > Salvar e feche o Bloco de Notas
Reinicie o Claude Desktop
Quando o Claude abrir, você deverá ver as ferramentas do Google Ads disponíveis na seção de ferramentas

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

O Cursor é um editor de código com tecnologia de IA que pode ser aprimorado com ferramentas MCP. Você pode integrar esta ferramenta Google Ads MCP ao Cursor para analisar dados de publicidade diretamente no seu ambiente de codificação.

Configurando a Integração com o Cursor

Se ainda não tiver feito, baixe e instale o Cursor
Crie um arquivo de configuração MCP do Cursor:

Para configuração específica do projeto: Crie um arquivo .cursor/mcp.json no diretório do seu projeto.

Para configuração global (disponível em todos os projetos): Crie um arquivo ~/.cursor/mcp.json no seu diretório pessoal.

Adicione a seguinte configuração ao seu arquivo de configuração 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: Substitua todos os caminhos e valores pelas informações reais da sua conta, assim como na configuração do Claude Desktop.

Reinicie o Cursor ou recarregue o espaço de trabalho para aplicar a nova configuração.
O Google Ads MCP agora aparecerá na seção "Ferramentas Disponíveis" do Cursor e poderá ser usado pelo agente de IA do Cursor quando necessário.

Usando o Google Ads MCP no Cursor

Ao trabalhar no Cursor, você pode pedir ao agente de IA para usar as ferramentas do Google Ads diretamente. Por exemplo:

"Use o Google Ads MCP para listar todas as minhas contas e mostrar quais têm o maior gasto."
"Você pode analisar o desempenho das minhas campanhas nos últimos 30 dias usando o Google Ads MCP?"
"Execute uma consulta GAQL para encontrar minhas palavras-chave com maior conversão usando as ferramentas do Google Ads." O Cursor solicitará que você aprove o uso da ferramenta (a menos que você tenha ativado o modo Yolo) e exibirá os resultados diretamente na interface de chat.

Recursos Específicos do Cursor

Ao usar o Google Ads MCP com o Cursor, você pode:

Combinar Código e Análise de Anúncios: Peça ao Cursor para analisar seu código relacionado a marketing junto com dados reais de desempenho de campanhas.
Gerar Visualizações de Dados: Solicite gráficos e visualizações do desempenho dos seus anúncios diretamente no seu ambiente de desenvolvimento.
Implementar Recomendações: Deixe o Cursor sugerir melhorias de código com base nos seus dados reais de publicidade.

Essa integração é particularmente valiosa para desenvolvedores que trabalham com automação de marketing, painéis de análise ou aplicativos de e-commerce, onde o desempenho dos anúncios impacta diretamente as decisões de código.

6. Comece a Analisar Seus Dados de Publicidade!

Agora você pode fazer perguntas ao Claude sobre seus dados do Google Ads! O Claude não só pode recuperar os dados, mas também analisá-los, explicar tendências e criar visualizações para ajudá-lo a entender melhor o desempenho da sua publicidade.

Aqui estão alguns prompts poderosos que você pode usar com cada ferramenta:

Nome da Ferramenta	Exemplo de Prompt
`list_accounts`	"Liste todas as minhas contas do Google Ads e me diga quais tiveram o maior gasto neste mês."
`execute_gaql_query`	"Execute esta consulta para a conta 123-456-7890: SELECT campaign.name, metrics.clicks FROM campaign WHERE metrics.impressions > 1000"
`get_campaign_performance`	"Mostre-me as 10 principais campanhas da conta 123-456-7890 nos últimos 30 dias, destaque aquelas com ROAS abaixo de 2 e sugira estratégias de otimização."
`get_ad_performance`	"Faça uma análise abrangente de quais elementos de texto do anúncio estão gerando o melhor CTR nas minhas campanhas de pesquisa e dê-me recomendações acionáveis."
`run_gaql`	"Execute esta consulta e formate-a como CSV: SELECT ad_group.name, metrics.clicks, metrics.conversions FROM ad_group WHERE campaign.name LIKE '%Brand%'"

Você também pode pedir ao Claude para combinar várias ferramentas e analisar os resultados. Por exemplo:

"Encontre minhas 20 principais palavras-chave em conversão, verifique seus índices de qualidade e participação de impressões, e crie um relatório destacando oportunidades de expansão."
"Analise a tendência de desempenho da minha conta nos últimos 90 dias, identifique minhas campanhas de crescimento mais rápido e verifique se há limitações de orçamento impedindo o crescimento delas."
"Compare o desempenho dos meus anúncios em desktop vs. mobile, visualize as diferenças com gráficos e recomende campanhas específicas que precisam de ajustes de lance para mobile com base nas lacunas de desempenho."
"Identifique campanhas onde estou gastando mais em termos de pesquisa que não estão na minha lista de palavras-chave e sugira quais devem ser adicionadas como palavras-chave de correspondência exata."

O Claude usará as ferramentas do Google Ads para buscar os dados, apresentá-los em um formato fácil de entender, criar visualizações quando útil e fornecer insights acionáveis com base nos resultados.

Recursos de Visualização de Dados

O Claude pode ajudá-lo a visualizar seus dados do Google Ads de várias maneiras:

Gráficos de Tendência: Veja como as métricas mudam ao longo do tempo
Gráficos de Comparação: Compare diferentes campanhas ou grupos de anúncios
Distribuições de Desempenho: Entenda como seus anúncios se saem em diferentes dispositivos ou públicos
Análise de Correlação: Identifique relações entre gastos e métricas de conversão
Mapas de Calor: Visualize conjuntos de dados complexos com representações codificadas por cores

Basta pedir ao Claude para "visualizar" ou "criar um gráfico" ao analisar seus dados, e ele gerará visualizações apropriadas para ajudá-lo a entender melhor as informações.

Solução de Problemas

Comando Python Não Encontrado

No macOS, o comando Python padrão costuma ser python3 em vez de python, o que pode causar problemas com alguns aplicativos, incluindo integrações Node.js.

Se você encontrar erros relacionados ao Python não ser encontrado, pode criar um alias:

Crie um alias para Python (configuração ú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

Verifique se o alias funciona:
```
python --version
```

Isso cria um link simbólico para que, quando os aplicativos chamarem python, eles usem na verdade sua instalação do python3.

Problemas de Configuração do Claude

Se você estiver tendo problemas para conectar:

Certifique-se de que todos os caminhos de arquivo na sua configuração estejam corretos e usem o caminho completo
Verifique se sua conta de serviço tem acesso às suas contas do Google Ads
Confirme se seu Developer Token é válido e foi inserido corretamente
Reinicie o Claude Desktop após fazer qualquer alteração
Procure mensagens de erro na resposta do Claude ao tentar usar uma ferramenta
Certifique-se de que seu ambiente virtual esteja ativado ao executar o servidor manualmente

Limitações da API do Google Ads

Se você encontrar problemas relacionados a cotas ou permissões da API:

Verifique seus limites de cota da API do Google Ads no Google Cloud Console
Certifique-se de que seu Developer Token tenha o nível de acesso apropriado
Verifique se você concedeu as permissões adequadas à sua conta de serviço

Outros Problemas Inesperados

Se você encontrar qualquer outro problema inesperado durante a instalação ou uso:

Copie a mensagem de erro exata que está recebendo
Entre em contato com Ernesto Cohnen em ernesto@ixigo.com para suporte, incluindo:
- O que você estava tentando fazer
- A mensagem de erro exata
- Seu sistema operacional
- Quaisquer etapas que você já tentou

Você também pode consultar assistentes de IA, que muitas vezes podem ajudar a diagnosticar e resolver problemas técnicos sugerindo soluções específicas para sua situação.

Lembre-se de que a maioria dos problemas já foi encontrada por outras pessoas antes, e geralmente há uma solução direta disponível.

Testando Sua Configuração

O repositório inclui arquivos de teste que permitem verificar se sua conexão com a API do Google Ads está funcionando corretamente antes de usá-la com o Claude ou o Cursor.

Testando a Funcionalidade Básica

Certifique-se de que seu ambiente virtual esteja ativado:

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

# On Windows:
.venv\Scripts\activate

Configure as variáveis de ambiente no arquivo de teste ou defina-as no seu ambiente:
- Abra test_google_ads_mcp.py em um editor de texto
- Encontre a seção que começa com if not os.environ.get("GOOGLE_ADS_CREDENTIALS_PATH"):
- Atualize os valores de exemplo com suas credenciais reais ou comente esta seção se você as definiu como variáveis de ambiente
Execute o teste:
```
python test_google_ads_mcp.py
```
O teste irá:
- Listar todas as suas contas do Google Ads
- Usar o primeiro ID de conta para testar a recuperação de desempenho de campanhas
- Testar dados de desempenho de anúncios
- Recuperar criativos de anúncios
- Executar uma consulta GAQL de exemplo

Testando Autenticação e Atualização de Token

Para testar especificamente os mecanismos de autenticação e atualização de token:

Certifique-se de que seu ambiente virtual esteja ativado e que seu arquivo .env esteja configurado.
Execute o teste de atualização de token:
```
python test_token_refresh.py
```
Este teste irá:
- Verificar se as credenciais podem ser carregadas do seu tipo de autenticação configurado (OAuth ou conta de serviço)
- Exibir informações sobre o status atual do token e sua expiração
- Testar a função de formatação do ID do cliente
- Para tokens OAuth, tentar atualizar o token e verificar se funcionou

O teste de atualização de token pode ajudar a confirmar que tanto as credenciais OAuth quanto as de conta de serviço estão configuradas corretamente antes de usar o servidor com o Claude ou o Cursor.

Se todos os testes forem concluídos com sucesso, sua configuração está funcionando corretamente e pronta para uso com o Claude ou o Cursor.

Contribuindo

Encontrou um bug ou tem uma ideia de melhoria? Adoraríamos receber sua contribuição! Abra uma issue ou envie um pull request no GitHub, ou entre em contato com Ernesto Cohnen diretamente em ernesto@ixigo.com.

Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

Sobre a ixigo

A ixigo é o principal aplicativo de viagens da Índia, ajudando milhões de viajantes a encontrar as melhores ofertas em voos, trens, ônibus e hotéis. Para mais informações, visite ixigo.com.

A ixigo é uma empresa de tecnologia que cria produtos para ajudar as pessoas a encontrar as melhores ofertas em voos, trens, ônibus e hotéis. Somos uma equipe de entusiastas de viagens apaixonados por tornar as viagens mais acessíveis e disponíveis para todos.