Cómo conectar TikTok Ads a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → TikTok Ads, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

TikTok Ads + Cursor

Deja que tu IA analice tus anuncios de TikTok: gasto, impresiones, clics y conversiones por campaña, grupo de anuncios, anuncio, día o audiencia, además de campañas, campañas Smart+, audiencias, píxeles y la biblioteca de creatividades. Puede pausar o activar campañas, grupos de anuncios y anuncios y cambiar presupuestos de campaña cuando actives esas herramientas y lo confirmes.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

TIKTOK_ADS_API_HOST, TIKTOK_ADS_ACCESS_TOKEN, TIKTOK_ADS_ADVERTISER_ID

Paso 1 — Obtener credenciales

1. Inicia sesión en el portal para desarrolladores de TikTok API for Business en https://business-api.tiktok.com/portal con una cuenta de TikTok for Business que tenga acceso a tu cuenta publicitaria y haz clic en Become a Developer.
2. En My Apps → Create an app, introduce un nombre, una descripción y una Advertiser redirect URL (cualquier página https tuya: solo copias un código de su dirección) y marca los scopes de permisos Ad Account Management, Ads Management, Reporting y Audience Management, además de Pixel Management y Creative Management para esas herramientas. TikTok revisa las apps nuevas, normalmente en dos o tres días hábiles.
3. Cuando la app esté aprobada, copia su App ID y su Secret en TIKTOK_ADS_APP_ID y TIKTOK_ADS_APP_SECRET. Ambos son opcionales: el conector solo los usa para listar las cuentas publicitarias que cubre tu token.
4. Abre la Advertiser authorization URL de la app, inicia sesión, marca las cuentas publicitarias y confirma. Tu navegador llega a la URL de redirección con auth_code=... en la barra de direcciones. El código funciona una sola vez y caduca al cabo de una hora.
5. Canjea el código enseguida por un access token de larga duración. Es un paso que solo haces una vez:

   curl -X POST https://business-api.tiktok.com/open_api/v1.3/oauth2/access_token/ -H "Content-Type: application/json" -d '{"app_id":"<App ID>","secret":"<Secret>","auth_code":"<auth_code>"}'
   

   Pega data.access_token de la respuesta en TIKTOK_ADS_ACCESS_TOKEN y uno de los data.advertiser_ids en TIKTOK_ADS_ADVERTISER_ID. El token no caduca; solo deja de funcionar si se revoca la autorización o se restablece el secret de la app.
6. Pon TIKTOK_ADS_API_HOST en https://business-api.tiktok.com, instala el conector y ejecuta tiktok_ads_get_advertiser_info para comprobar la cuenta.

Sandbox: para probarlo sin gasto real, abre tu app en el portal para desarrolladores → Sandbox, crea una cuenta publicitaria sandbox y genera allí su token; no hace falta revisión. Usa ese token y el id de anunciante sandbox, y pon TIKTOK_ADS_API_HOST en https://sandbox-ads.tiktok.com. Las cuentas sandbox no publican anuncios ni devuelven datos reales.

Una cuenta publicitaria por conector: cada herramienta trabaja con la cuenta publicitaria de TIKTOK_ADS_ADVERTISER_ID. Un token suele cubrir varias cuentas, y tiktok_ads_list_authorized_advertisers las lista. Instala el conector otra vez para cada cuenta adicional.

Los cambios de estado y presupuesto vienen desactivados: tiktok_ads_update_campaign_status, tiktok_ads_update_ad_group_status, tiktok_ads_update_ad_status y tiktok_ads_update_campaign_budget están desactivadas al instalar, porque activar algo empieza a gastar al instante. Actívalas una a una si quieres que la IA pause anuncios o cambie presupuestos. Entonces la IA nombra la campaña, el grupo de anuncios o el anuncio, el valor actual y el nuevo, y espera tu sí. Un anuncio solo se publica cuando el anuncio, su grupo de anuncios y su campaña están todos activos. Los presupuestos son importes en la moneda de la cuenta (50 significa 50,00), y TikTok rechaza un presupuesto por debajo de su mínimo o por debajo del 105 % de lo ya gastado. El conector nunca crea campañas ni anuncios.

Informes: tiktok_ads_get_report devuelve gasto, impresiones, clics, conversiones y más por campaña, grupo de anuncios, anuncio o para toda la cuenta, por día o por hora, o desglosado por edad, género, país o ubicación. Las filas diarias cubren hasta 30 días por solicitud, así que la IA divide los periodos más largos; los totales sin desglose temporal pueden abarcar hasta un año. Las fechas siguen la zona horaria de la cuenta publicitaria, y los importes, su moneda.

Errores comunes: TikTok informa de los errores como un código dentro de una respuesta por lo demás normal, y el conector los convierte en un error claro. 40001: a la app o al token le falta permiso para esta cuenta o acción, así que autoriza de nuevo la cuenta publicitaria con los scopes necesarios. 40104 o 40105: el token no es válido, ha caducado, se ha revocado o pertenece a otra cuenta; genera uno nuevo. 40100: demasiadas solicitudes, espera un momento. 40300: TikTok no conoce el id de anunciante.

El conector no crea ni edita campañas, grupos de anuncios, anuncios ni audiencias, no sube creatividades, no gestiona Business Center y no cubre TikTok Shop.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de TikTok Ads.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuánto gastamos en TikTok la semana pasada y qué campaña tuvo el coste por conversión más bajo?"
• "Muestra el gasto, los clics y las conversiones diarios de cada campaña en los últimos 30 días."
• "Desglosa los resultados del mes pasado por edad y género."
• "¿Sigue recibiendo nuestro TikTok Pixel eventos de compra? Compara los últimos 7 días con la semana anterior."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT