Usar o servidor MCP do Google Ad Manager

O Google Ad Manager oferece um servidor remoto do Protocolo de Contexto de Modelo (MCP) que permite que agentes de IA interajam com segurança com redes, inventário, pedidos e dados do usuário do Google Ad Manager. Ao configurar o servidor MCP do Ad Manager, você permite que aplicativos de IA, como Google Antigravity, Claude e ChatGPT, realizem ações como seu usuário do Ad Manager.

O servidor MCP está disponível em https://admanager.googleapis.com/mcp.

Pré-requisitos

  • Acesso para criar projetos do Google Cloud ou para visualizar um projeto do Google Cloud.
  • Acesso para editar conexões ou apps nos seus clientes de IA (por exemplo, ChatGPT ou Claude).

Configurar o servidor MCP do Ad Manager

Para usar o servidor MCP do Ad Manager, siga estas etapas:

  • Ative a API Ad Manager no seu projeto na nuvem do Google Cloud.
  • Configure a autenticação do usuário final do OAuth 2.0.
  • Adicione o servidor MCP ao seu cliente de IA.

Ativar a API Ad Manager

Para usar o servidor MCP do Ad Manager, ative a API do Ad Manager no seu projeto do Google Cloud. Se você precisar criar um projeto na nuvem do Google, consulte Novo projeto.

Ativar a API

O servidor MCP do Ad Manager usa o OAuth 2.0 para autenticação e autorização de usuários finais. Quando um cliente de IA se conecta ao servidor MCP, ele se autentica como o usuário que está executando o cliente de IA. O agente de IA herda as mesmas funções de usuário, associações de rede e permissões do Google Ad Manager que o usuário.

  1. No console do Google Cloud, acesse Google Auth Platform > Branding.

    Acessar Branding

  2. Se você já tiver configurado a plataforma de autenticação do Google, poderá configurar as seguintes opções da tela de permissão OAuth em Branding, Público-alvo e Acesso a dados. Se você vir a mensagem A plataforma de autenticação do Google ainda não está configurada, clique em Começar:

    1. Na seção Informações do app, em Nome do app, insira Ad Manager MCP Server ou o nome que você preferir.
    2. Em E-mail para suporte do usuário, selecione seu endereço de e-mail ou um grupo adequado.
    3. Clique em Próxima.
    4. Em Público-alvo, selecione Interno.
    5. Clique em Próxima.
    6. Em Dados de contato, insira um endereço de e-mail para receber notificações sobre mudanças no seu projeto.
    7. Clique em Próxima.
    8. Na seção Concluir, leia a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a Política de dados do usuário dos serviços de API do Google.
    9. Clique em Continuar.
    10. Clique em Criar.

  3. Clique em Acesso a dados > Adicionar ou remover escopos. Um painel aparece com uma lista de escopos para cada API ativada no projeto do Google Cloud.

    1. Em Adicionar escopos manualmente, insira os escopos do OAuth necessários para o servidor MCP do Ad Manager:
      • https://www.googleapis.com/auth/admanager (acesso total para ver e gerenciar campanhas)
    2. Clique em Adicionar à tabela.
    3. Clique em Atualizar.
    4. Depois de selecionar os escopos exigidos pelo app, clique em Salvar na página Acesso a dados.

Adicionar o servidor MCP ao cliente de IA

Para adicionar o servidor MCP do Ad Manager ao seu cliente de IA, siga as instruções para seu cliente:

Antigravity

Para adicionar o servidor MCP do Ad Manager ao Antigravity, siga estas etapas:

  1. Crie um ID do cliente e uma chave secreta do OAuth 2.0:

    1. No console de APIs do Google, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.

      Acesse "Criar cliente"

      Se você não tiver um projeto selecionado, será solicitado a criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://antigravity.google/oauth-callback no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Você só pode copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  2. Para adicionar o servidor MCP do Ad Manager ao Antigravity, atualize o arquivo ~/.gemini/config/mcp_config.json:

    {
  "mcpServers": {
    "AdManager-MCP": {
      // Use your chosen MCP server URL.
      "serverUrl": "https://admanager.googleapis.com/mcp",
      "oauth": {
        "clientId": "CLIENT_ID",
        "clientSecret": "CLIENT_SECRET"
      }
    }
  }
}

    Substitua CLIENT_ID e CLIENT_SECRET pelas suas credenciais do cliente OAuth 2.0.

  3. Para autenticar o servidor MCP do Ad Manager, consulte Antigravity: autenticar com OAuth.

Claude.ai

