Servidor MCP do Google Ads: guia de integração para desenvolvedores

O Protocolo de Contexto de Modelo (MCP) é um padrão aberto que permite que modelos de linguagem grandes (LLMs) interajam com segurança com dados e aplicativos externos. O servidor MCP do Google Ads oferece uma ponte padronizada para a API do Google Ads, permitindo que os agentes de IA analisem e recuperem dados de campanha usando linguagem natural.

Visão geral técnica

Ao implementar esse servidor MCP, você elimina a necessidade de escrever um "código de junção" personalizado para autenticação da API Google Ads, busca de recursos e análise de dados. O servidor expõe ferramentas específicas que um LLM pode descobrir e invocar de forma autônoma.

Principais especificações

  • Protocolo:MCP (Protocolo de Contexto de Modelo)
  • Modo:somente leitura (versão atual)
  • Idioma:Python
  • Transporte:entrada/saída padrão (stdio)
  • Autenticação:OAuth 2.0 ou conta de serviço

Como funciona o loop de interação

  1. Solicitação:um usuário envia uma consulta como "Como está a performance da minha campanha esta semana?".
  2. Descoberta:o LLM inspeciona as ferramentas disponíveis e identifica os recursos de pesquisa do google-ads-mcp.
  3. Execução:o servidor MCP executa a lógica Python subjacente para consultar a API Google Ads.
  4. Injeção de contexto:os resultados estruturados são retornados para a janela de contexto do LLM.
  5. Resposta:o LLM sintetiza os dados em uma resposta legível por humanos.

Primeiros passos

Siga estas etapas para configurar e usar o servidor MCP do Google Ads.

Pré-requisitos

Antes da configuração, verifique se você tem as seguintes credenciais do Console de desenvolvedores do Google Ads:

  • Token de desenvolvedor:sua string de acesso exclusiva de 22 caracteres.
  • ID do projeto:o identificador do seu projeto do Google Cloud.
  • Arquivo de credenciais:um credentials.json autorizado (OAuth 2.0 ou conta de serviço).

Configuração

Para integrar o servidor a um host compatível com MCP, adicione a seguinte entrada ao arquivo de configuração do MCP do host (por exemplo, settings.json). Consulte a documentação do host para saber o local e o nome exatos desse arquivo.

JSON

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

Recursos principais (ferramentas)

O servidor expõe ferramentas projetadas para descoberta de contas e relatórios de performance:

  • list_accessible_customers: retorna a lista de IDs de cliente e nomes de contas do Google Ads acessíveis ao usuário autenticado.
  • search: executa solicitações da linguagem de consulta do Google Ads (GAQL) para buscar métricas, orçamentos e status da campanha.

Exemplos de comandos para começar

Pergunte o que o servidor pode fazer:

What can the google-ads-mcp server do?

Pergunte sobre os clientes:

What customers do I have access to?

Perguntar sobre campanhas:

How many active campaigns do I have?
How is my campaign performance this week?

Recursos e suporte da comunidade