Servidor MCP

Servidor MCP do TikTok Deixe qualquer agente de IA publicar no TikTok

Deixe agentes de IA publicarem vídeos, carrosséis de fotos e rascunhos no TikTok, definirem a privacidade e a marcação de IA, verificarem o status de processamento e extraírem métricas de desempenho a partir de um único prompt.

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

Ferramentas do TikTok que o agente pode chamar

Parte do servidor MCP do Upload-Post. O agente escolhe a ferramenta certa a partir do seu prompt.

Ferramenta O que faz
upload_video Publique um vídeo no TikTok com opções de legenda, privacidade e agendamento
upload_photos Publique um carrossel de até 35 fotos no TikTok
tiktok_publishing_settings Consulte quais níveis de privacidade a conta permite, a duração máxima de vídeo e as opções de comentários, duetos e stitch
tiktok_music_trending / tiktok_music_search / tiktok_location_search Encontre uma faixa da Commercial Music Library ou um local para marcar no post
get_status Acompanhe o status de upload e processamento
get_post_comments / create_comment / comment_action Leia, responda, curta, fixe ou oculte comentários dos seus vídeos
list_scheduled / edit_scheduled / cancel_scheduled Gerencie posts agendados do TikTok
get_analytics / get_post_analytics Extraia visualizações, curtidas e engajamento por post ou por conta
submit_ffmpeg_job Corte ou recodifique um clipe antes de publicar

Procurando a API direta? Veja a página da API do TikTok.

Adicione o servidor MCP do TikTok ao Claude ou ao Cursor

Um único servidor hospedado em mcp.upload-post.com/mcp. Entre com OAuth ou cole uma chave de API do Upload-Post, o que o seu cliente aceitar.

Claude Desktop

Abra o arquivo em Settings > Developer > Edit Config, cole a entrada e reinicie o Claude Desktop. Ele roda o pacote npm open-source @upload-post/mcp na sua máquina e precisa do Node.js 18 ou mais recente.

Prefere não mexer no arquivo? No claude.ai ou no Claude Desktop, adicione o conector oficial do Upload-Post pelo diretório do Claude (claude.ai/directory/upload-post, ou Customize > Connectors e procure por Upload-Post), clique em Connect e entre com a sua conta do 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

Prefere OAuth? Tire a linha --header, rode /mcp dentro do Claude Code e faça login. Adicione --scope user para usar o servidor em todos os projetos.

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

Cursor

Coloque em .cursor/mcp.json para um projeto ou em ~/.cursor/mcp.json para todos, depois recarregue o Cursor.

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

A sua chave de API fica em API Keys no app.upload-post.com. Antes do primeiro post, conecte o TikTok a um perfil no painel: o agente passa o nome desse perfil como user. No ChatGPT, procure Upload-Post em Apps e clique em Connect; não precisa de arquivo de configuração.

Exemplo: publicar um clipe feito com IA com as marcações certas

Um fluxo de exemplo com nomes, IDs e URLs fictícios, não uma conversa real de cliente. Os nomes das ferramentas e os parâmetros são os reais que o servidor expõe.

Você

