Gemini CLI MCP : connecter Apogee en deux commandes

Gemini CLI MCP : deux commandes suffisent pour brancher Apogee sur Gemini CLI. gemini mcp add ajoute le serveur https://app.apogee.ad/mcp, puis /mcp auth apogee vous connecte à Apogee dans le navigateur. Depuis le terminal, Gemini CLI lit ensuite vos comptes Meta, TikTok et Snapchat, lance vos créas et prépare pauses et budgets, toujours après votre oui. Il vous faut une offre qui donne encore accès à Gemini CLI et Apogee dès l’offre Pro.

Avant de commencer : les offres et le mode de connexion

Le point à vérifier d’abord, c’est votre offre Google. Le 19 mai 2026, Google a annoncé que Gemini CLI cesserait de servir les abonnés Google AI Pro et Ultra et les utilisateurs gratuits le 18 juin 2026, au profit d’Antigravity CLI (annonce de Google).

Nous n’avons pas encore testé Apogee dans Antigravity CLI : cette page ne le décrit pas. L’adresse du serveur, elle, ne change pas. Pour situer Apogee parmi les autres options, dont le MCP officiel de Meta, voyez le guide Meta Ads MCP.

Deux façons de se connecter :

• OAuth, le mode par défaut : vous vous connectez à Apogee dans le navigateur et vous choisissez les accès. Il faut un navigateur sur le même ordinateur.
• Clé d’API Apogee, pour une machine sans navigateur (serveur distant, conteneur).

Gemini CLI MCP : ajouter Apogee pas à pas

Les étapes suivent le guide de connexion d’Apogee et la documentation MCP de Gemini CLI, relue le 3 novembre 2026.

1. Dans votre terminal, ajoutez le serveur :

   gemini mcp add --transport http apogee https://app.apogee.ad/mcp

2. Ouvrez Gemini CLI et lancez /mcp auth apogee.

3. Le navigateur affiche la page de connexion d’Apogee : identifiez-vous, choisissez les accès, cliquez sur Authorize.

4. Revenez dans Gemini CLI et posez votre première question.

Par défaut, le serveur n’est ajouté qu’au projet en cours. Ajoutez --scope user à la commande pour retrouver Apogee dans tous vos projets, y compris le dossier où arrivent vos créas.

Les accès que vous donnez

Gemini CLI tourne sur votre ordinateur et revient sur une adresse localhost après la connexion. La page d’Apogee titre donc An app on this computer wants to access your Apogee account et affiche le nom déclaré, « Gemini CLI ». N’autorisez que si vous venez de lancer /mcp auth apogee vous-même ; sinon, cliquez sur Cancel.

Un usage en lecture seule se contente de Read. Décochez ce dont Gemini CLI n’a pas besoin.

Sans navigateur : la clé d’API

1. Dans Apogee, ouvrez Settings → API et cliquez sur Create an API key.

2. Donnez-lui un Name (par exemple « Gemini CLI »), cochez seulement les Scopes utiles et choisissez Expires : 30 jours, 90 jours par défaut, 1 an ou une date.

3. Cliquez sur Create key, copiez la clé tout de suite (Apogee ne l’affiche qu’une fois), puis I saved it.

4. Ajoutez le serveur avec la clé :

   gemini mcp add --transport http \
     --header "Authorization: Bearer apk_…" apogee https://app.apogee.ad/mcp

Remplacez apk_… par votre clé. Sur une clé, l’accès Manage s’appelle Actions.

Vérifier la connexion

Dans Gemini CLI, /mcp affiche l’état de chaque serveur : Apogee doit être CONNECTED, avec ses outils. Depuis le terminal, gemini mcp list donne la même information. Puis la première demande, en lecture seule :

Gemini CLI appelle whoami, puis list_ad_accounts. Côté Apogee, Settings → MCP montre Gemini CLI dans Connected assistants, avec ses accès, sa date de connexion et sa dernière utilisation.

Gemini CLI sur Meta Ads : lancer un dossier de créas

C’est ce qu’un outil de terminal fait mieux qu’un chat : envoyer les créas d’un dossier de votre ordinateur, sans passer par Drive.

Ce que fait Gemini CLI, avec les outils d’Apogee :

1. Le compte : list_ad_accounts, et il vous demande lequel s’il y en a plusieurs.
2. Les fichiers : get_upload_urls donne un lien d’envoi par fichier (50 fichiers par appel, 500 Mo au plus chacun), Gemini CLI envoie chaque fichier, puis confirm_uploads vérifie qu’il est arrivé. Rien n’est chez Meta à ce stade.
3. Les réglages : get_latest_in_campaign reprend le dernier ad set et la dernière ad de la campagne.
4. L’entretien : get_launch_questions renvoie les questions de l’application Apogee, dans son ordre, avec une réponse recommandée. Gemini CLI les pose un sujet à la fois et ne répond jamais à votre place.
5. Les ads et les textes : une créa en 9:16, 4:5 et 1:1 forme une seule ad ; un texte principal, un titre et une description par ad, dans la langue du marché, à valider.
6. Le récapitulatif, puis le lancement : prepare_launch ne crée rien. Après votre oui, launch, puis launch_status jusqu’au bout.

