Utiliser le serveur MCP Google Ad Manager

Google Ad Manager propose un serveur Model Context Protocol (MCP) à distance qui permet aux agents IA d'interagir de manière sécurisée avec les réseaux, l'inventaire, les commandes et les données utilisateur Google Ad Manager. En configurant le serveur MCP Ad Manager, vous autorisez les applications d'IA telles que Google Antigravity, Claude et ChatGPT à effectuer des actions en tant qu'utilisateur Ad Manager.

Le serveur MCP est disponible à l'adresse https://admanager.googleapis.com/mcp.

Prérequis

  • Vous devez pouvoir créer des projets Google Cloud ou afficher un projet Google Cloud existant.
  • Accès pour modifier les connexions ou les applications dans vos clients d'IA (par exemple, ChatGPT ou Claude).

Configurer le serveur MCP Ad Manager

Pour utiliser le serveur MCP Ad Manager, vous devez procéder comme suit :

  • Activez l'API Ad Manager dans votre projet Google Cloud.
  • Configurez l'authentification des utilisateurs finaux OAuth 2.0.
  • Ajoutez le serveur MCP à votre client d'IA.

Activer l'API Ad Manager

Pour utiliser le serveur MCP Ad Manager, vous devez activer l'API Ad Manager dans votre projet Google Cloud. Si vous devez créer un projet Google Cloud, consultez Nouveau projet.

Activer l'API

Le serveur MCP Ad Manager utilise OAuth 2.0 pour l'authentification et l'autorisation des utilisateurs finaux. Lorsqu'un client IA se connecte au serveur MCP, il s'authentifie en tant qu'utilisateur exécutant le client IA. L'agent d'IA hérite exactement des rôles utilisateur, des appartenances au réseau et des autorisations Google Ad Manager de l'utilisateur.

  1. Dans la console Google Cloud, accédez à Google Auth Platform > Branding.

    Accéder à la page "Branding"

  2. Si vous avez déjà configuré la plate-forme Google Auth, vous pouvez configurer les paramètres de l'écran de consentement OAuth suivants dans Branding, Audience et Accès aux données. Si le message Google Auth Platform pas encore configuré s'affiche, cliquez sur Premiers pas :

    1. Dans la section Informations sur l'application, pour Nom de l'application, saisissez Ad Manager MCP Server ou le nom de votre choix.
    2. Sous Adresse e-mail d'assistance utilisateur, sélectionnez votre adresse e-mail ou un groupe approprié.
    3. Cliquez sur Suivant.
    4. Dans le champ Audience, sélectionnez Interne.
    5. Cliquez sur Suivant.
    6. Pour les coordonnées, saisissez une adresse e-mail à laquelle vous recevrez des notifications en cas de modification de votre projet.
    7. Cliquez sur Suivant.
    8. Dans la section Terminer, consultez le Règlement sur les données utilisateur dans les services d'API Google et, si vous l'acceptez, sélectionnez J'accepte le Règlement sur les données utilisateur dans les services d'API Google.
    9. Cliquez sur Continuer.
    10. Cliquez sur Créer.

  3. Cliquez sur Accès aux données > Ajouter ou supprimer des niveaux d'accès. Un panneau s'affiche avec la liste des niveaux d'accès pour chaque API que vous avez activée dans votre projet Google Cloud.

    1. Sous Ajouter manuellement des habilitations, saisissez les habilitations OAuth requises pour le serveur MCP Ad Manager :
      • https://www.googleapis.com/auth/admanager (accès complet pour afficher et gérer les campagnes)
    2. Cliquez sur Ajouter au tableau.
    3. Cliquez sur Mettre à jour.
    4. Après avoir sélectionné les niveaux d'accès requis par votre application, cliquez sur Enregistrer sur la page Accès aux données.

Ajouter le serveur MCP à votre client IA

Pour ajouter le serveur MCP Ad Manager à votre client d'IA, suivez les instructions correspondant à votre client :

Antigravity

Pour ajouter le serveur MCP Ad Manager à Antigravity, procédez comme suit :

  1. Créez un ID client et un code secret OAuth 2.0 :

    1. Dans la console Google API, accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page "Créer un client"

      Si aucun projet n'est sélectionné, vous êtes invité à en créer un.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://antigravity.google/oauth-callback dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un emplacement sécurisé. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  2. Pour ajouter le serveur MCP Ad Manager à Antigravity, mettez à jour votre fichier ~/.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"
      }
    }
  }
}

    Remplacez CLIENT_ID et CLIENT_SECRET par vos identifiants client OAuth 2.0.

  3. Pour authentifier le serveur MCP Ad Manager, consultez Antigravity : authentification avec OAuth.

Claude.ai

Pour ajouter le serveur MCP Ad Manager à Claude.ai, configurez un connecteur personnalisé avec un ID client OAuth et un code secret du client OAuth :

  1. Créez un ID client et un code secret OAuth 2.0 :

    1. Dans la console Google API, accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page "Créer un client"

      Si aucun projet n'est sélectionné, vous êtes invité à en créer un.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://claude.ai/api/mcp/auth_callback dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un emplacement sécurisé. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  2. Suivez les instructions pour créer un connecteur personnalisé. Saisissez votre ID client et votre code secret dans le menu Paramètres avancés.

