ThumbnailGPT

ThumbnailGPT는 YouTube 크리에이터가 AI를 사용해 전문적이고 시선을 사로잡는 썸네일을 만들 수 있도록 도와줍니다. 사용자는 동영상 아이디어, 제목, 스크립트, 참고 이미지를 맞춤형 썸네일로 변환하고, 페르소나 참조 이미지를 사용해 얼굴의 일관성을 유지하며, 기존 썸네일 스타일을 재현하고, 장면, 조명, 구도를 맞춤 설정할 수 있습니다. MCP 통합을 통해 크리에이터는 도구를 전환하지 않고도 호환되는 AI 어시스턴트에서 직접 썸네일을 생성할 수 있습니다.

호스팅형 MCP 서버

npx add-mcp 'https://mcp.thumbnailgpt.com'

Claude Code, Codex, Cursor 등에 설치됩니다

문서

ThumbnailGPT Developer & API Documentation

Official developer reference for ThumbnailGPT. CLI commands, Model Context Protocol (MCP) streamable endpoints, API keys, and SDK integration guides.

Canonical: https://thumbnailgpt.com/docs Last updated: 2026-11-05

The ThumbnailGPT Developer Platform enables developers, automation pipelines, and autonomous AI agents to generate, recreate, and edit YouTube thumbnails programmatically.

Quickstart

1. Generate an API Key

Create a Personal API Key with prefix tgpt_live_ in your Account Settings.

2. Run via CLI

# Zero-install one-off execution
npx -y thumbnailgpt generate --prompt "10 AI Tools That Will Replace You in 2026" --ratio 16:9

# Install globally
npm install -g thumbnailgpt
thumbnailgpt --version

Model Context Protocol (MCP) Configuration

ThumbnailGPT provides an official MCP server adhering to the Model Context Protocol specification.

  • Remote Streamable HTTP URL: https://mcp.thumbnailgpt.com
  • Local Stdio Command: npx -y thumbnailgpt mcp

Example Client Config (claude_desktop_config.json or Cursor mcp.json)

{
  "mcpServers": {
    "thumbnailgpt": {
      "url": "https://mcp.thumbnailgpt.com",
      "headers": {
        "Authorization": "Bearer tgpt_live_YOUR_API_KEY_HERE"
      }
    }
  }
}

Available MCP Tools

  • thumbnailgpt_generate: Generate a complete thumbnail from video concept, text, and aspect ratio (16:9 or 9:16).
  • thumbnailgpt_recreate: Recreate and remix an existing thumbnail from a public YouTube video URL or image link.
  • thumbnailgpt_edit: Apply conversational inpainting to adjust scene lighting, elements, or typography.
  • thumbnailgpt_list_personas: Fetch available creator character face profiles for consistent likeness.
  • thumbnailgpt_get_credits: Inspect account credit balance.

Related