Usa el servidor de MCP de Google Ad Manager

Google Ad Manager ofrece un servidor remoto del Protocolo de contexto del modelo (MCP) que permite que los agentes de IA interactúen de forma segura con las redes, el inventario, los pedidos y los datos del usuario de Google Ad Manager. Si configuras el servidor del MCP de Ad Manager, permites que las aplicaciones de IA, como Google Antigravity, Claude y ChatGPT, realicen acciones como tu usuario de Ad Manager.

El servidor de MCP está disponible en https://admanager.googleapis.com/mcp.

Requisitos previos

  • Acceso para crear proyectos de Google Cloud o para ver un proyecto de Google Cloud existente
  • Acceso para editar conexiones o Apps en tus clientes de IA (por ejemplo, ChatGPT o Claude)

Configura el servidor de MCP de Ad Manager

Para usar el servidor de MCP de Ad Manager, debes completar los siguientes pasos:

  • Habilita la API de Ad Manager en tu proyecto de Google Cloud.
  • Configura la autenticación de usuarios finales de OAuth 2.0.
  • Agrega el servidor de MCP a tu cliente de IA.

Habilita la API de Ad Manager

Para usar el servidor de MCP de Ad Manager, debes habilitar la API de Ad Manager en tu proyecto de Google Cloud. Si necesitas crear un proyecto de Google Cloud, consulta Nuevo proyecto.

Habilitar la API

El servidor de MCP de Ad Manager usa OAuth 2.0 para la autenticación y autorización de usuarios finales. Cuando un cliente de IA se conecta al servidor de MCP, se autentica como el usuario que ejecuta el cliente de IA. El agente de IA hereda los roles de usuario, las membresías de red y los permisos exactos de Google Ad Manager del usuario.

  1. En la consola de Google Cloud, ve a Google Auth Platform > Branding.

    Ir a Branding

  2. Si ya configuraste Google Auth Platform, puedes configurar los siguientes parámetros de configuración de la pantalla de consentimiento de OAuth en Branding, Audience y Data Access. Si ves un mensaje que dice Aún no se configuró Google Auth Platform, haz clic en Comenzar:

    1. En la sección Información de la app, en Nombre de la app, ingresa Ad Manager MCP Server o el nombre que prefieras.
    2. En Correo electrónico de asistencia del usuario, selecciona tu dirección de correo electrónico o un grupo adecuado.
    3. Haz clic en Siguiente.
    4. En Público, selecciona Interno.
    5. Haz clic en Siguiente.
    6. En Información de contacto, ingresa una Dirección de correo electrónico en la que puedas recibir notificaciones sobre cualquier cambio en tu proyecto.
    7. Haz clic en Siguiente.
    8. En la sección Finalizar, revisa la Política de Datos del Usuario de los Servicios de las APIs de Google y, si la aceptas, selecciona Acepto la Política de Datos del Usuario de los Servicios de las APIs de Google.
    9. Haz clic en Continuar.
    10. Haz clic en Crear.

  3. Haz clic en Acceso a los datos > Agregar o quitar permisos. Aparecerá un panel con una lista de los permisos de acceso para cada API que habilitaste en tu proyecto de Google Cloud.

    1. En Manually add scopes, ingresa los permisos de OAuth necesarios para el servidor de MCP de Ad Manager:
      • https://www.googleapis.com/auth/admanager (acceso completo para ver y administrar campañas)
    2. Haz clic en Agregar a la tabla.
    3. Haz clic en Actualizar.
    4. Después de seleccionar los permisos que requiere tu app, haz clic en Guardar en la página Acceso a los datos.

Agrega el servidor de MCP a tu cliente de IA

Para agregar el servidor de MCP de Ad Manager a tu cliente de IA, sigue las instrucciones correspondientes:

Antigravity

Para agregar el servidor de MCP de Ad Manager a Antigravity, completa los siguientes pasos:

  1. Crea un ID y un secreto de cliente de OAuth 2.0:

    1. En la Consola de APIs de Google, ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URI de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://antigravity.google/oauth-callback en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, borra el secreto y crea uno nuevo.

  2. Para agregar el servidor de MCP de Ad Manager a Antigravity, actualiza tu archivo ~/.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"
      }
    }
  }
}

    Reemplaza CLIENT_ID y CLIENT_SECRET por tus credenciales de cliente de OAuth 2.0.

  3. Para autenticar el servidor de MCP de Ad Manager, consulta Antigravity: Autenticación con OAuth.

Claude.ai

Para agregar el servidor de MCP de Ad Manager a Claude.ai, configura un conector personalizado con un ID de cliente de OAuth y un secreto de cliente de OAuth:

  1. Crea un ID y un secreto de cliente de OAuth 2.0:

    1. En la Consola de APIs de Google, ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URI de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://claude.ai/api/mcp/auth_callback en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, borra el secreto y crea uno nuevo.

  2. Sigue las instrucciones para crear un conector personalizado. Ingresa tu ID de cliente y tu secreto en el menú Configuración avanzada.