Para adicionar o servidor MCP do Ad Manager ao Claude.ai, configure um conector personalizado com um ID e uma chave secreta do cliente OAuth:

  1. Crie um ID do cliente e uma chave secreta do OAuth 2.0:

    1. No console de APIs do Google, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.

      Acesse "Criar cliente"

      Se você não tiver um projeto selecionado, será solicitado a criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://claude.ai/api/mcp/auth_callback no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Você só pode copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  2. Siga as instruções para criar um conector personalizado. Insira o ID e a chave secreta do cliente no menu Configurações avançadas.

Claude Code

Para adicionar o servidor MCP do Ad Manager ao Claude Code, configure um conector personalizado com um ID e uma chave secreta do cliente OAuth:

  1. Instale o Claude Code.

  2. Crie um ID do cliente e uma chave secreta do OAuth 2.0:

    1. No console de APIs do Google, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.

      Acesse "Criar cliente"

      Se você não tiver um projeto selecionado, será solicitado a criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://claude.ai/api/mcp/auth_callback no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Você só pode copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  3. Siga as instruções para criar um conector personalizado. Insira o ID e a chave secreta do cliente no menu Configurações avançadas.

Claude Desktop

Para adicionar o servidor MCP do Ad Manager ao Claude Desktop, configure um conector personalizado com um ID do cliente OAuth e um segredo do cliente OAuth:

  1. Instale o Claude Desktop.

  2. Crie um ID do cliente e uma chave secreta do OAuth 2.0:

    1. No console de APIs do Google, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.

      Acesse "Criar cliente"

      Se você não tiver um projeto selecionado, será solicitado a criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://claude.ai/api/mcp/auth_callback no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Você só pode copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  3. Siga as instruções para criar um conector personalizado. Insira o ID e a chave secreta do cliente no menu Configurações avançadas.

ChatGPT

É necessário ter uma assinatura do ChatGPT Business para usar o servidor MCP do Ad Manager com o ChatGPT.

Para adicionar o servidor MCP ao ChatGPT, crie um ID e uma chave secreta do cliente OAuth 2.0 do Google e adicione o servidor MCP como um app no ChatGPT.

Criar um ID e uma chave secreta do cliente OAuth 2.0

  1. No console de APIs do Google, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.

    Acesse "Criar cliente"

    Se você não tiver um projeto selecionado, será solicitado a criar um.

  2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

  3. No campo Nome, insira um nome para o aplicativo.

  4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://chatgpt.com/connector_platform_oauth_redirect no campo URIs.

  5. Clique em Criar. O cliente é criado.

    A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

  6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Você só pode copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

Adicionar o servidor MCP como um app no ChatGPT

  1. Faça login no ChatGPT.
  2. Ative o modo de desenvolvedor.
  3. Abra as configurações dos apps do ChatGPT.
  4. Clique em Criar app e crie um app para o servidor MCP remoto.
  5. Na seção "OAuth", forneça seu ID e chave secreta do cliente.
  6. Confirme que você entende o risco associado ao uso do servidor MCP e clique em Criar.

O servidor MCP aparece no menu Apps e está pronto para uso com comandos de chat.

Cursor

Para adicionar o servidor MCP do Ad Manager ao Cursor, crie um ID do cliente e uma chave secreta. Configure o servidor MCP com OAuth estático. O Cursor usa URIs de redirecionamento dependendo do que você usa para acessar o Cursor, como um aplicativo da Web ou para computador.

  1. Crie um ID do cliente e uma chave secreta do OAuth 2.0:

    Agentes da Web ou de cursor

    1. No console de APIs do Google, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.

      Acesse "Criar cliente"

      Se você não tiver um projeto selecionado, será solicitado a criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://www.cursor.com/agents/mcp/oauth/callback no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Você só pode copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

    Computador

    1. No console de APIs do Google, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.

      Acesse "Criar cliente"

      Se você não tiver um projeto selecionado, será solicitado a criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira http://localhost:8787/callback no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Você só pode copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  2. Siga as instruções para configurar o servidor MCP com OAuth estático.
  3. Usar o servidor MCP no Chat.

Testar o servidor MCP do Ad Manager

Depois de configurar e autenticar o cliente MCP, você pode verificar a conexão executando comandos de teste na interface de chat de IA.

Faça as seguintes perguntas ao cliente de IA:

  • "Liste as redes do Google Ad Manager a que tenho acesso."

    O cliente chama list_networks para recuperar e mostrar os códigos de rede e os nomes de exibição do Ad Manager associados à sua conta de usuário.

  • "Encontre detalhes para o código de rede NETWORK_CODE"

    O cliente usa get_network para buscar metadados da rede especificada.

  • "Mostre os cinco primeiros pedidos na rede NETWORK_CODE"

    O cliente invoca list_orders para consultar e resumir os pedidos na sua rede.

Se as ferramentas forem executadas corretamente e retornarem dados do Google Ad Manager, a conexão do servidor MCP estará configurada corretamente.