Cursor MCP: añadir el servidor de Apogee para sus Facebook Ads

Cursor MCP, en la práctica: una clave de API de Apogee en ~/.cursor/mcp.json, y el agente de Cursor lee, lanza y pausa sus anuncios de Meta, TikTok y Snapchat sin salir del editor. Como trabaja en su ordenador, lanza directamente la carpeta donde su editor de video deja las exportaciones. Hace falta un plan de Apogee que incluya el servidor MCP, desde Pro, y una clave limitada a los accesos que Cursor necesita. No sale nada sin su sí.

Antes de empezar

Grok Bot, el agente personal de xAI operado con Cursor, pasa por este mismo cliente MCP: si es él a quien quiere conectar, siga la guía de Grok Bot con Apogee. Para comparar Apogee con otros servidores, incluido el MCP oficial de Meta, consulte el panorama de los MCP de Meta Ads.

Cursor MCP: añadir Apogee en tres pasos

Paso 1: crear una clave de API en Apogee

1. En Apogee, abra Settings → API y cree una clave. En Settings → MCP, con Cursor seleccionado, el botón Create an API key lleva al mismo sitio.
2. Rellene Name: un nombre que diga para qué sirve la clave, por ejemplo «Cursor».
3. En Scopes, marque solo lo que Cursor necesita (tabla a continuación).
4. En Expires, elija 30 días, 90 días (por defecto), 1 año, o una fecha de hasta un año.
5. Cree la clave y cópiela en ese momento: Apogee solo la muestra una vez.

Dé a la clave solo los accesos necesarios. Si también conecta un script de informes, dele su propia clave, de solo lectura.

Paso 2: añadir Apogee en ~/.cursor/mcp.json

Abra ~/.cursor/mcp.json (créelo si no existe) y añada Apogee con su clave:

{
  "mcpServers": {
    "apogee": {
      "url": "https://app.apogee.ad/mcp",
      "headers": {
        "Authorization": "Bearer apk_…"
      }
    }
  }
}

Sustituya apk_… por su clave. Si el archivo ya contiene otros servidores, añada el bloque apogee junto a ellos, dentro de mcpServers.

Dos reglas de seguridad:

• Guarde la clave en ~/.cursor/mcp.json, que solo le pertenece a usted, nunca en el .cursor/mcp.json de un proyecto que comparte: ese archivo suele acabar en el repositorio Git.
• Para no escribir la clave en claro, sustituya el valor por "Bearer ${env:APOGEE_API_KEY}" y defina APOGEE_API_KEY en su entorno. Cursor resuelve estas variables en url y headers.

Paso 3: activar Apogee en Customize

En Cursor, abra Customize en la barra lateral, busque Apogee y active su interruptor. Un servidor desactivado no se carga ni aparece en el chat. Después abra el chat del agente.

Comprobar la conexión

Por defecto, Cursor pide su aprobación antes de usar una herramienta MCP. El agente llama a whoami, que responde con la cuenta de Apogee, el tipo de conexión (aquí una clave de API) y sus accesos, y después a list_ad_accounts. Dos lecturas, no cambia nada. Si el agente no encuentra Apogee, abra el panel Output (Cmd+Shift+U) y elija MCP Logs.

¿Y la conexión con OAuth?

Según la guía de Apogee, Cursor también inicia sesión con OAuth, sin clave que copiar. La guía no describe los menús de Cursor para esta vía: si los suyos son distintos, quédese con la clave. Cuando Cursor abre la página de Apogee, esta muestra «Cursor wants to access your Apogee account», la cuenta en uso con Switch, los accesos Read, Launch y Manage que marcar y, después, Cancel y Authorize. Para la aplicación de escritorio, la última línea indica «You will go back to anysphere.cursor-mcp».

Tras Authorize, Cursor aparece en Settings → MCP, lista Connected assistants, con sus accesos, su fecha de conexión y su último uso. Esa lista solo muestra las conexiones OAuth: una clave de API se gestiona en Settings → API, lista API keys.

Qué pedirle a Cursor después: el trabajo de media buyer

Cursor tiene una ventaja sobre las apps de chat: lee los archivos de su ordenador y los sube él mismo a Apogee, sin pasar por Google Drive ni Dropbox.

Lanzar una carpeta del ordenador en Meta Ads

Cursor envía hasta 50 archivos por llamada, de 500 MB como máximo cada uno, a direcciones válidas durante una hora. El tope diario de una cuenta de Apogee es de 2000 archivos y 100 GB en Pro, y 4000 archivos y 200 GB en Growth y Scale. Meta no recibe nada antes de su sí.