Dans le récapitulatif, relisez les ads et leurs fichiers, le nom et les réglages du nouvel ad set, les textes, les améliorations Advantage+ (celles que vous n’avez pas choisies restent coupées) et les valeurs par défaut appliquées. Un détail à changer : dites-le, Gemini CLI prépare un nouveau récapitulatif.

Des noms de fichiers qui ne veulent rien dire

IMG_4512.mp4, final_v3_OK(1).mov : Apogee groupe alors les fichiers à la main, comme le Group by hand de l’application. Les formats d’une même créa sont reliés quand leurs noms ne diffèrent que par le format, tout autre fichier devient sa propre ad, et deux fichiers de même durée dans des formats différents vous sont soumis avant d’être reliés.

Aucun fichier n’est renommé sur votre disque : vous renommez les ads dans la conversation.

Gemini CLI sur TikTok Ads et Snapchat Ads

Envoyer les winners Meta avec le Bridge

Le Bridge d’Apogee relance une ad Meta sur TikTok ou Snapchat, en pause, avec des textes adaptés à la régie, sans toucher à l’ad d’origine :

Dans le terminal, vous voyez chaque appel : get_top_performers pour le classement, list_bridge_transfers pour écarter ce qui est déjà parti, prepare_bridge_transfer pour le récapitulatif, bridge_transfer après votre oui. Au premier envoi, Gemini CLI demande l’identité TikTok et le call to action, que Meta ne fournit pas. Seules les vidéos font le voyage.

Lancer directement sur TikTok et Snapchat

Le parcours est celui de Meta, avec le compte TikTok ou Snapchat nommé dans la demande. TikTok crée un ad group, où une image devient un carrousel ; Snapchat crée un ad squad. Avec un modèle enregistré dans l’application :

Chaque régie a son récapitulatif et attend son propre oui. Ce que chaque régie accepte est détaillé sur la page Meta, TikTok et Snapchat dans Apogee.

Le brief du matin et la revue du lundi dans le terminal

Gemini CLI ne travaille que quand vous l’ouvrez. Le matin, une demande suffit :

Le lundi, la revue qui décide quoi pousser et quoi couper :

Sur Meta, les pauses passent par pause_ad ou pause_adset et les budgets par update_budget ou scale_budget ; sur TikTok et Snapchat, par set_platform_status et set_platform_daily_budget. Ces outils ne font que préparer : execute_action agit après votre oui. Il faut l’accès Manage. Pour un brief qui arrive chaque matin sans que vous ouvriez le terminal, il faut un agent personnel : Claude Duet, ChatGPT dots, Grok Bot ou Muse, chacun avec son guide.

Limites et sécurité

Gemini CLI lit librement. Pour tout le reste, Apogee prépare un plan, rend un récapitulatif et attend votre oui :

Chaque fichier envoyé pèse 500 Mo au plus ; sur Pro, un compte reçoit jusqu’à 2 000 fichiers et 100 Go par jour. Les lectures sont gratuites dans la limite quotidienne de votre offre (5 000 par jour sur Pro). Une ad créée coûte 15 crédits, une modification 2, comptés seulement en cas de succès. Apogee n’additionne jamais Meta, TikTok et Snapchat : chaque régie garde sa devise et son attribution.

Pour couper l’accès : Settings → MCP, Disconnect à côté de Gemini CLI. Avec une clé d’API : Settings → API, Revoke.

Problèmes fréquents

• 401 : la connexion a expiré ou la clé est fausse, révoquée ou expirée. Relancez /mcp auth apogee, ou créez une nouvelle clé.
• 403 : votre offre Apogee n’inclut pas le serveur MCP. Il est inclus dès l’offre Pro.
• Aucun navigateur ne s’ouvre : la connexion OAuth en a besoin sur le même ordinateur. Passez par la clé d’API.
• Apogee n’apparaît que dans un projet : ajoutez --scope user à la commande d’ajout.
• Un outil refuse faute d’accès : la connexion n’a pas l’accès voulu (Launch pour lancer, Manage pour les pauses). Déconnectez Gemini CLI dans Settings → MCP, relancez /mcp auth apogee et cochez l’accès manquant.
• Gemini CLI ne répond plus avec votre compte Google : vous êtes sur Google AI Pro, Ultra ou un compte gratuit, passés sur Antigravity CLI le 18 juin 2026.

Pour aller plus loin

• Claude Code et le serveur MCP d’Apogee, l’autre outil de terminal ;
• Apogee face au MCP officiel de Meta Ads, et ses équivalents pour TikTok Ads et Snapchat Ads ;
• Le guide technique de Gemini CLI avec Apogee, avec tous les outils cités ici.