MCP 서버

TikTok MCP 서버 모든 AI 에이전트가 TikTok에 게시하게 하세요

AI 에이전트가 프롬프트 하나로 TikTok에 동영상, 사진 캐러셀, 임시 저장 게시물을 올리고, 공개 범위와 AI 라벨을 설정하고, 처리 상태를 확인하고, 성과 지표를 가져오게 하세요.

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

에이전트가 호출할 수 있는 TikTok 도구

Upload-Post MCP 서버의 일부입니다. 에이전트가 프롬프트에 맞는 도구를 골라 씁니다.

도구 기능
upload_video 캡션, 공개 범위, 예약 옵션과 함께 TikTok에 동영상 게시
upload_photos TikTok에 최대 35장의 사진 캐러셀 게시
tiktok_publishing_settings 계정에서 허용되는 공개 범위, 최대 동영상 길이, 댓글·듀엣·스티치 설정 확인
tiktok_music_trending / tiktok_music_search / tiktok_location_search 게시물에 넣을 Commercial Music Library 음원이나 태그할 장소 찾기
get_status 업로드 및 처리 상태 추적
get_post_comments / create_comment / comment_action 내 동영상 댓글 읽기, 답글, 좋아요, 고정, 숨기기
list_scheduled / edit_scheduled / cancel_scheduled 예약된 TikTok 게시물 관리
get_analytics / get_post_analytics 게시물 또는 계정별 조회수, 좋아요, 참여도 가져오기
submit_ffmpeg_job 게시 전에 클립 자르기 또는 재인코딩

직접 API를 찾고 계신가요? TikTok API 페이지를 참고하세요.

TikTok MCP 서버를 Claude나 Cursor에 추가하기

mcp.upload-post.com/mcp에 호스팅된 서버 하나로 끝납니다. 클라이언트가 지원하는 방식에 맞춰 OAuth로 로그인하거나 Upload-Post API 키를 붙여 넣으세요.

Claude Desktop

Settings > Developer > Edit Config에서 파일을 열고 항목을 붙여 넣은 뒤 Claude Desktop을 다시 시작하세요. 내 컴퓨터에서 오픈소스 npm 패키지 @upload-post/mcp를 실행하며, Node.js 18 이상이 필요합니다.

파일 없이 하고 싶나요? claude.ai나 Claude Desktop에서는 Claude 디렉터리(claude.ai/directory/upload-post, 또는 Customize > Connectors에서 Upload-Post 검색)에서 공식 Upload-Post 커넥터를 추가하고 Connect를 클릭한 뒤 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

OAuth가 편하다면 --header 줄을 빼고, Claude Code 안에서 /mcp를 실행해 로그인하세요. 모든 프로젝트에서 서버를 쓰려면 --scope user를 추가합니다.

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

Cursor

프로젝트 하나에만 쓰려면 .cursor/mcp.json에, 모든 프로젝트에 쓰려면 ~/.cursor/mcp.json에 넣고 Cursor를 다시 불러오세요.

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

API 키는 app.upload-post.com의 API Keys 메뉴에 있습니다. 첫 게시 전에 대시보드에서 TikTok 계정을 프로필에 연결하세요. 에이전트는 그 프로필 이름을 user 값으로 넘깁니다. ChatGPT에서는 Apps에서 Upload-Post를 검색해 Connect를 누르면 되고, 설정 파일은 필요 없습니다.

예시: AI로 만든 클립을 올바른 라벨과 함께 게시하기

이름, ID, URL은 예시용이며 실제 고객 대화가 아닙니다. 도구 이름과 파라미터는 서버가 실제로 제공하는 그대로입니다.

사용자