La misma carpeta en TikTok Ads y Snapchat Ads

TikTok y Snapchat aceptan videos e imágenes desde el almacenamiento de Apogee; en TikTok, una imagen se publica como carrusel. Indique la plataforma y el agente retoma la plantilla que guardó en la aplicación (Quick Bulk Edit y después Save as template):

El agente lee sus plantillas con list_platform_templates, sin guardar ni borrar ninguna. Cada plataforma tiene su resumen, su presupuesto y su moneda, y espera su propio sí. El detalle está en la página Meta, TikTok y Snapchat en Apogee.

Enviar los ganadores de Meta a TikTok y Snapchat

Sus ganadores de Meta también pueden funcionar en TikTok y Snapchat: el Bridge de Apogee hace copias en pausa, y los anuncios de Meta se quedan como están:

El agente clasifica sus anuncios con get_top_performers, descarta con list_bridge_transfers los que ya se enviaron y muestra el resumen de prepare_bridge_transfer; bridge_transfer espera su sí. En la primera transferencia, le pide la identidad de TikTok y la llamada a la acción, que Meta no tiene. Los anuncios de imagen se quedan en Meta: el Bridge solo lleva videos.

El resumen de la mañana

El informe solo necesita una clave limitada al acceso Read: get_account_overview y get_top_performers en Meta, get_platform_overview y get_platform_top_performers en TikTok y Snapchat, gratuitas dentro del límite diario de su plan (5000 lecturas al día en Pro).

Cortar los anuncios que se fatigan

Tras leer los resultados y get_creative_fatigue_metrics, el agente guarda las pausas como acciones preparadas (pause_ad en Meta, set_platform_status en TikTok); execute_action solo se ejecuta con su sí y requiere el acceso Actions. Una pausa ejecutada cuesta 2 créditos, solo si sale bien.

Límites y seguridad

En el lado de Cursor. Cursor pide su aprobación antes de usar una herramienta MCP. En el modo Auto-review, las herramientas MCP de una lista autorizada se ejecutan de inmediato: no ponga nunca en ella launch, execute_action ni bridge_transfer. En Enterprise, un administrador puede fijar una MCP Allowlist: los servidores aprobados y las herramientas que se ejecutan sin preguntar.

En el lado de la clave. Una clave por uso, con fecha de caducidad. Una cuenta de Apogee mantiene como máximo 10 claves activas. Regenerate crea una clave nueva con el mismo nombre y los mismos accesos, y detiene la anterior.

En el lado de Apogee, sean cuales sean los ajustes de Cursor:

El servidor MCP de Apogee no crea catálogos ni audiencias, y nunca suma Meta, TikTok y Snapchat. Para cortar el acceso: Revoke en la clave, en Settings → API, lista API keys (definitivo e inmediato), o Disconnect junto a Cursor en Settings → MCP para una conexión OAuth. Los anuncios ya lanzados siguen en su sitio.

Problemas frecuentes

• 401: la clave falta, está mal copiada, es desconocida, está revocada o ha caducado; Apogee responde el mismo 401 en todos los casos. Revise la cabecera Bearer apk_…, o regenere la clave. Con ${env:APOGEE_API_KEY}, compruebe que la variable está definida allí donde arranca Cursor.
• 403 upgrade_required: su plan de Apogee no incluye el servidor MCP (Starter). Pase a Pro, Growth o Scale.
• 403 insufficient_scope, o el agente no encuentra una herramienta: la clave no tiene el acceso correspondiente, por ejemplo Launch para un lanzamiento. Cree una clave con los accesos adecuados.
• Apogee no aparece en el chat: está desactivado en Customize, o el JSON de ~/.cursor/mcp.json no es válido. Consulte MCP Logs en el panel Output.
• Política del administrador: en Cursor Enterprise, si su empresa usa una MCP Allowlist, Apogee debe figurar en ella. Pida al administrador que lo añada.
• 409 too_many_keys: la cuenta ya tiene 10 claves activas. Revoque una antes.
• La clave acabó en un repositorio: revóquela o regenérela de inmediato y ponga la nueva en ~/.cursor/mcp.json.
• 429, demasiadas solicitudes: el servidor MCP acepta 600 llamadas cada 15 minutos en Pro, y 1200 en Growth y Scale. Un lanzamiento solo necesita unas pocas.

Para ir más allá

• las otras herramientas de código: VS Code con GitHub Copilot, Claude Code, Gemini CLI y Devin Desktop;
• Apogee frente al MCP oficial de Meta Ads, y la misma comparativa para TikTok Ads y Snapchat Ads;
• la documentación técnica de Cursor con Apogee, con cada herramienta citada aquí.