Conecta TikTok Ads a Claude Code con un solo comando
Claude Code
Conecta TikTok 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 a tus cuentas de anunciante de TikTok con 24 herramientas: rendimiento por anunciante, campaña, grupo y anuncio, más pausas, activaciones y cambios de presupuesto y puja en campañas existentes. Pregunta antes de ejecutar cada herramienta.
Nivel Manage. Claude Code trabaja sobre campañas que ya tienes activas. No crea campañas nuevas de TikTok.
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 TikTok 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 TikTok Ads en el panel de PaidSync
Pulsa Conectar en TikTok Ads e inicia sesión con la cuenta de TikTok que tiene acceso a tus cuentas de anunciante. TikTok Ads autoriza mediante TikTok OAuth. PaidSync guarda los tokens cifrados en reposo con AES-256-GCM.
¿Ya estás dentro de Claude Code? Pídele que ejecute connect_tiktok_ads. La herramienta devuelve un enlace OAuth para abrir en tu navegador.
3Elige el anunciante en el que debe trabajar Claude Code
Dentro de una sesión, list_tiktok_advertisers muestra todas las cuentas de anunciante a las que llega tu acceso de TikTok, y set_active_tiktok_advertiser elige aquella en la que trabaja Claude Code. Las escrituras en TikTok requieren primero un anunciante activo.
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: “Muéstrame el gasto y las conversiones de TikTok por campaña de los últimos 7 días”
Claude Code devuelve impresiones, clics, CTR, CPC, CPM, gasto y conversiones 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 TikTok Ads en Claude Code
Cada prompt de abajo corresponde a herramientas del grupo TikTok Ads de PaidSync. Claude Code elige la herramienta. La última columna indica si la llamada puede cambiar algo en la cuenta de anunciante.
| Petición | Herramientas que llama | Cambia tu cuenta |
|---|---|---|
| “List my TikTok advertiser accounts and make Acme the active one” | list_tiktok_advertisers, set_active_tiktok_advertiser | No |
| “Show spend, CTR and conversions by campaign for the last 7 days” | get_tiktok_performance | No |
| “Drill into ad level for the top campaign” | get_tiktok_performance, list_tiktok_ads | No |
| “List the ad groups in this campaign with status and budget” | list_tiktok_adgroups | No |
| “Pause the campaign with the worst cost per conversion” | pause_tiktok_campaign | Sí, después de que confirmes |
| “Raise the budget on the Spring Sale campaign to $150” | update_tiktok_campaign_budget | Sí, después de que confirmes |
| “Lower the bid on this ad group to $0.80” | update_tiktok_adgroup | 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 TikTok performance at ad level and list the ads with the highest spend and no conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/tiktok-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 24 herramientas de TikTok Ads, 11 solo leen y 11 pueden escribir. Las de lectura cubren anunciantes, campañas, grupos de anuncios, anuncios y rendimiento.
Leer más
Las de escritura cubren pausar y activar campañas, presupuestos de campaña, nombres de campaña, y estado, presupuesto, puja y nombre de grupos de anuncios.
Los cambios en grupos de anuncios y los cambios de presupuesto y nombre de campaña se previsualizan por defecto con dry_run. Pausar o activar una campaña no tiene simulación y requiere 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.
Lo que Claude Code no puede hacer en TikTok
- PaidSync no crea campañas, grupos de anuncios ni anuncios de TikTok. Créalos en TikTok Ads Manager y luego gestiónalos desde Claude Code.
- PaidSync no tiene herramientas de audiencias ni de carga de creatividades para TikTok.
update_tiktok_campaignsolo cambia el nombre. El estado se cambia conpause_tiktok_campaignyenable_tiktok_campaign, y el presupuesto conupdate_tiktok_campaign_budget.- Un cambio de precio de puja en un grupo de anuncios solo se aplica cuando el grupo usa un tipo de puja personalizada.
- Los informes de TikTok van con un retraso de una a dos horas, así que una consulta a las 9 h muestra datos hasta aproximadamente las 7 h u 8 h.
Preguntas frecuentes
¿Cómo conecto TikTok Ads con Claude Code?
Regístrate en paidsync.ai, conecta TikTok Ads mediante TikTok OAuth en el panel, y luego 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 TikTok?
Sí. PaidSync crea campañas, grupos de anuncios y anuncios de vídeo de TikTok, todos en pausa. Claude Code también puede informar sobre campañas existentes, pausarlas y activarlas, y cambiar presupuestos y pujas de grupos de anuncios.
¿Puede Claude Code cambiar los presupuestos de TikTok?
Sí. update_tiktok_campaign_budget cambia el presupuesto de una campaña y update_tiktok_adgroup cambia el de un grupo de anuncios. 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 TikTok. Un comando en Claude Code.