https://example.com/clips/launch.mp4 를 내 프로필 "studio"로 TikTok에 올려 줘. 캡션: "30초로 보는 새 편집기". AI로 만든 영상이니 라벨을 붙이고, 듀엣은 꺼 줘.

  1. 도구 호출 1

    tiktok_publishing_settings

    게시하기 전에 이 계정에서 허용되는 공개 범위를 확인합니다.

    arguments
    {
      "profile": "studio"
    }
    result (일부 생략)
    {
      "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. 도구 호출 2

    upload_video

    백그라운드에서 게시하고 추적용 request_id를 돌려줍니다.

    arguments
    {
      "videoPathOrUrl": "https://example.com/clips/launch.mp4",
      "user": "studio",
      "platforms": [
        "tiktok"
      ],
      "title": "30초로 보는 새 편집기",
      "asyncUpload": true,
      "platformOptions": {
        "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
        "tiktokDisableDuet": true,
        "tiktokIsAigc": true
      }
    }
    result (일부 생략)
    {
      "success": true,
      "message": "Upload initiated successfully in background.",
      "request_id": "9f3c1a7e-5b2d-4c8e-a1f0-2d7b6e4c9a10",
      "total_platforms": 1
    }
  3. 도구 호출 3

    get_status

    TikTok이 게시를 확인할 때까지 상태를 조회합니다.

    arguments
    {
      "requestId": "9f3c1a7e-5b2d-4c8e-a1f0-2d7b6e4c9a10"
    }
    result (일부 생략)
    {
      "request_id": "9f3c1a7e-5b2d-4c8e-a1f0-2d7b6e4c9a10",
      "status": "completed",
      "completed": 1,
      "total": 1,
      "results": [
        {
          "platform": "tiktok",
          "success": true
        }
      ]
    }

어시스턴트

"studio" 프로필로 TikTok에 게시했습니다. AI 생성 라벨을 붙였고 듀엣은 껐습니다.

  • TikTok이 파일 자체(형식, 길이, 프레임 레이트)를 거부하면 get_status가 tiktok_media_rejected를 알려 줍니다. 같은 파일로 다시 시도해도 또 실패합니다. tiktok_publish_failed는 다시 시도해 볼 만합니다.
  • 동영상은 공개 URL에 있어야 합니다. 호스팅된 MCP 서버는 내 컴퓨터의 파일을 읽을 수 없습니다.

임시 저장과 사진 캐러셀

upload_video: 클립을 TikTok 임시 저장함(인박스)으로 보내, 앱에서 사운드를 넣고 게시할 수 있게 합니다. 임시 저장 모드에서 TikTok은 API로 보낸 캡션과 공개 범위를 무시합니다.

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

upload_photos: 첫 번째 이미지를 커버로 쓰고 음악을 자동으로 넣는 사진 캐러셀.

{
  "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가지",
  "description": "넘기면서 하나씩 해결법을 확인하세요.",
  "platformOptions": {
    "tiktokPrivacyLevel": "PUBLIC_TO_EVERYONE",
    "tiktokPhotoCoverIndex": 0,
    "tiktokAutoAddMusic": true
  }
}

승인된 앱을 통한 공식 TikTok API

TikTok MCP 서버가 내 계정에 접근하는 방식.

모든 게시물은 Upload-Post의 승인된 TikTok 앱으로 TikTok Content Posting API를 통해 나갑니다. TikTok 계정은 Upload-Post 대시보드에서 TikTok 자체 인증 화면으로 한 번만 연결합니다. 비밀번호 공유도, TikTok 앱 자동 조작도 없습니다.

직접 만들어 보려 했다면 이 승인이 왜 중요한지 아실 겁니다. TikTok은 감사를 통과하지 않은 API 클라이언트가 올린 게시물을 모두 비공개로 제한하고, 감사를 통과해야 풀어 줍니다. 호스팅된 서버를 쓰면 개발자 앱, 감사, 토큰 처리를 건너뜁니다.

허용되는 공개 범위는 TikTok이 계정마다 정합니다. 예를 들어 비공개 계정에는 PUBLIC_TO_EVERYONE이 없습니다. 에이전트는 먼저 tiktok_publishing_settings를 호출해 그 계정에 실제로 있는 공개 범위를 고를 수 있으므로, tiktok_privacy_unavailable 오류로 실패하지 않습니다.

음악, 위치 태그, 맞춤 커버, 댓글은 계정을 연결할 때 받은 권한에 따라 달라집니다. list_users가 TikTok 계정의 capabilities 배열로 보여 주며, TikTok을 다시 연결하면 새 권한이 반영됩니다.

출처: TikTok Content Posting API, Upload-Post TikTok 가이드, GitHub의 upload-post-mcp.

에이전트가 지키는 TikTok 한도

TikTok과 Upload-Post가 게시물 하나에 허용하는 범위, 2026년 9월 확인.

항목 한도 출처
동영상 캡션 2,200자(이모지는 2자로 계산) Upload-Post 글자 수 제한
사진 게시물 텍스트 제목 최대 90자, 설명 최대 4,000자 Upload-Post 글자 수 제한
동영상 MP4, MOV, WebM. API로는 3초~10분, 23~60fps, 각 변 최소 360px. Upload-Post는 3GB가 넘는 파일을 거부합니다. Upload-Post 동영상 요건
사진 JPG, JPEG, WebP, 게시물당 최대 35장, 장당 20MB. 1080 x 1920보다 큰 이미지는 자동으로 축소됩니다. Upload-Post 사진 요건
공개 범위 PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY. 계정별로 TikTok이 제한 Upload-Post TikTok 가이드
게시 빈도(TikTok) TikTok 계정당 분당 6개, 24시간에 15개 Upload-Post 동영상 요건

모든 MCP 클라이언트와 호환

같은 서버, 같은 도구입니다. AI 클라이언트를 선택하고 3단계 가이드를 따라 하세요.

이 TikTok 프롬프트들을 시도해 보세요

외울 명령어는 없습니다. 원하는 것을 설명하세요.

“이 동영상을 "marketing" 프로필로 TikTok에 게시하세요. 캡션: "봄 런칭 🌱".”
“이 클립을 처음 30초로 잘라 TikTok에 게시하세요.”
“이 TikTok을 마드리드 시간 금요일 오후 6시로 예약해 주세요.”
“최근 TikTok 5개의 성과는 어땠나요? 조회수와 완주율을 비교해 주세요.”

자주 묻는 질문

TikTok + AI 에이전트에 관한 모든 것. 최종 업데이트: 2026년 9월.

TikTok MCP 서버란 무엇인가요?

TikTok MCP 서버는 TikTok 게시 기능을 AI 에이전트가 호출할 수 있는 도구로 노출하는 Model Context Protocol 서버입니다. Upload-Post MCP 서버를 사용하면 ChatGPT, Claude, Gemini 또는 모든 MCP 클라이언트가 별도의 코드 없이 TikTok에 동영상과 사진 캐러셀을 업로드하고, 게시물을 예약하고, 애널리틱스를 가져올 수 있습니다.

AI 에이전트가 TikTok에 동영상을 게시할 수 있나요?

네. TikTok 계정을 Upload-Post에 한 번 연결하고 AI 클라이언트에 MCP 서버를 추가하면, 에이전트가 자연어 프롬프트로 캡션, 공개 범위, 예약 설정과 함께 동영상을 게시할 수 있습니다.

TikTok은 어떤 동영상 형식을 받나요?

API를 통하면 TikTok은 MP4, MOV, WebM 형식에 3초~10분, 23~60fps, 각 변 최소 360px인 동영상을 받습니다. 1080 x 1920보다 큰 사진은 자동으로 축소됩니다. 클립이 너무 길거나 형식이 맞지 않으면 에이전트가 submit_ffmpeg_job으로 먼저 자르거나 재인코딩할 수 있습니다.

TikTok MCP 서버는 무료인가요?

서버 코드는 MIT 라이선스의 무료 오픈 소스입니다. Upload-Post API 키로 연결하며, 계정은 무료로 만들 수 있습니다.

TikTok Ads MCP와 무엇이 다른가요?

하는 일이 다릅니다. TikTok이 직접 제공하는 TikTok for Business MCP 서버는 광고 쪽을 다룹니다. 캠페인, 광고 그룹, 타깃 오디언스, 카탈로그, 광고 리포트입니다. Upload-Post의 TikTok MCP는 오가닉 계정을 다룹니다. 동영상과 사진 캐러셀을 게시하고, 클립을 임시 저장함으로 보내고, 댓글에 답하고, 게시물 분석을 읽으며, 모두 TikTok 공식 개발자 API로 처리합니다. 광고도 집행하고 오가닉 게시도 한다면 두 서버를 같은 AI 클라이언트에 함께 연결할 수 있습니다.

TikTok 스크래퍼인가요?

아니요. 직접 연결한 본인 소유의 TikTok 계정만 TikTok 공식 API로 다룹니다. 다른 크리에이터의 동영상을 내려받거나 해시태그를 검색하거나 프로필 데이터를 수집하지 않습니다. 그런 일은 TikTok용으로 올라와 있는 스크래핑 MCP 서버들이 하는 일입니다.

에이전트가 영상을 바로 게시하지 않고 TikTok 임시 저장함으로 보낼 수 있나요?

네. platformOptions에서 tiktokPostMode를 MEDIA_UPLOAD로(또는 tiktokUploadToDraft를 true로) 설정하면 영상이 TikTok 인박스로 가고, 앱에서 마무리해 게시하면 됩니다. 임시 저장 모드에서 TikTok은 API로 보낸 캡션과 공개 범위를 무시합니다.

TikTok 사진 캐러셀도 올릴 수 있나요?

네. platforms를 ["tiktok"]으로 해서 upload_photos를 호출하면 JPG, JPEG, WebP 이미지 최대 35장으로 사진 게시물을 올립니다. tiktokPhotoCoverIndex로 커버를 고르고 tiktokAutoAddMusic으로 배경 음악을 넣습니다.

AI로 만든 영상에는 라벨을 어떻게 붙이나요?

platformOptions에 tiktokIsAigc: true를 넘기세요. 그러면 TikTok이 영상에 크리에이터가 AI 생성 콘텐츠로 표시했다는 라벨을 보여 줍니다.

에이전트는 하루에 TikTok을 몇 개까지 올릴 수 있나요?

TikTok 계정당 최근 24시간 기준 최대 15개, 분당 6개까지입니다. 이는 TikTok 자체의 한도입니다.

AI 에이전트에게 TikTok 운영을 맡기세요

무료로 시작, 신용카드 불필요. TikTok 계정을 한 번 연결하면 어떤 MCP 클라이언트에서든 게시할 수 있습니다.