MCP-server

TikTok MCP-server Laat elke AI-agent posten op TikTok

Laat AI-agents video's, fotocarrousels en concepten publiceren op TikTok, privacy en AI-labels instellen, de verwerkingsstatus checken en prestatiecijfers ophalen vanuit één prompt.

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

TikTok-tools die de agent kan aanroepen

Onderdeel van de MCP-server van Upload-Post. De agent kiest de juiste tool op basis van je prompt.

Tool Wat hij doet
upload_video Publiceer een video op TikTok met bijschrift, privacy- en planningsopties
upload_photos Publiceer een fotocarrousel met tot 35 afbeeldingen op TikTok
tiktok_publishing_settings Lees welke privacyniveaus het account toestaat, de maximale videolengte en de schakelaars voor reacties, duetten en stitches
tiktok_music_trending / tiktok_music_search / tiktok_location_search Zoek een nummer uit de Commercial Music Library of een locatie om in de post te taggen
get_status Volg de upload- en verwerkingsstatus
get_post_comments / create_comment / comment_action Lees, beantwoord, like, pin of verberg reacties op je video's
list_scheduled / edit_scheduled / cancel_scheduled Beheer ingeplande TikTok-posts
get_analytics / get_post_analytics Haal views, likes en engagement op per post of account
submit_ffmpeg_job Knip of hercodeer een clip vóór het posten

Liever de directe API? Bekijk de TikTok API-pagina.

De TikTok MCP-server toevoegen aan Claude of Cursor

Eén gehoste server op mcp.upload-post.com/mcp. Log in met OAuth of plak een API-key van Upload-Post, afhankelijk van wat je client ondersteunt.

Claude Desktop

Open het bestand via Settings > Developer > Edit Config, plak de regel erin en start Claude Desktop opnieuw. Zo draait het opensource npm-pakket @upload-post/mcp op je eigen computer; daarvoor heb je Node.js 18 of nieuwer nodig.

Gebruik je Claude in de browser? Dan heb je het bestand niet nodig: Customize > Connectors > + Add > Add custom connector, plak https://mcp.upload-post.com/mcp en log in met je Upload-Post-account (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

Liever OAuth? Laat de regel met --header weg, voer daarna /mcp uit in Claude Code en log in. Met --scope user gebruik je de server in al je projecten.

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

Cursor

Zet het in .cursor/mcp.json voor één project of in ~/.cursor/mcp.json voor al je projecten, en herlaad daarna Cursor.

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

Je API-key vind je onder API Keys in app.upload-post.com. Koppel vóór de eerste post TikTok aan een profiel in het dashboard: de agent geeft die profielnaam door als user. In ChatGPT zoek je onder Apps naar Upload-Post en klik je op Connect; een configuratiebestand is niet nodig.

Voorbeeld: een clip gemaakt met AI publiceren met de juiste labels

Een voorbeeldflow met verzonnen namen, ID's en URL's, geen echt gesprek van een klant. De namen van de tools en de parameters zijn de echte die de server aanbiedt.

Jij