Claude Code

Para agregar el servidor de MCP de Ad Manager a Claude Code, configura un conector personalizado con un ID de cliente de OAuth y un secreto de cliente de OAuth:

  1. Instala Claude Code.

  2. Crea un ID y un secreto de cliente de OAuth 2.0:

    1. En la Consola de APIs de Google, ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URI de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://claude.ai/api/mcp/auth_callback en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, borra el secreto y crea uno nuevo.

  3. Sigue las instrucciones para crear un conector personalizado. Ingresa tu ID de cliente y tu secreto en el menú Configuración avanzada.

Claude para computadoras

Para agregar el servidor de MCP de Ad Manager a Claude Desktop, configura un conector personalizado con un ID de cliente de OAuth y un secreto del cliente de OAuth:

  1. Instala Claude para computadoras de escritorio.

  2. Crea un ID y un secreto de cliente de OAuth 2.0:

    1. En la Consola de APIs de Google, ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URI de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://claude.ai/api/mcp/auth_callback en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, borra el secreto y crea uno nuevo.

  3. Sigue las instrucciones para crear un conector personalizado. Ingresa tu ID de cliente y tu secreto en el menú Configuración avanzada.

ChatGPT

Debes tener una suscripción a ChatGPT Business para usar el servidor del MCP de Ad Manager con ChatGPT.

Para agregar el servidor de MCP a ChatGPT, crea un ID y un secreto de cliente de Google OAuth 2.0 y, luego, agrega el servidor de MCP como una app en ChatGPT.

Crea un ID y un secreto de cliente de OAuth 2.0

  1. En la Consola de APIs de Google, ve a Google Auth Platform > Clients > Create client.

    Ir a Crear cliente

    Se te solicitará que crees un proyecto si no tienes uno seleccionado.

  2. En la lista Tipo de aplicación, selecciona Aplicación web.

  3. En el campo Nombre, ingresa un nombre para tu aplicación.

  4. En la sección URI de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://chatgpt.com/connector_platform_oauth_redirect en el campo URIs.

  5. Haz clic en Crear. Se creó el cliente.

    Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

  6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, borra el secreto y crea uno nuevo.

Agrega el servidor de MCP como una app en ChatGPT

  1. Accede a ChatGPT.
  2. Activa el modo de desarrollador.
  3. Abre la configuración de las Apps de ChatGPT.
  4. Haz clic en Crear app y crea una app para el servidor de MCP remoto.
  5. En la sección de OAuth, proporciona tu ID y secreto de cliente.
  6. Confirma que comprendes el riesgo asociado con el uso del servidor de MCP y, luego, haz clic en Crear.

El servidor de MCP se muestra en el menú Apps y está listo para usarse a través de instrucciones de chat.

Cursor

Para agregar el servidor de MCP de Ad Manager a Cursor, crea un ID y un secreto del cliente. Configura el servidor de MCP con OAuth estático. Cursor usa URIs de redireccionamiento según lo que uses para acceder a Cursor, por ejemplo, a través de una aplicación web o de escritorio.

  1. Crea un ID y un secreto de cliente de OAuth 2.0:

    Agentes web o de cursor

    1. En la Consola de APIs de Google, ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URI de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://www.cursor.com/agents/mcp/oauth/callback en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, borra el secreto y crea uno nuevo.

    Computadora de escritorio

    1. En la Consola de APIs de Google, ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URI de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa http://localhost:8787/callback en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, borra el secreto y crea uno nuevo.

  2. Sigue las instrucciones para configurar el servidor de MCP con OAuth estático.
  3. Usa el servidor de MCP en Chat.

Prueba el servidor de MCP de Ad Manager

Después de configurar y autenticar tu cliente de MCP, puedes verificar la conexión ejecutando mensajes de prueba en tu interfaz de chat de IA.

Intenta hacerle las siguientes preguntas a tu cliente de IA:

  • "Enumera las redes de Google Ad Manager a las que tengo acceso".

    El cliente llama a list_networks para recuperar y mostrar los códigos de red y los nombres visibles de Ad Manager asociados a tu cuenta de usuario.

  • "Busca detalles para el código de red NETWORK_CODE".

    El cliente usa get_network para recuperar los metadatos de la red especificada.

  • "Muestra los primeros 5 pedidos de la red NETWORK_CODE".

    El cliente invoca list_orders para consultar los pedidos en tu red y resumirlos.

Si las herramientas se ejecutan correctamente y muestran datos de Google Ad Manager, la conexión del servidor de MCP está configurada correctamente.