Poste https://example.com/clips/launch.mp4 no TikTok do meu perfil "studio". Legenda: "Nosso novo editor em 30 segundos". Foi feito com IA, então marque como conteúdo de IA, e desative os duetos.

  1. Chamada de ferramenta 1

    tiktok_publishing_settings

    Confere quais níveis de privacidade esta conta permite antes de postar.

    argumentos
    {
      "profile": "studio"
    }
    resultado (resumido)
    {
      "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. Chamada de ferramenta 2

    upload_video

    Publica em segundo plano e devolve um request_id para acompanhar.

    argumentos
    {
      "videoPathOrUrl": "https://example.com/clips/launch.mp4",
      "user": "studio",
      "platforms": [
        "tiktok"
      ],
      "title": "Nosso novo editor em 30 segundos",
      "asyncUpload": true,
      "platformOptions": {
        "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
        "tiktokDisableDuet": true,
        "tiktokIsAigc": true
      }
    }
    resultado (resumido)
    {
      "success": true,
      "message": "Upload initiated successfully in background.",
      "request_id": "9f3c1a7e-5b2d-4c8e-a1f0-2d7b6e4c9a10",
      "total_platforms": 1
    }
  3. Chamada de ferramenta 3

    get_status

    Consulta o status até o TikTok confirmar o post.

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

Assistente

Publicado no TikTok do perfil "studio", com a marcação de conteúdo gerado por IA e os duetos desativados.

  • Se o TikTok rejeitar o próprio arquivo (formato, duração, taxa de quadros), get_status informa tiktok_media_rejected; tentar de novo com o mesmo arquivo vai falhar outra vez. Já tiktok_publish_failed vale a pena tentar de novo.
  • O vídeo precisa estar numa URL pública. Um servidor MCP hospedado não consegue ler arquivos do seu computador.

Rascunhos e carrosséis de fotos

upload_video: Manda o clipe para os rascunhos do TikTok (inbox), para você adicionar um som e publicar pelo app. No modo rascunho, o TikTok ignora a legenda e a privacidade enviadas pela API.

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

upload_photos: Um carrossel de fotos com a primeira imagem como capa e música adicionada automaticamente.

{
  "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 erros de edição",
  "description": "Deslize para ver como corrigir cada um.",
  "platformOptions": {
    "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
    "tiktokPhotoCoverIndex": 0,
    "tiktokAutoAddMusic": true
  }
}

API oficial do TikTok, por um app aprovado

Como o servidor MCP do TikTok chega à sua conta.

Cada post sai pela Content Posting API do TikTok, usando o app do TikTok aprovado do Upload-Post. Você conecta a conta do TikTok uma vez no painel do Upload-Post, na tela de autorização do próprio TikTok. Não há compartilhamento de senha nem automação do app do TikTok.

Essa aprovação importa se você pensou em construir isso sozinho. O TikTok deixa tudo o que é postado por clientes de API não auditados visível só em modo privado até o cliente passar por uma auditoria. Com o servidor hospedado, você pula o app de desenvolvedor, a auditoria e a gestão de tokens.

O TikTok decide por conta quais níveis de privacidade são permitidos. Uma conta privada, por exemplo, não tem PUBLIC_TO_EVERYONE. O agente pode chamar tiktok_publishing_settings antes e escolher um nível que a conta realmente tem, em vez de falhar com tiktok_privacy_unavailable.

Música, marcação de localização, capas personalizadas e comentários dependem das permissões concedidas quando a conta foi conectada. list_users mostra essas permissões num array capabilities na conta do TikTok, e reconectar o TikTok ativa as novas.

Fontes: TikTok Content Posting API, Guia do TikTok do Upload-Post, upload-post-mcp no GitHub.

Limites do TikTok que o agente respeita

O que o TikTok e o Upload-Post aceitam por post, conferido em setembro de 2026.

O quê Limite Fonte
Legenda do vídeo 2.200 caracteres (um emoji conta como 2) Limites de caracteres do Upload-Post
Texto do post de fotos Título de até 90 caracteres, descrição de até 4.000 Limites de caracteres do Upload-Post
Vídeo MP4, MOV ou WebM; de 3 segundos a 10 minutos pela API; de 23 a 60 fps; pelo menos 360 px em cada lado. O Upload-Post rejeita arquivos acima de 3 GB. Requisitos de vídeo do Upload-Post
Fotos JPG, JPEG ou WebP, até 35 por post e 20 MB cada. Imagens acima de 1080 x 1920 são reduzidas automaticamente. Requisitos de foto do Upload-Post
Privacidade PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR ou SELF_ONLY, limitados por conta pelo TikTok Guia do TikTok do Upload-Post
Ritmo de publicação (TikTok) 6 posts por minuto e 15 a cada 24 horas por conta do TikTok Requisitos de vídeo do Upload-Post

Funciona com todos os clientes MCP

Mesmo servidor, mesmas ferramentas. Escolha seu cliente de IA e siga o guia de 3 passos.

Teste estes prompts do TikTok

Sem comandos para memorizar. Descreva o que você quer.

“Publique este vídeo no TikTok no perfil "marketing", legenda: "Lançamento de primavera 🌱".”
“Corte este clipe nos primeiros 30 segundos e publique no TikTok.”
“Agende este TikTok para sexta-feira às 18h, horário de Brasília.”
“Como foram meus últimos 5 TikToks? Compare visualizações e taxa de conclusão.”

Perguntas frequentes

TikTok + agentes de IA, tudo respondido. Última atualização em setembro de 2026.

O que é um servidor MCP do TikTok?

Um servidor MCP do TikTok é um servidor Model Context Protocol que expõe a publicação no TikTok como ferramentas que um agente de IA pode chamar. O servidor MCP do Upload-Post permite que ChatGPT, Claude, Gemini ou qualquer cliente MCP envie vídeos e carrosséis de fotos para o TikTok, agende posts e extraia analytics, sem código personalizado.

Agentes de IA conseguem publicar vídeos no TikTok?

Sim. Conecte sua conta do TikTok ao Upload-Post uma vez, adicione o servidor MCP ao seu cliente de IA, e o agente poderá publicar vídeos com legendas, configurações de privacidade e agendamento a partir de um prompt em linguagem natural.

Quais formatos de vídeo o TikTok aceita?

Pela API, o TikTok aceita MP4, MOV ou WebM de 3 segundos a 10 minutos, de 23 a 60 fps e com pelo menos 360 px em cada lado. Fotos maiores que 1080 x 1920 são reduzidas automaticamente. Se um clipe for longo demais ou estiver no formato errado, o agente pode cortá-lo ou recodificá-lo antes com submit_ffmpeg_job.

O servidor MCP do TikTok é gratuito?

O código do servidor é gratuito e open source (MIT). Você conecta com uma API key do Upload-Post, e pode criar uma conta de graça.

Qual a diferença para o MCP do TikTok Ads?

Eles fazem trabalhos diferentes. O servidor MCP do TikTok for Business, do próprio TikTok, atua no lado de anúncios: campanhas, grupos de anúncios, públicos, catálogos e relatórios de anúncios. O MCP do TikTok do Upload-Post atua na sua conta orgânica: publica vídeos e carrosséis de fotos, envia clipes para rascunhos, responde comentários e lê as métricas dos posts, tudo pelas APIs oficiais para desenvolvedores do TikTok. Se você anuncia e também posta de forma orgânica, pode conectar os dois ao mesmo cliente de IA.

É um scraper do TikTok?

Não. Ele só funciona com contas do TikTok que você conecta e que são suas, pela API oficial do TikTok. Não baixa vídeos de outros criadores, não pesquisa hashtags nem coleta dados de perfis, que é o que fazem os servidores MCP de scraping listados para o TikTok.

O agente pode mandar vídeos para os rascunhos do TikTok em vez de publicar?

Sim. Defina tiktokPostMode como MEDIA_UPLOAD (ou tiktokUploadToDraft como true) em platformOptions e o vídeo cai na inbox do TikTok, onde você finaliza e publica pelo app. No modo rascunho, o TikTok ignora a legenda e a privacidade enviadas pela API.

Ele posta carrosséis de fotos no TikTok?

Sim. upload_photos com platforms ["tiktok"] publica um post de fotos com até 35 imagens JPG, JPEG ou WebP. tiktokPhotoCoverIndex escolhe a capa e tiktokAutoAddMusic adiciona música de fundo.

Como marco vídeos gerados por IA?

Envie tiktokIsAigc: true em platformOptions. O TikTok passa a mostrar o vídeo como marcado pelo criador como gerado por IA.

Quantos TikToks o agente pode postar por dia?

Até 15 por conta do TikTok a cada 24 horas corridas, e no máximo 6 por minuto. São limites do próprio TikTok.

Deixe seu agente de IA cuidar do TikTok

Grátis para começar, sem cartão de crédito. Conecte o TikTok uma vez e publique de qualquer cliente MCP.