Gemini CLI MCP: conectar Apogee en dos comandos

Gemini CLI MCP: bastan dos comandos para conectar Apogee a Gemini CLI. gemini mcp add añade el servidor https://app.apogee.ad/mcp y /mcp auth apogee inicia su sesión en Apogee desde el navegador. A partir de ahí, Gemini CLI lee sus cuentas de Meta, TikTok y Snapchat desde la terminal, lanza sus creatividades y prepara pausas y presupuestos, siempre tras su sí. Necesita un plan que aún dé acceso a Gemini CLI y Apogee desde el plan Pro.

Antes de empezar: los planes y el modo de conexión

Lo primero es revisar su plan de Google. El 19 de mayo de 2026, Google anunció que Gemini CLI dejaría de atender a los suscriptores de Google AI Pro y Ultra y a los usuarios gratuitos el 18 de junio de 2026, en favor de Antigravity CLI (anuncio de Google).

Aún no hemos probado Apogee en Antigravity CLI, así que esta página no lo describe. La dirección del servidor no cambia. Para situar Apogee entre las demás opciones, incluido el MCP oficial de Meta, consulte la guía de Meta Ads MCP.

Dos formas de conectarse:

• OAuth, el modo por defecto: usted inicia sesión en Apogee en el navegador y elige los accesos. Necesita un navegador en el mismo ordenador.
• Una clave de API de Apogee, para una máquina sin navegador (servidor remoto, contenedor).

Gemini CLI MCP: añadir Apogee paso a paso

Los pasos siguen la guía de conexión de Apogee y la documentación MCP de Gemini CLI, revisada el 3 de noviembre de 2026.

1. En la terminal, añada el servidor:

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

2. Abra Gemini CLI y ejecute /mcp auth apogee.

3. El navegador muestra la página de inicio de sesión de Apogee: identifíquese, elija los accesos y haga clic en Authorize.

4. Vuelva a Gemini CLI y haga su primera pregunta.

Por defecto, el servidor solo se añade al proyecto actual. Añada --scope user al comando para tener Apogee en todos sus proyectos, incluida la carpeta donde llegan sus creatividades.

Los accesos que usted concede

Gemini CLI se ejecuta en su ordenador y vuelve a una dirección localhost tras el inicio de sesión. Por eso la página de Apogee dice An app on this computer wants to access your Apogee account y muestra el nombre declarado, «Gemini CLI». Autorice solo si acaba de ejecutar /mcp auth apogee usted mismo; si no, haga clic en Cancel.

Un uso en solo lectura tiene suficiente con Read. Desmarque lo que Gemini CLI no necesite.

Sin navegador: la clave de API

1. En Apogee, abra Settings → API y haga clic en Create an API key.

2. Dele un Name (por ejemplo, «Gemini CLI»), marque solo los Scopes necesarios y elija Expires: 30 días, 90 días por defecto, 1 año o una fecha.

3. Haga clic en Create key, copie la clave enseguida (Apogee solo la muestra una vez) y luego I saved it.

4. Añada el servidor con la clave:

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

Sustituya apk_… por su clave. En una clave, el acceso Manage se llama Actions.

Comprobar la conexión

En Gemini CLI, /mcp muestra el estado de cada servidor: Apogee debe aparecer como CONNECTED, con sus herramientas. Desde la terminal, gemini mcp list da la misma información. Después, la primera petición, en solo lectura:

Gemini CLI llama a whoami y luego a list_ad_accounts. En Apogee, Settings → MCP muestra Gemini CLI en Connected assistants, con sus accesos, su fecha de conexión y su último uso.

Gemini CLI en Meta Ads: lanzar una carpeta de creatividades

Es lo que una herramienta de terminal hace mejor que un chat: enviar las creatividades de una carpeta de su ordenador, sin pasar por Drive.

Lo que hace Gemini CLI, con las herramientas de Apogee:

1. La cuenta: list_ad_accounts, y le pregunta cuál si hay varias.
2. Los archivos: get_upload_urls da un enlace de subida por archivo (50 archivos por llamada, 500 MB como máximo cada uno), Gemini CLI sube cada archivo y confirm_uploads comprueba que ha llegado. En este punto no hay nada en Meta.
3. Los ajustes: get_latest_in_campaign recupera el último conjunto de anuncios y el último anuncio de la campaña.
4. La entrevista: get_launch_questions devuelve las preguntas de la app de Apogee, en su orden, con una respuesta recomendada. Gemini CLI las plantea tema por tema y nunca responde por usted.
5. Los anuncios y los textos: una creatividad en 9:16, 4:5 y 1:1 forma un solo anuncio; un texto principal, un título y una descripción por anuncio, en el idioma del mercado, para que usted los valide.
6. El resumen y, después, el lanzamiento: prepare_launch no crea nada. Tras su sí, launch y luego launch_status hasta el final.