Claude Code

Pour ajouter le serveur MCP Ad Manager à Claude Code, configurez un connecteur personnalisé avec un ID client OAuth et un code secret du client OAuth :

  1. Installez Claude Code.

  2. Créez un ID client et un code secret OAuth 2.0 :

    1. Dans la console Google API, accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page "Créer un client"

      Si aucun projet n'est sélectionné, vous êtes invité à en créer un.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://claude.ai/api/mcp/auth_callback dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un emplacement sécurisé. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  3. Suivez les instructions pour créer un connecteur personnalisé. Saisissez votre ID client et votre code secret dans le menu Paramètres avancés.

Claude Desktop

Pour ajouter le serveur MCP Ad Manager à Claude Desktop, configurez un connecteur personnalisé avec un ID client OAuth et un secret client OAuth :

  1. Installez Claude Desktop.

  2. Créez un ID client et un code secret OAuth 2.0 :

    1. Dans la console Google API, accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page "Créer un client"

      Si aucun projet n'est sélectionné, vous êtes invité à en créer un.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://claude.ai/api/mcp/auth_callback dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un emplacement sécurisé. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  3. Suivez les instructions pour créer un connecteur personnalisé. Saisissez votre ID client et votre code secret dans le menu Paramètres avancés.

ChatGPT

Vous devez disposer d'un abonnement ChatGPT Business pour utiliser le serveur MCP Ad Manager avec ChatGPT.

Pour ajouter le serveur MCP à ChatGPT, créez un ID client et un code secret Google OAuth 2.0, puis ajoutez le serveur MCP en tant qu'application dans ChatGPT.

Créer un ID client et un code secret OAuth 2.0

  1. Dans la console Google API, accédez à Google Auth Platform > Clients > Créer un client.

    Accéder à la page "Créer un client"

    Si aucun projet n'est sélectionné, vous êtes invité à en créer un.

  2. Dans la liste Type d'application, sélectionnez Application Web.

  3. Dans le champ Nom, saisissez le nom de votre application.

  4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://chatgpt.com/connector_platform_oauth_redirect dans le champ URI.

  5. Cliquez sur Créer. Le client est créé.

    La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

  6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un emplacement sécurisé. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

Ajouter le serveur MCP en tant qu'application dans ChatGPT

  1. Connectez-vous à ChatGPT.
  2. Activez le mode développeur.
  3. Ouvrez les paramètres des applications ChatGPT.
  4. Cliquez sur Créer une application et créez une application pour le serveur MCP distant.
  5. Dans la section OAuth, indiquez votre ID client et votre code secret.
  6. Confirmez que vous comprenez les risques associés à l'utilisation du serveur MCP, puis cliquez sur Créer.

Le serveur MCP s'affiche dans le menu Applications et est prêt à être utilisé via des requêtes de chat.

Cursor

Pour ajouter le serveur MCP Ad Manager à Cursor, créez un ID client et un code secret. Configurez le serveur MCP avec OAuth statique. Cursor utilise des URI de redirection en fonction de la façon dont vous accédez à Cursor (par exemple, via une application Web ou de bureau).

  1. Créez un ID client et un code secret OAuth 2.0 :

    Agents Web ou Cursor

    1. Dans la console Google API, accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page "Créer un client"

      Si aucun projet n'est sélectionné, vous êtes invité à en créer un.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://www.cursor.com/agents/mcp/oauth/callback dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un emplacement sécurisé. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

    Ordinateur

    1. Dans la console Google API, accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page "Créer un client"

      Si aucun projet n'est sélectionné, vous êtes invité à en créer un.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez http://localhost:8787/callback dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un emplacement sécurisé. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  2. Suivez les instructions pour configurer le serveur MCP avec OAuth statique.
  3. Utilisez le serveur MCP dans Chat.

Tester le serveur MCP Ad Manager

Une fois que vous avez configuré et authentifié votre client MCP, vous pouvez vérifier la connexion en exécutant des requêtes de test dans votre interface de chat IA.

Essayez de poser les questions suivantes à votre client IA :

  • "Liste les réseaux Google Ad Manager auxquels j'ai accès."

    Le client appelle list_networks pour récupérer et afficher les codes réseau et les noms à afficher Ad Manager associés à votre compte utilisateur.

  • "Trouve les détails du code réseau NETWORK_CODE."

    Le client utilise get_network pour récupérer les métadonnées du réseau spécifié.

  • "Affiche les cinq premières commandes du réseau NETWORK_CODE."

    Le client appelle list_orders pour interroger les commandes de votre réseau et les résumer.

Si les outils s'exécutent correctement et renvoient des données Google Ad Manager, la connexion à votre serveur MCP est configurée correctement.