Post https://example.com/clips/launch.mp4 op TikTok op mijn profiel "studio". Bijschrift: "Onze nieuwe editor in 30 seconden". Hij is met AI gemaakt, dus zet het label erop, en zet duetten uit.

  1. Tool-aanroep 1

    tiktok_publishing_settings

    Controleert welke privacyniveaus dit account toestaat voordat er gepost wordt.

    argumenten
    {
      "profile": "studio"
    }
    resultaat (ingekort)
    {
      "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. Tool-aanroep 2

    upload_video

    Publiceert op de achtergrond en geeft een request_id terug om te volgen.

    argumenten
    {
      "videoPathOrUrl": "https://example.com/clips/launch.mp4",
      "user": "studio",
      "platforms": [
        "tiktok"
      ],
      "title": "Onze nieuwe editor in 30 seconden",
      "asyncUpload": true,
      "platformOptions": {
        "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
        "tiktokDisableDuet": true,
        "tiktokIsAigc": true
      }
    }
    resultaat (ingekort)
    {
      "success": true,
      "message": "Upload initiated successfully in background.",
      "request_id": "9f3c1a7e-5b2d-4c8e-a1f0-2d7b6e4c9a10",
      "total_platforms": 1
    }
  3. Tool-aanroep 3

    get_status

    Vraagt de status op totdat TikTok de post bevestigt.

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

Assistent

Gepubliceerd op TikTok op "studio", met het label voor AI-gegenereerde content en duetten uitgeschakeld.

  • Als TikTok het bestand zelf weigert (formaat, lengte, framerate), meldt get_status tiktok_media_rejected; hetzelfde bestand opnieuw proberen mislukt dan weer. Bij tiktok_publish_failed loont het wel om het opnieuw te proberen.
  • De video moet op een openbare URL staan. Een gehoste MCP-server kan geen bestanden op je computer lezen.

Concepten en fotocarrousels

upload_video: Stuurt de clip naar je TikTok-concepten (inbox), zodat je in de app een geluid toevoegt en publiceert. In conceptmodus negeert TikTok het bijschrift en de privacy die via de API zijn meegestuurd.

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

upload_photos: Een fotocarrousel met de eerste afbeelding als cover en automatisch toegevoegde muziek.

{
  "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 fouten bij het monteren",
  "description": "Swipe voor de oplossing van elke fout.",
  "platformOptions": {
    "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
    "tiktokPhotoCoverIndex": 0,
    "tiktokAutoAddMusic": true
  }
}

Officiële TikTok API, via een goedgekeurde app

Hoe de TikTok MCP-server bij je account komt.

Elke post gaat via de Content Posting API van TikTok, met de goedgekeurde TikTok-app van Upload-Post. Je koppelt het TikTok-account één keer in het dashboard van Upload-Post, op het eigen autorisatiescherm van TikTok. Er wordt geen wachtwoord gedeeld en de TikTok-app wordt niet geautomatiseerd.

Die goedkeuring doet ertoe als je overwogen hebt dit zelf te bouwen. TikTok zet alles wat niet-geaudite API-clients posten op privé, totdat de client door een audit is gekomen. Met de gehoste server sla je de developer-app, de audit en het tokenbeheer over.

TikTok bepaalt per account welke privacyniveaus zijn toegestaan. Een privéaccount heeft bijvoorbeeld geen PUBLIC_TO_EVERYONE. De agent kan eerst tiktok_publishing_settings aanroepen en een niveau kiezen dat het account echt heeft, in plaats van te falen met tiktok_privacy_unavailable.

Muziek, locatietags, eigen covers en reacties hangen af van de rechten die bij het koppelen van het account zijn gegeven. list_users toont ze in een array capabilities bij het TikTok-account, en als je TikTok opnieuw koppelt, komen nieuwe rechten mee.

Bronnen: TikTok Content Posting API, TikTok-handleiding van Upload-Post, upload-post-mcp op GitHub.

TikTok-limieten waarbinnen de agent werkt

Wat TikTok en Upload-Post per post accepteren, gecontroleerd in september 2026.

Wat Limiet Bron
Bijschrift bij video 2.200 tekens (een emoji telt als 2) Tekenlimieten bij Upload-Post
Tekst bij fotopost Titel tot 90 tekens, beschrijving tot 4.000 Tekenlimieten bij Upload-Post
Video MP4, MOV of WebM; 3 seconden tot 10 minuten via de API; 23 tot 60 fps; minstens 360 px aan elke kant. Upload-Post weigert bestanden boven 3 GB. Video-eisen bij Upload-Post
Foto's JPG, JPEG of WebP, tot 35 per post en 20 MB per stuk. Afbeeldingen groter dan 1080 x 1920 worden automatisch verkleind. Foto-eisen bij Upload-Post
Privacy PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR of SELF_ONLY, per account beperkt door TikTok TikTok-handleiding van Upload-Post
Posttempo (TikTok) 6 posts per minuut en 15 per 24 uur per TikTok-account Video-eisen bij Upload-Post

Werkt met elke MCP-client

Dezelfde server, dezelfde tools. Kies je AI-client en volg de bijbehorende gids in 3 stappen.

Probeer deze TikTok-prompts

Geen commando's om te onthouden. Beschrijf wat je wilt.

“Publiceer deze video op TikTok onder profiel "marketing", bijschrift: "Lentelancering 🌱".”
“Knip deze clip tot de eerste 30 seconden en post 'm op TikTok.”
“Plan deze TikTok in voor vrijdag om 18:00 uur Madrid-tijd.”
“Hoe presteerden mijn laatste 5 TikToks? Vergelijk views en voltooiingspercentage.”

Veelgestelde vragen

TikTok + AI-agents, beantwoord. Laatst bijgewerkt in september 2026.

Wat is een TikTok MCP-server?

Een TikTok MCP-server is een Model Context Protocol-server die publiceren op TikTok beschikbaar maakt als tools die een AI-agent kan aanroepen. Met de MCP-server van Upload-Post kunnen ChatGPT, Claude, Gemini of een andere MCP-client video's en fotocarrousels naar TikTok uploaden, posts inplannen en statistieken ophalen, zonder eigen code.

Kunnen AI-agents video's posten op TikTok?

Ja. Koppel je TikTok-account één keer aan Upload-Post, voeg de MCP-server toe aan je AI-client, en de agent kan video's publiceren met bijschriften, privacy-instellingen en planning vanuit een prompt in gewone taal.

Welke videoformaten accepteert TikTok?

Via de API accepteert TikTok MP4, MOV of WebM van 3 seconden tot 10 minuten, met 23 tot 60 fps en minstens 360 px aan elke kant. Foto's groter dan 1080 x 1920 worden automatisch verkleind. Is een clip te lang of in het verkeerde formaat, dan kan de agent hem eerst knippen of hercoderen met submit_ffmpeg_job.

Is de TikTok MCP-server gratis?

De code van de server is gratis en open source (MIT). Je koppelt hem met een API-key van Upload-Post, en een account maak je gratis aan.

Wat is het verschil met de TikTok Ads MCP?

Ze doen ander werk. De eigen MCP-server van TikTok for Business werkt aan de advertentiekant: campagnes, advertentiegroepen, doelgroepen, catalogi en advertentierapportages. De TikTok MCP van Upload-Post werkt op je organische account: hij publiceert video’s en fotocarrousels, zet clips in concepten, beantwoordt reacties en leest de statistieken van je posts, allemaal via de officiële developer-API’s van TikTok. Adverteer je en post je ook organisch, dan kun je beide aan dezelfde AI-client koppelen.

Is het een TikTok-scraper?

Nee. Hij werkt alleen met TikTok-accounts die je zelf koppelt en die van jou zijn, via de officiële API van TikTok. Hij downloadt geen video’s van andere makers, doorzoekt geen hashtags en verzamelt geen profielgegevens. Dat doen de scraping-MCP-servers die voor TikTok te vinden zijn.

Kan de agent video's naar TikTok-concepten sturen in plaats van ze te publiceren?

Ja. Zet tiktokPostMode op MEDIA_UPLOAD (of tiktokUploadToDraft op true) in platformOptions en de video komt in de TikTok-inbox terecht, waar je hem in de app afmaakt en publiceert. In conceptmodus negeert TikTok het bijschrift en de privacy die via de API zijn meegestuurd.

Kan het fotocarrousels op TikTok posten?

Ja. upload_photos met platforms ["tiktok"] publiceert een fotopost met tot 35 afbeeldingen in JPG, JPEG of WebP. tiktokPhotoCoverIndex kiest de cover en tiktokAutoAddMusic voegt achtergrondmuziek toe.

Hoe label ik video's die met AI zijn gemaakt?

Geef tiktokIsAigc: true mee in platformOptions. TikTok toont de video dan als door de maker gelabeld als AI-gegenereerd.

Hoeveel TikToks kan de agent per dag posten?

Tot 15 per TikTok-account binnen een voortschrijdende 24 uur, en niet meer dan 6 per minuut. Dat zijn de limieten van TikTok zelf.

Laat je AI-agent TikTok beheren

Gratis te starten, geen creditcard. Koppel TikTok één keer en post vanuit elke MCP-client.