Come collegare TikTok Ads a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → TikTok Ads, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

TikTok Ads + Cursor

Fai analizzare alla tua AI le tue inserzioni TikTok: spesa, impressioni, clic e conversioni per campagna, gruppo di annunci, annuncio, giorno o pubblico, più campagne, campagne Smart+, pubblici, pixel e la libreria delle creatività. Può mettere in pausa o attivare campagne, gruppi di annunci e annunci e cambiare i budget delle campagne, dopo che hai attivato quei tool e dato la tua conferma.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

TIKTOK_ADS_API_HOST, TIKTOK_ADS_ACCESS_TOKEN, TIKTOK_ADS_ADVERTISER_ID

Step 1 — Ottieni le credenziali

1. Accedi al portale sviluppatori di TikTok API for Business su https://business-api.tiktok.com/portal con un account TikTok for Business che ha accesso al tuo account pubblicitario e fai clic su Become a Developer.
2. In My Apps → Create an app inserisci un nome, una descrizione e un Advertiser redirect URL (una qualsiasi tua pagina https: ti serve solo per copiare un codice dal suo indirizzo) e spunta gli scope di autorizzazione Ad Account Management, Ads Management, Reporting e Audience Management, più Pixel Management e Creative Management per i relativi tool. TikTok esamina le nuove app, di solito entro due o tre giorni lavorativi.
3. Quando l'app è approvata, copia il suo App ID e il suo Secret in TIKTOK_ADS_APP_ID e TIKTOK_ADS_APP_SECRET. Sono entrambi facoltativi: il connettore li usa solo per elencare gli account pubblicitari coperti dal tuo token.
4. Apri l'Advertiser authorization URL dell'app, accedi, spunta gli account pubblicitari e conferma. Il browser arriva sull'URL di reindirizzamento con auth_code=... nella barra degli indirizzi. Il codice funziona una sola volta e scade dopo un'ora.
5. Scambia subito il codice con un access token a lunga durata. È un passaggio da fare una sola volta:

   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>"}'
   

   Incolla data.access_token dalla risposta in TIKTOK_ADS_ACCESS_TOKEN e uno degli data.advertiser_ids in TIKTOK_ADS_ADVERTISER_ID. Il token non scade; smette di funzionare solo se l'autorizzazione viene revocata o il secret dell'app viene reimpostato.
6. Imposta TIKTOK_ADS_API_HOST su https://business-api.tiktok.com, installa il connettore ed esegui tiktok_ads_get_advertiser_info per verificare l'account.

Sandbox: per provarlo senza spesa reale, apri la tua app nel portale sviluppatori → Sandbox, crea un account pubblicitario sandbox e genera lì il suo token; non serve alcuna revisione. Usa quel token e l'id inserzionista della sandbox e imposta TIKTOK_ADS_API_HOST su https://sandbox-ads.tiktok.com. Gli account sandbox non pubblicano annunci e non riportano dati reali.

Un account pubblicitario per connettore: ogni tool lavora sull'account pubblicitario indicato in TIKTOK_ADS_ADVERTISER_ID. Spesso un token copre più account, e tiktok_ads_list_authorized_advertisers li elenca. Installa di nuovo il connettore per ogni account in più.

Le modifiche a stato e budget sono disattivate di default: tiktok_ads_update_campaign_status, tiktok_ads_update_ad_group_status, tiktok_ads_update_ad_status e tiktok_ads_update_campaign_budget sono disattivati all'installazione, perché attivare qualcosa fa partire subito la spesa. Attivali uno per uno se vuoi che l'AI metta in pausa gli annunci o cambi i budget. A quel punto l'AI indica la campagna, il gruppo di annunci o l'annuncio, il valore attuale e quello nuovo, e aspetta il tuo sì. Un annuncio viene pubblicato solo se l'annuncio, il suo gruppo di annunci e la sua campagna sono tutti attivi. I budget sono importi nella valuta dell'account (50 vuol dire 50,00), e TikTok rifiuta un budget sotto il suo minimo o sotto il 105% di quanto già speso. Il connettore non crea mai campagne o annunci.

Report: tiktok_ads_get_report restituisce spesa, impressioni, clic, conversioni e altro per campagna, gruppo di annunci, annuncio o per l'intero account, per giorno o per ora, oppure suddivisi per età, genere, paese o posizionamento. Le righe giornaliere coprono al massimo 30 giorni per richiesta, quindi l'AI divide i periodi più lunghi; i totali senza suddivisione temporale possono coprire fino a un anno. Le date seguono il fuso orario dell'account pubblicitario e gli importi la sua valuta.

Errori comuni: TikTok segnala gli errori come un codice dentro una risposta per il resto normale, e il connettore li trasforma in un errore chiaro. 40001: all'app o al token manca l'autorizzazione per questo account o questa azione, quindi autorizza di nuovo l'account pubblicitario con gli scope necessari. 40104 o 40105: il token non è valido, è scaduto o revocato, oppure appartiene a un altro account; generane uno nuovo. 40100: troppe richieste, aspetta un momento. 40300: TikTok non conosce l'id inserzionista.

Il connettore non crea né modifica campagne, gruppi di annunci, annunci o pubblici, non carica creatività, non gestisce Business Center e non copre TikTok Shop.

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di TikTok Ads.

Tool disponibili

Esempi di prompt

• "Quanto abbiamo speso su TikTok la settimana scorsa, e quale campagna ha avuto il costo per conversione più basso?"
• "Mostrami spesa, clic e conversioni giornalieri di ogni campagna negli ultimi 30 giorni."
• "Suddividi i risultati del mese scorso per età e genere."
• "Il nostro TikTok Pixel riceve ancora eventi di acquisto? Confronta gli ultimi 7 giorni con la settimana precedente."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT