ChatGPT Ads en Claude Code, un comando
Claude Code
Para conectar ChatGPT Ads a Claude Code, añade PaidSync.ai: ejecuta claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, escribe /mcp e inicia sesión con tu cuenta de PaidSync.
Claude Code llega a tus cuentas de ChatGPT Ads con 28 herramientas: informes de campañas, grupos de anuncios y anuncios, y crear campañas, grupos y anuncios chat card, y pausar, activar, actualizar y archivar lo que corre. Claude Code pregunta antes de cada herramienta.
Nivel build. Claude Code puede crear campañas, grupos de anuncios y anuncios de ChatGPT Ads, y los grupos de anuncios nuevos empiezan en pausa hasta que los actives.
El comando
Claude Code se comunica con servidores MCP remotos mediante Streamable HTTP. PaidSync es uno de ellos. Añádelo una vez y la misma terminal que edita tu código puede informar sobre tus campañas de ChatGPT Ads y gestionarlas.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor defecto, eso registra el servidor solo para el proyecto actual. Añade --scope user para que esté disponible en todos los proyectos de tu equipo.
Ejecuta claude mcp list para confirmar que está ahí, luego inicia una sesión y escribe /mcp para iniciar sesión.
Configuración en 5 pasos
1Regístrate en paidsync.ai/signup
Lleva 10 segundos. Inicio de sesión con Google o con correo. El plan gratuito incluye 100 tareas al mes, con un valor de $50, a $0, sin tarjeta.
2Conecta ChatGPT Ads en el panel de PaidSync
Haz clic en Conectar en ChatGPT Ads. Inicia sesión con la cuenta de OpenAI que puede abrir tu cuenta publicitaria en ChatGPT Ads Manager y pega tu API key de OpenAI Ads. Crea la clave en Settings de tu cuenta publicitaria en ChatGPT Ads Manager en ads.openai.com. Cada clave conecta exactamente una cuenta publicitaria, y las claves de platform.openai.com se rechazan. PaidSync cifra la clave en reposo.
¿Ya estás dentro de Claude Code? Pídele que ejecute connect_openai_ads. La herramienta devuelve un enlace a tu panel de PaidSync, donde pegas la clave.
3Elige la cuenta publicitaria en la que debe trabajar Claude Code
Dentro de una sesión, list_openai_accounts muestra tus cuentas de ChatGPT Ads conectadas, y set_active_openai_account elige aquella en la que trabaja Claude Code.
4Añade PaidSync a Claude Code
En tu terminal, ejecuta:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicia una sesión, escribe /mcp, elige paidsync e inicia sesión con tu acceso de PaidSync en la ventana del navegador que se abre. Claude Code guarda el token OAuth por ti. No se pega ninguna clave en ningún sitio.
¿Lo configuras para un equipo? Sube un .mcp.json en la raíz del repositorio para que cada ingeniero reciba el mismo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}¿Prefieres una clave API, por ejemplo para ejecuciones sin interfaz? Envíala en una cabecera, nunca en la URL, donde acabaría en los registros:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"En un .mcp.json versionado, añade "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que la clave se quede en el entorno de cada ingeniero y nunca entre en git. Aplicar un cambio en Google Ads sigue requiriendo el inicio de sesión OAuth. En otras plataformas una clave también puede aplicar cambios, así que trátala como una contraseña y prefiere OAuth.
5Prueba la conexión
En una sesión de Claude Code pregunta: “Show me my ChatGPT Ads campaigns for the last 7 days with spend, clicks and impressions”
Claude Code devuelve gasto, clics e impresiones de cada campaña. La conexión está activa.
El plan gratuito incluye 100 tareas al mes. Pro desde $99 al mes, Team desde $249.
Prompts ChatGPT Ads en Claude Code
Cada prompt de abajo corresponde a herramientas del grupo ChatGPT Ads de PaidSync. Claude Code elige la herramienta. La última columna indica si la llamada puede cambiar algo en la cuenta publicitaria.
| Petición | Herramientas que llama | Cambia tu cuenta |
|---|---|---|
| “List my ChatGPT Ads accounts and make Acme the active one” | list_openai_accounts, set_active_openai_account | No |
| “Show campaigns for the last 7 days with spend, clicks and impressions” | list_openai_campaigns, get_openai_performance | No |
| “List every ad group in the Spring Sale campaign with its status” | list_openai_adgroups | No |
| “Which ads are live right now” | list_openai_ads | No |
| “Pause the Retargeting ad group” | pause_openai_adgroup | Sí, después de que confirmes |
| “Create a campaign called Spring Launch with a daily budget” | create_openai_campaign | Sí, después de que confirmes |
| “Archive the old Winter campaign” | archive_openai_campaign | Sí, después de que confirmes |
Ejecútalo en modo headless con claude -p
El indicador -p ejecuta Claude Code sin la sesión interactiva. Inicia sesión una vez con /mcp y el token de OAuth guardado se mantiene. Un informe que termina en un archivo se ve así:
claude -p "Pull last 7 days ChatGPT Ads performance by campaign and list the campaigns with spend and no clicks." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/chatgpt-ads-$(date +%F).jsonLas lecturas se ejecutan directamente, y las escrituras también. --allowedTools "mcp__paidsync" permite todas las herramientas de PaidSync, escrituras incluidas, sin aviso.
Para un trabajo desatendido, permite solo las herramientas de lectura que necesite, cada una por nombre como mcp__paidsync__tool_name.
Qué lee y qué escribe
PaidSync tiene 28 herramientas de ChatGPT Ads que leen, crean y gestionan. Las lecturas cubren cuentas, campañas, grupos de anuncios, anuncios, rendimiento y segmentaciones geográficas.
Leer más
Las escrituras cubren crear campañas, grupos de anuncios y anuncios de tipo chat card, subir imágenes de creatividad, y pausar, activar, actualizar y archivar campañas, grupos de anuncios y anuncios.
Las creaciones y actualizaciones se muestran antes por defecto con dry_run, y las pausas, activaciones y archivados requieren una confirmación explícita.
Con MCP, el paso de aprobación es el propio aviso de Claude Code. Pregunta antes de ejecutar una herramienta, salvo que la hayas permitido con --allowedTools o en tus ajustes. PaidSync añade comprobaciones por su parte. Las eliminaciones, pausas y cambios de presupuesto requieren confirm_destructive, y una comprobación de reglas previa a la escritura bloquea los argumentos inseguros. La tarjeta de aprobación, y Undo en una tarjeta aplicada cuyo cambio tiene una inversa segura, solo se aplican en el espacio de trabajo de PaidSync.
Añadir a ChatGPT: abre PaidSync.ai en el directorio de plugins de ChatGPT, instálalo e inicia sesión.
Añadir a Claude: abre PaidSync.ai en el directorio de conectores de Claude, haz clic en Conectar e inicia sesión.
Qué no hace Claude Code en ChatGPT Ads
- La creatividad de vídeo no se expone como herramienta. Las imágenes de creatividad se suben con
upload_openai_creative_image. - No hay herramientas de gestión de audiencias. La configuración de audiencias se queda en ChatGPT Ads Manager.
- No hay cambios de facturación ni de pago. Presupuestos sí, métodos de pago nunca.
- Archivar es permanente, así que Claude Code lo indica antes de ejecutarse.
- Crear una campaña con tres grupos de anuncios son cuatro tareas separadas, un objeto por tarea.
Preguntas frecuentes
¿Cómo conecto ChatGPT Ads a Claude Code?
Regístrate en paidsync.ai, conecta ChatGPT Ads en el panel y ejecuta claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp en tu terminal. Escribe /mcp dentro de una sesión, elige paidsync e inicia sesión con tu cuenta de PaidSync.
¿Puede Claude Code crear campañas de ChatGPT Ads?
Sí. ChatGPT Ads es una plataforma de nivel build en PaidSync. Claude Code puede crear una campaña, sus grupos de anuncios y anuncios de tipo chat card, y subir imágenes de creatividad. Las creaciones se muestran antes como simulación.
¿Dónde consigo la API key de OpenAI Ads?
Créala en Settings de tu cuenta publicitaria en ChatGPT Ads Manager en ads.openai.com. Cada clave conecta exactamente una cuenta publicitaria, así que conecta una clave por cuenta. Las claves de platform.openai.com se rechazan para anuncios.
¿Funciona en modo headless con claude -p?
Sí. Una vez que has iniciado sesión con /mcp, claude -p reutiliza el token de OAuth guardado. Las lecturas se ejecutan directamente. Las escrituras requieren cuidado. No hay nadie para responder al aviso de Claude Code, así que cualquier herramienta de escritura que hayas permitido con --allowedTools se ejecuta directamente. Para un trabajo desatendido, permite solo las herramientas de lectura que necesite.
Es gratis
Sí. El plan gratuito cuesta $0 por 100 tareas al mes, sin tarjeta. Pro empieza en $99 al mes y Team en $249 al mes.
Informes y creación de campañas de ChatGPT Ads. Un comando en Claude Code.