Server MCP

Server MCP TikTok Lascia che qualsiasi agente IA pubblichi su TikTok

Lascia che gli agenti IA pubblichino su TikTok video, caroselli di foto e bozze, impostino privacy ed etichette IA, controllino lo stato di elaborazione e recuperino le metriche, tutto da un solo prompt.

mcp.json
{
  "mcpServers": {
    "upload-post": {
      "url": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

Strumenti TikTok che l'agente può chiamare

Fa parte del server MCP di Upload-Post. L'agente sceglie lo strumento giusto a partire dal tuo prompt.

Strumento Cosa fa
upload_video Pubblica un video su TikTok con didascalia, opzioni di privacy e programmazione
upload_photos Pubblica su TikTok un carosello fino a 35 foto
tiktok_publishing_settings Legge quali livelli di privacy consente l'account, la durata massima dei video e gli interruttori di commenti, duetti e stitch
tiktok_music_trending / tiktok_music_search / tiktok_location_search Trova un brano della Commercial Music Library o un luogo da taggare nel post
get_status Monitora lo stato di caricamento ed elaborazione
get_post_comments / create_comment / comment_action Leggi, rispondi, metti like, fissa o nascondi i commenti ai tuoi video
list_scheduled / edit_scheduled / cancel_scheduled Gestisci i post TikTok programmati
get_analytics / get_post_analytics Recupera visualizzazioni, like ed engagement per post o account
submit_ffmpeg_job Taglia o ricodifica una clip prima di pubblicarla

Cerchi invece l'API diretta? Vedi la pagina API di TikTok.

Aggiungi il server MCP di TikTok a Claude o Cursor

Un unico server ospitato su mcp.upload-post.com/mcp. Accedi con OAuth o incolla una API key di Upload-Post, a seconda di cosa supporta il tuo client.

Claude Desktop

Aprilo da Settings > Developer > Edit Config, incolla la voce e riavvia Claude Desktop. Esegue sul tuo computer il pacchetto npm open source @upload-post/mcp e richiede Node.js 18 o successivo.

Preferisci evitare il file? Su claude.ai o Claude Desktop aggiungi il connettore ufficiale di Upload-Post dalla directory di Claude (claude.ai/directory/upload-post, oppure Customize > Connectors e cerca Upload-Post), clicca su Connect e accedi con il tuo account Upload-Post (OAuth).

claude_desktop_config.json
{
  "mcpServers": {
    "upload-post": {
      "command": "npx",
      "args": ["-y", "@upload-post/mcp"],
      "env": { "UPLOAD_POST_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Code

Preferisci OAuth? Togli la riga --header, poi esegui /mcp dentro Claude Code e accedi. Aggiungi --scope user per usare il server in tutti i progetti.

Terminal
claude mcp add --transport http upload-post https://mcp.upload-post.com/mcp \
  --header "Authorization: ApiKey YOUR_API_KEY"

Cursor

Mettilo in .cursor/mcp.json per un solo progetto o in ~/.cursor/mcp.json per tutti, poi ricarica Cursor.

.cursor/mcp.json
{
  "mcpServers": {
    "upload-post": {
      "url": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

La tua API key si trova in API Keys su app.upload-post.com. Prima del primo post, collega TikTok a un profilo nella dashboard: l'agente passa il nome di quel profilo come user. Su ChatGPT cerca Upload-Post tra le app e clicca Connect; non serve nessun file di configurazione.

Esempio: pubblicare una clip fatta con l'IA con le etichette giuste

Un flusso di esempio con nomi, ID e URL di fantasia, non la conversazione di un cliente reale. I nomi degli strumenti e i parametri sono quelli reali che il server espone.

Tu

Pubblica https://example.com/clips/launch.mp4 su TikTok con il mio profilo "studio". Didascalia: "Il nostro nuovo editor in 30 secondi". È stato fatto con l'IA, quindi segnalalo, e disattiva i duetti.

  1. Chiamata allo strumento 1

    tiktok_publishing_settings

    Controlla quali livelli di privacy consente questo account prima di pubblicare.

    argomenti
    {
      "profile": "studio"
    }
    risultato (ridotto)
    {
      "success": true,
      "privacy_level_options": [
        "PUBLIC_TO_EVERYONE",
        "MUTUAL_FOLLOW_FRIENDS",
        "FOLLOWER_OF_CREATOR",
        "SELF_ONLY"
      ],
      "max_video_post_duration_sec": 600,
      "comment_disabled": false,
      "duet_disabled": false,
      "stitch_disabled": false
    }
  2. Chiamata allo strumento 2

    upload_video

    Pubblica in background e restituisce un request_id da seguire.

    argomenti
    {
      "videoPathOrUrl": "https://example.com/clips/launch.mp4",
      "user": "studio",
      "platforms": [
        "tiktok"
      ],
      "title": "Il nostro nuovo editor in 30 secondi",
      "asyncUpload": true,
      "platformOptions": {
        "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
        "tiktokDisableDuet": true,
        "tiktokIsAigc": true
      }
    }
    risultato (ridotto)
    {
      "success": true,
      "message": "Upload initiated successfully in background.",
      "request_id": "9f3c1a7e-5b2d-4c8e-a1f0-2d7b6e4c9a10",
      "total_platforms": 1
    }
  3. Chiamata allo strumento 3

    get_status

    Controlla a intervalli finché TikTok non conferma il post.

    argomenti
    {
      "requestId": "9f3c1a7e-5b2d-4c8e-a1f0-2d7b6e4c9a10"
    }
    risultato (ridotto)
    {
      "request_id": "9f3c1a7e-5b2d-4c8e-a1f0-2d7b6e4c9a10",
      "status": "completed",
      "completed": 1,
      "total": 1,
      "results": [
        {
          "platform": "tiktok",
          "success": true
        }
      ]
    }

Assistente

Pubblicato su TikTok con "studio", con l'etichetta di contenuto generato con l'IA e i duetti disattivati.

  • Se TikTok rifiuta il file in sé (formato, durata, frame rate), get_status restituisce tiktok_media_rejected; riprovare con lo stesso file fallirà di nuovo. Con tiktok_publish_failed invece vale la pena riprovare.
  • Il video deve trovarsi a un URL pubblico. Un server MCP ospitato non può leggere i file sul tuo computer.

Bozze e caroselli di foto

upload_video: Manda la clip nelle bozze di TikTok (inbox) così puoi aggiungere un suono e pubblicare dall'app. In modalità bozza TikTok ignora la didascalia e la privacy inviate tramite l'API.

{
  "videoPathOrUrl": "https://example.com/clips/launch.mp4",
  "user": "studio",
  "platforms": [
    "tiktok"
  ],
  "platformOptions": {
    "tiktokPostMode": "MEDIA_UPLOAD"
  }
}

upload_photos: Un carosello di foto con la prima immagine come copertina e la musica aggiunta in automatico.

{
  "photosPathsOrUrls": [
    "https://example.com/slides/1.jpg",
    "https://example.com/slides/2.jpg",
    "https://example.com/slides/3.jpg"
  ],
  "user": "studio",
  "platforms": [
    "tiktok"
  ],
  "title": "3 errori di montaggio",
  "description": "Scorri per vedere come correggere ciascuno.",
  "platformOptions": {
    "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
    "tiktokPhotoCoverIndex": 0,
    "tiktokAutoAddMusic": true
  }
}

API ufficiale di TikTok, tramite un'app approvata

Come il server MCP di TikTok arriva al tuo account.

Ogni post esce tramite la Content Posting API di TikTok, usando l'app TikTok approvata di Upload-Post. Colleghi l'account TikTok una sola volta nella dashboard di Upload-Post, dalla schermata di autorizzazione di TikTok stesso. Nessuna password condivisa e nessuna automazione dell'app TikTok.

Questa approvazione conta se hai pensato di costruirlo da solo. TikTok rende visibile solo in privato tutto ciò che pubblicano i client API non ancora verificati, finché il client non supera un audit. Con il server ospitato salti l'app per sviluppatori, l'audit e la gestione dei token.

È TikTok a decidere, account per account, quali livelli di privacy sono consentiti. Un account privato, per esempio, non ha PUBLIC_TO_EVERYONE. L'agente può chiamare prima tiktok_publishing_settings e scegliere un livello che l'account ha davvero, invece di fallire con tiktok_privacy_unavailable.

Musica, tag di luogo, copertine personalizzate e commenti dipendono dai permessi concessi quando l'account è stato collegato. list_users li mostra in un array capabilities sull'account TikTok, e ricollegando TikTok si ottengono quelli nuovi.

Fonti: TikTok Content Posting API, Guida TikTok di Upload-Post, upload-post-mcp su GitHub.

I limiti di TikTok entro cui lavora l'agente

Cosa accettano TikTok e Upload-Post per ogni post, verificato a settembre 2026.

Cosa Limite Fonte
Didascalia del video 2.200 caratteri (un'emoji conta come 2) Limiti di caratteri di Upload-Post
Testo dei post con foto Titolo fino a 90 caratteri, descrizione fino a 4.000 Limiti di caratteri di Upload-Post
Video MP4, MOV o WebM; da 3 secondi a 10 minuti tramite l'API; da 23 a 60 fps; almeno 360 px per lato. Upload-Post rifiuta i file oltre i 3 GB. Requisiti video di Upload-Post
Foto JPG, JPEG o WebP, fino a 35 per post e 20 MB ciascuna. Le immagini oltre 1080 x 1920 vengono ridimensionate in automatico. Requisiti foto di Upload-Post
Privacy PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR o SELF_ONLY, limitati da TikTok account per account Guida TikTok di Upload-Post
Frequenza di pubblicazione (TikTok) 6 post al minuto e 15 ogni 24 ore per account TikTok Requisiti video di Upload-Post

Funziona con tutti i client MCP

Stesso server, stessi strumenti. Scegli il tuo client IA e segui la sua guida in 3 passaggi.

Prova questi prompt per TikTok

Nessun comando da memorizzare. Descrivi cosa vuoi.

“Pubblica questo video su TikTok con il profilo "marketing", didascalia: "Lancio primaverile 🌱".”
“Taglia questa clip ai primi 30 secondi e pubblicala su TikTok.”
“Programma questo TikTok per venerdì alle 18:00, ora di Madrid.”
“Come sono andati i miei ultimi 5 TikTok? Confronta visualizzazioni e completamento.”

Domande frequenti

TikTok + agenti IA, tutte le risposte. Ultimo aggiornamento: settembre 2026.

Cos'è un server MCP per TikTok?

Un server MCP per TikTok è un server Model Context Protocol che espone la pubblicazione su TikTok come strumenti che un agente IA può chiamare. Il server MCP di Upload-Post permette a ChatGPT, Claude, Gemini o qualsiasi client MCP di caricare video e caroselli di foto su TikTok, programmare post e recuperare le statistiche, senza scrivere codice.

Gli agenti IA possono pubblicare video su TikTok?

Sì. Collega il tuo account TikTok a Upload-Post una volta, aggiungi il server MCP al tuo client IA, e l'agente potrà pubblicare video con didascalie, impostazioni di privacy e programmazione da un prompt in linguaggio naturale.

Quali formati video accetta TikTok?

Tramite l'API TikTok accetta MP4, MOV o WebM da 3 secondi a 10 minuti, da 23 a 60 fps e con almeno 360 px per lato. Le foto più grandi di 1080 x 1920 vengono ridimensionate in automatico. Se una clip è troppo lunga o nel formato sbagliato, l'agente può prima tagliarla o ricodificarla con submit_ffmpeg_job.

Il server MCP per TikTok è gratuito?

Il codice del server è gratuito e open source (MIT). Lo colleghi con una API key di Upload-Post, e puoi creare un account gratis.

Che differenza c'è con l'MCP di TikTok Ads?

Fanno lavori diversi. Il server MCP di TikTok for Business, quello ufficiale di TikTok, lavora sul lato pubblicitario: campagne, gruppi di annunci, pubblici, cataloghi e report delle inserzioni. L'MCP per TikTok di Upload-Post lavora sul tuo account organico: pubblica video e caroselli di foto, manda clip nelle bozze, risponde ai commenti e legge le analytics dei post, tutto tramite le API ufficiali per sviluppatori di TikTok. Se fai pubblicità e pubblichi anche in organico, puoi collegare entrambi allo stesso client AI.

È uno scraper di TikTok?

No. Funziona solo con gli account TikTok che colleghi e che sono tuoi, tramite l'API ufficiale di TikTok. Non scarica i video di altri creator, non cerca hashtag e non raccoglie dati di profili, cioè quello che fanno i server MCP di scraping elencati per TikTok.

L'agente può mandare i video nelle bozze di TikTok invece di pubblicarli?

Sì. Imposta tiktokPostMode su MEDIA_UPLOAD (oppure tiktokUploadToDraft su true) in platformOptions e il video arriva nella inbox di TikTok, dove lo completi e lo pubblichi dall'app. In modalità bozza TikTok ignora la didascalia e la privacy inviate tramite l'API.

Può pubblicare caroselli di foto su TikTok?

Sì. upload_photos con platforms ["tiktok"] pubblica un post con foto fino a 35 immagini JPG, JPEG o WebP. tiktokPhotoCoverIndex sceglie la copertina e tiktokAutoAddMusic aggiunge una musica di sottofondo.

Come segnalo i video generati con l'IA?

Passa tiktokIsAigc: true in platformOptions. TikTok mostra allora il video come contenuto indicato dal creator come generato con l'IA.

Quanti TikTok può pubblicare l'agente al giorno?

Fino a 15 per account TikTok nell'arco di 24 ore mobili, e non più di 6 al minuto. Sono i limiti di TikTok stesso.

Lascia che il tuo agente IA gestisca TikTok

Gratis per iniziare, senza carta di credito. Collega TikTok una volta e pubblica da qualsiasi client MCP.