Meta Ads en Claude Code, un comando
Claude Code
Conecta Meta Ads a Claude Code: ejecuta claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, escribe /mcp y entra con tu cuenta de PaidSync.ai.
Claude Code llega a tus cuentas de Meta con 92 herramientas: rendimiento por ubicación, edad, país y dispositivo, conjuntos de anuncios, audiencias, creatividades y campañas. Claude Code pregunta antes de cada herramienta, y la mayoría de las escrituras en Meta se simulan antes.
Un comando. Login OAuth, sin claves. Plan gratis, 100 tareas al mes, valor $50, sin tarjeta.
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 leer y cambiar tus cuentas publicitarias de Meta.
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 correo. El plan gratuito son 100 tareas al mes a $0, sin tarjeta.
2Conecta Meta Ads en el panel de PaidSync
Haz clic en Conectar en Meta Ads e inicia sesión con la cuenta de Facebook que gestiona tu Business Manager. Meta Ads se autoriza mediante Facebook OAuth con los permisos ads_read y ads_management. PaidSync guarda los tokens cifrados en reposo con AES-256-GCM.
¿Ya estás dentro de Claude Code? Pídele que ejecute connect_facebook_ads. La herramienta devuelve un enlace OAuth para abrir en tu navegador.
3Elige la cuenta publicitaria en la que debe trabajar Claude Code
Tras iniciar sesión, PaidSync lista las cuentas publicitarias de Meta a las que llega ese acceso. Marca las que pertenecen a este espacio de trabajo. Dentro de una sesión, list_fb_ad_accounts las muestra y set_fb_ad_account elige la activa.
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 pide: “Muéstrame el rendimiento de Meta de los últimos 7 días por campaña”
Claude Code devuelve gasto, impresiones, clics, CTR, CPC y ROAS de cada campaña en la cuenta publicitaria activa. La conexión está activa.
El plan gratuito incluye 100 tareas al mes. Pro desde $99 al mes, Team desde $249.
Prompts Meta Ads en Claude Code
Cada prompt de abajo corresponde a herramientas del grupo Meta 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 |
|---|---|---|
| “Muestra el rendimiento de campañas de los últimos 7 días con gasto, CTR, CPC y ROAS” | get_fb_performance | No |
| “¿Qué ubicaciones lograron las conversiones más baratas este mes?” | get_fb_performance_by_placement | No |
| “Ordena todos los anuncios por CTR de los últimos 14 días” | get_fb_ad_performance | No |
| “¿Cómo va el ritmo de presupuesto este mes en la cuenta activa?” | get_fb_budget_pacing | No |
| “Pausa los tres conjuntos de anuncios con mayor coste por resultado” | get_fb_adset_performance, pause_fb_adset | Sí, después de que confirmes |
| “Duplica el mejor conjunto de anuncios en la campaña Prospecting con sus anuncios” | duplicate_fb_adset | Sí, después de que confirmes |
| “Crea una audiencia similar al 1 por ciento de la audiencia Purchasers en EE. UU.” | create_fb_lookalike_audience | Sí, después de que confirmes |
| “Redacta una campaña de Sales con un presupuesto diario de $50 y muéstrame la vista previa” | create_fb_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 Meta performance by placement and list the placements with the highest cost per result." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/meta-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
De las 92 herramientas de Meta Ads, 53 solo leen y 36 pueden escribir.
Las lecturas cubren el rendimiento a nivel de campaña, conjunto de anuncios y anuncio, desgloses por edad y género, país, dispositivo, ubicación y tiempo, ritmo de presupuesto, píxeles, catálogos y el registro de actividad de la cuenta.
Leer más
Las escrituras cubren campañas, conjuntos de anuncios, anuncios, creatividades, audiencias, formularios de clientes potenciales, reglas automatizadas y calendarios de presupuesto. Cada una se previsualiza por defecto con dry_run, salvo upload_fb_ad_image y upload_fb_ad_video, que se aplican en la primera llamada.
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.
Límites a conocer
delete_fb_campaignydelete_fb_audienceson permanentes. Pausa en su lugar cuando quieras conservar el historial.- Un conjunto de anuncios duplicado queda en pausa y, por defecto, sin sus anuncios. Pasa
deep_copypara copiar también los anuncios. get_fb_leadsdevuelve nombres, correos y números de teléfono. Si escribes la salida en un archivo de un repositorio, mantén ese archivo fuera del control de versiones.- Dónde está el presupuesto decide el resto. Un presupuesto en la campaña significa que Meta lo reparte entre los conjuntos de anuncios. Si lo dejas sin definir, cada conjunto de anuncios lleva el suyo.
Preguntas frecuentes
¿Cómo conecto Meta Ads con Claude Code?
Regístrate en paidsync.ai, conecta Meta Ads mediante Facebook OAuth 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 acceso de PaidSync.
¿Puede Claude Code crear campañas de Meta?
Sí. Meta Ads es una plataforma de nivel build en PaidSync. Claude Code puede crear campañas, conjuntos de anuncios, anuncios y audiencias. La mayoría de las escrituras se previsualizan primero como simulación, y Claude Code pregunta antes de ejecutar cada herramienta. Las subidas de imágenes y vídeos se aplican en la primera llamada.
¿Qué permisos de Meta solicita PaidSync?
PaidSync solicita ads_read y ads_management mediante Facebook OAuth. Eso cubre lecturas y escrituras en campañas, conjuntos de anuncios, anuncios, audiencias y datos de rendimiento de las cuentas publicitarias que conectes.
¿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.
92 tools Meta Ads. Un comando en Claude Code.