En el resumen, revise los anuncios y sus archivos, el nombre y los ajustes del nuevo conjunto de anuncios, los textos, las mejoras de Advantage+ (las que no eligió siguen desactivadas) y los valores por defecto aplicados. ¿Quiere cambiar un detalle? Dígalo y Gemini CLI prepara un nuevo resumen.

Nombres de archivo que no dicen nada

IMG_4512.mp4, final_v3_OK(1).mov: Apogee agrupa entonces los archivos a mano, como el Group by hand de la app. Los formatos de una misma creatividad se unen cuando sus nombres solo difieren en el formato, cualquier otro archivo se convierte en su propio anuncio, y dos archivos de la misma duración en formatos distintos se le consultan antes de unirlos.

No se renombra ningún archivo en su disco: usted renombra los anuncios en la conversación.

Gemini CLI en TikTok Ads y Snapchat Ads

Enviar los ganadores de Meta con el Bridge

El Bridge de Apogee relanza un anuncio de Meta en TikTok o Snapchat, en pausa, con textos adaptados a la plataforma, sin tocar el anuncio original:

En la terminal, usted ve cada llamada: get_top_performers para la clasificación, list_bridge_transfers para descartar lo que ya pasó, prepare_bridge_transfer para el resumen y bridge_transfer tras su sí. En el primer envío, Gemini CLI pide la identidad de TikTok y la llamada a la acción, que Meta no aporta. Solo los videos hacen el viaje.

Lanzar directamente en TikTok y Snapchat

El proceso es el de Meta, con la cuenta de TikTok o de Snapchat indicada en la petición. TikTok crea un grupo de anuncios (ad group), donde una imagen se convierte en carrusel; Snapchat crea un ad squad. Con una plantilla guardada en la app:

Cada plataforma tiene su propio resumen y espera su propio sí. Lo que acepta cada plataforma está en la página Meta, TikTok y Snapchat en Apogee.

El informe de la mañana y la revisión del lunes en la terminal

Gemini CLI solo trabaja cuando usted lo abre. Por la mañana, basta una petición:

El lunes, la revisión que decide qué escalar y qué cortar:

En Meta, las pausas pasan por pause_ad o pause_adset y los presupuestos por update_budget o scale_budget; en TikTok y Snapchat, por set_platform_status y set_platform_daily_budget. Estas herramientas solo preparan: execute_action actúa tras su sí. Necesitan el acceso Manage. Para un informe que llegue cada mañana sin abrir la terminal, hace falta un agente personal: Claude Duet, ChatGPT dots, Grok Bot o Muse, cada uno con su guía.

Límites y seguridad

Gemini CLI lee libremente. Para todo lo demás, Apogee prepara un plan, devuelve un resumen y espera su sí:

Cada archivo subido pesa 500 MB como máximo; en Pro, una cuenta recibe hasta 2000 archivos y 100 GB al día. Las lecturas son gratuitas dentro del límite diario de su plan (5000 al día en Pro). Un anuncio creado cuesta 15 créditos y un cambio 2, contados solo si salen bien. Apogee nunca suma Meta, TikTok y Snapchat: cada plataforma conserva su moneda y su atribución.

Para cortar el acceso: Settings → MCP, Disconnect junto a Gemini CLI. Con una clave de API: Settings → API, Revoke.

Problemas frecuentes

• 401: la sesión ha caducado o la clave es incorrecta, está revocada o ha caducado. Vuelva a ejecutar /mcp auth apogee o cree una clave nueva.
• 403: su plan de Apogee no incluye el servidor MCP. Está incluido desde el plan Pro.
• No se abre ningún navegador: el inicio de sesión OAuth lo necesita en el mismo ordenador. Use la clave de API.
• Apogee solo aparece en un proyecto: añada --scope user al comando.
• Una herramienta se niega por falta de acceso: la conexión no tiene el acceso necesario (Launch para lanzar, Manage para las pausas). Desconecte Gemini CLI en Settings → MCP, vuelva a ejecutar /mcp auth apogee y marque el acceso que falta.
• Gemini CLI ya no responde con su cuenta de Google: está en Google AI Pro, Ultra o una cuenta gratuita, que pasaron a Antigravity CLI el 18 de junio de 2026.

Para ir más allá

• Claude Code y el servidor MCP de Apogee, la otra herramienta de terminal;
• Apogee frente al MCP oficial de Meta Ads, y la misma comparativa para TikTok Ads y Snapchat Ads;
• La guía técnica de Gemini CLI con Apogee, con todas las herramientas citadas aquí.