Conecta X Ads a Claude Code con un solo comando
Claude Code
Conecta X 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 accede entonces a tus cuentas publicitarias de X con 14 herramientas: rendimiento por cuenta, campaña o line item, además de pausas, activaciones y cambios de presupuesto y puja en campañas existentes. Claude Code pregunta antes de ejecutar cada herramienta.
Nivel Manage. Claude Code trabaja sobre campañas que ya tienes activas. No crea campañas nuevas de X.
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 podrá informar sobre tus campañas de X 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 X Ads en el panel de PaidSync
Pulsa Conectar en X Ads e inicia sesión con la cuenta de X que puede abrir tus cuentas publicitarias, y luego autoriza a PaidSync. X Ads autoriza mediante X OAuth, y PaidSync nunca ve tu contraseña de X.
¿Ya estás dentro de Claude Code? Pídele que ejecute connect_x_ads. La herramienta devuelve un enlace para abrir en tu navegador.
3Elige la cuenta publicitaria en la que debe trabajar Claude Code
Dentro de una sesión, list_x_accounts muestra todas las cuentas publicitarias a las que llega tu acceso de X, y set_active_x_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 pide: “Show me X spend, impressions and clicks by campaign for the last 7 days”
Claude Code devuelve gasto, impresiones, clics e interacciones de cada campaña. La conexión es en vivo.
El plan gratuito incluye 100 tareas al mes. Pro desde $99 al mes, Team desde $249.
Prompts de X Ads para probar en Claude Code
Cada prompt de abajo corresponde a herramientas del grupo X 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 |
|---|---|---|
| “Lista mis cuentas publicitarias de X y activa Acme” | list_x_accounts, set_active_x_account | No |
| “Show my campaigns from the last 7 days with spend, impressions, clicks and engagements” | get_x_performance | No |
| “Which line items spent the most in the last 30 days” | get_x_performance | No |
| “List the line items in this campaign” | list_x_line_items | No |
| “Pausa la campaña Spring Launch” | list_x_campaigns, pause_x_campaign | Sí, después de que confirmes |
| “Set the daily budget on the Retargeting campaign to 80” | update_x_campaign_budget | Sí, después de que confirmes |
| “Lower the bid on the Lookalikes line item to 1.50” | list_x_line_items, update_x_line_item | 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 30 days X performance at line item level and list the line items with the highest spend and no clicks." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/x-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 14 herramientas de X Ads, 7 solo leen y 5 pueden escribir. Las de lectura cubren cuentas publicitarias, campañas, line items, publicaciones promocionadas y rendimiento.
Leer más
Las de escritura cubren pausar y activar campañas, presupuestos diarios de campaña, estado y pujas de line items, y nombres de campañas y line items.
Las ediciones de presupuesto, puja, nombre y estado mediante las herramientas de actualización se previsualizan por defecto con dry_run, y PaidSync vuelve a leer cada cambio desde X después.
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.
Lo que Claude Code no puede hacer en X
- PaidSync no crea campañas, line items ni publicaciones promocionadas de X. Créalos en X Ads Manager y gestiónalos después desde Claude Code.
- No hay herramientas de carga de creatividades.
- PaidSync no tiene herramienta de X para segmentación, audiencias personalizadas ni informes de conversiones.
- Los line items se pausan y activan con
update_x_line_item, y las campañas conpause_x_campaignyenable_x_campaign. - Los importes están en la moneda y la zona horaria propias de la cuenta publicitaria.
Preguntas frecuentes
¿Cómo conecto X Ads con Claude Code?
Regístrate en paidsync.ai, conecta X Ads mediante 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 X?
No. X Ads es una plataforma de nivel de gestión en PaidSync. Claude Code puede informar sobre campañas existentes, pausarlas y activarlas, y cambiar presupuestos y pujas de line items. Las campañas nuevas se crean en X Ads Manager.
¿Puede Claude Code cambiar los presupuestos de X Ads?
Sí. update_x_campaign_budget cambia el presupuesto diario de una campaña y update_x_line_item cambia la puja de un line item. Ambas se previsualizan primero como simulación, y Claude Code pregunta antes de ejecutar cada herramienta.
¿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 gestión de campañas de X Ads. Un comando en Claude Code.