CapCut MCP: агент собирает и правит черновики CapCut

JmsLdrn/capcut-mcp· Проверено 12.11.2026· 20на GitHub

Даёт агенту собирать и править проекты CapCut на компьютере: ставить клипы, музыку, тексты и картинки на таймлайн, резать и двигать фрагменты, сохранять черновик для монтажа в приложении.

2 реализации:

Правит черновики CapCut Desktop прямо на диске: читает таймлайн, добавляет и режет фрагменты, перед записью делает резервную копию .mcpbak и проверяет черновик; сторонний API не нужен.

Как подключить

Что сделать до подключения

Node.js 18 или новее, ffmpeg и ffprobe в PATH

CapCut Desktop на Windows или macOS

Склонировать репозиторий и выполнить npm install

Закрыть в CapCut черновик, который будет править агент

CAPCUT_DRAFTS_DIR

папка Drafts CapCut; оставьте пустым, если черновики лежат в стандартной папке

CAPCUT_TEMPLATE_DRAFT

имя одного из ваших черновиков, где есть видео и текстовый слой: без него не работает capcut_add_text

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env CAPCUT_DRAFTS_DIR= --env 'CAPCUT_TEMPLATE_DRAFT=<имя вашего черновика с текстовым слоем>' --transport stdio capcut \
  -- node '<полный путь к capcut-mcp>/src/server.js'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.capcut]
command = "node"
args = ["<полный путь к capcut-mcp>/src/server.js"]

[mcp_servers.capcut.env]
CAPCUT_DRAFTS_DIR = ""
CAPCUT_TEMPLATE_DRAFT = "<имя вашего черновика с текстовым слоем>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "capcut": {
      "command": "node",
      "args": ["<полный путь к capcut-mcp>/src/server.js"],
      "env": {
        "CAPCUT_DRAFTS_DIR": "",
        "CAPCUT_TEMPLATE_DRAFT": "<имя вашего черновика с текстовым слоем>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "capcut": {
      "type": "stdio",
      "command": "node",
      "args": ["<полный путь к capcut-mcp>/src/server.js"],
      "env": {
        "CAPCUT_DRAFTS_DIR": "",
        "CAPCUT_TEMPLATE_DRAFT": "<имя вашего черновика с текстовым слоем>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "capcut": {
      "command": "node",
      "args": ["<полный путь к capcut-mcp>/src/server.js"],
      "env": {
        "CAPCUT_DRAFTS_DIR": "",
        "CAPCUT_TEMPLATE_DRAFT": "<имя вашего черновика с текстовым слоем>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "capcut": {
      "command": "node",
      "args": ["<полный путь к capcut-mcp>/src/server.js"],
      "env": {
        "CAPCUT_DRAFTS_DIR": "",
        "CAPCUT_TEMPLATE_DRAFT": "<имя вашего черновика с текстовым слоем>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "capcut": {
        "type": "local",
        "command": ["node", "<полный путь к capcut-mcp>/src/server.js"],
        "environment": {
          "CAPCUT_DRAFTS_DIR": "",
          "CAPCUT_TEMPLATE_DRAFT": "<имя вашего черновика с текстовым слоем>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "capcut": {
      "command": "node",
      "args": ["<полный путь к capcut-mcp>/src/server.js"],
      "env": {
        "CAPCUT_DRAFTS_DIR": "",
        "CAPCUT_TEMPLATE_DRAFT": "<имя вашего черновика с текстовым слоем>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "capcut": {
      "command": "node",
      "args": ["<полный путь к capcut-mcp>/src/server.js"],
      "env": {
        "CAPCUT_DRAFTS_DIR": "",
        "CAPCUT_TEMPLATE_DRAFT": "<имя вашего черновика с текстовым слоем>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

capcut_list_draftsперечисляет черновики

capcut_read_timelineчитает таймлайн целиком

capcut_clone_draftкопирует черновик под новый ролик

capcut_add_videoставит видео на дорожку

capcut_add_imageставит картинку

capcut_add_audioставит звук

capcut_add_textдобавляет текст поверх видео

capcut_add_trackсоздаёт новую дорожку

capcut_move_segmentдвигает фрагмент

capcut_trim_segmentподрезает фрагмент

capcut_split_segmentразрезает фрагмент

capcut_delete_segmentудаляет фрагмент

capcut_set_propsменяет масштаб, позицию, громкость, скорость

capcut_raw_patchвносит правку прямо в JSON черновика

capcut_validateищет наложения и пропавшие файлы

capcut_saveсохраняет черновик с резервной копией

capcut_discardотменяет несохранённые правки

Работает через отдельный сервер VectCutAPI на localhost:9001: собирает новый ролик с переходами, субтитрами из SRT, эффектами, стикерами и анимацией по ключевым кадрам.

Как подключить

Что сделать до подключения

Python и VectCutAPI: git clone https://github.com/sun-guannan/VectCutAPI.git, pip install -r requirements.txt, затем python capcut_server.py

Node.js; сервер собирается из исходников: npm install и npm run build

CAPCUT_API_URL

адрес запущенного VectCutAPI, по умолчанию http://localhost:9001

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env CAPCUT_API_URL=http://localhost:9001 --transport stdio capcut-mcp-server \
  -- node '<полный путь к capcut-mcp-server>/dist/index.js'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.capcut-mcp-server]
command = "node"
args = ["<полный путь к capcut-mcp-server>/dist/index.js"]

[mcp_servers.capcut-mcp-server.env]
CAPCUT_API_URL = "http://localhost:9001"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "capcut-mcp-server": {
      "command": "node",
      "args": ["<полный путь к capcut-mcp-server>/dist/index.js"],
      "env": {
        "CAPCUT_API_URL": "http://localhost:9001"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "capcut-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["<полный путь к capcut-mcp-server>/dist/index.js"],
      "env": {
        "CAPCUT_API_URL": "http://localhost:9001"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "capcut-mcp-server": {
      "command": "node",
      "args": ["<полный путь к capcut-mcp-server>/dist/index.js"],
      "env": {
        "CAPCUT_API_URL": "http://localhost:9001"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "capcut-mcp-server": {
      "command": "node",
      "args": ["<полный путь к capcut-mcp-server>/dist/index.js"],
      "env": {
        "CAPCUT_API_URL": "http://localhost:9001"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "capcut-mcp-server": {
        "type": "local",
        "command": ["node", "<полный путь к capcut-mcp-server>/dist/index.js"],
        "environment": {
          "CAPCUT_API_URL": "http://localhost:9001"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "capcut-mcp-server": {
      "command": "node",
      "args": ["<полный путь к capcut-mcp-server>/dist/index.js"],
      "env": {
        "CAPCUT_API_URL": "http://localhost:9001"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "capcut-mcp-server": {
      "command": "node",
      "args": ["<полный путь к capcut-mcp-server>/dist/index.js"],
      "env": {
        "CAPCUT_API_URL": "http://localhost:9001"
      }
    }
  }
}

Инструменты сервера

capcut_create_draftсоздаёт проект с размером кадра и fps

capcut_add_videoдобавляет клип с переходом и скоростью

capcut_add_audioдобавляет музыку с нарастанием и затуханием

capcut_add_textдобавляет текст с анимацией

capcut_add_imageдобавляет картинку поверх видео

capcut_add_subtitleимпортирует субтитры из SRT

capcut_add_keyframeанимирует по ключевым кадрам

capcut_add_effectнакладывает размытие и другие эффекты

capcut_add_stickerдобавляет стикер

capcut_save_draftсохраняет черновик для CapCut

capcut_get_durationузнаёт длительность файла

Что попросить агента

«Покажи, что лежит в черновике <имя черновика>: дорожки, фрагменты и их длительность»capcut-mcp вызовет capcut_list_drafts и capcut_read_timeline

«Сделай копию черновика <имя> и поставь в неё клипы <пути к файлам> подряд с музыкой <путь к треку>»capcut-mcp вызовет capcut_clone_draft, capcut_add_video и capcut_add_audio, проверит capcut_validate и сохранит capcut_save

«Разрежь клип на 12-й секунде и удали второй кусок»capcut-mcp вызовет capcut_split_segment и capcut_delete_segment, затем capcut_save

«Собери ролик 1920×1080 из <ссылка на видео>, добавь заголовок «<текст>» с 1-й по 4-ю секунду, музыку и плавный зум»CapCut MCP Server вызовет capcut_create_draft, capcut_add_video, capcut_add_text, capcut_add_audio, capcut_add_keyframe и capcut_save_draft

«Наложи на ролик субтитры из этого SRT: <текст SRT>»CapCut MCP Server вызовет capcut_add_subtitle и сохранит черновик через capcut_save_draft

Для каких задач

Собрать ролик из ваших клипов, музыки и титров в черновик CapCut

Нарезать и переставить фрагменты на таймлайне по таймкодам

Наложить субтитры из файла SRT

Сделать заготовку под Reels или Shorts копией готового черновика

Проверить черновик на наложения фрагментов и пропавшие файлы

Ограничения

Формат черновиков CapCut закрыт и без документации: обновление CapCut может его поменять, держите резервные копии

У capcut-mcp эффекты, переходы, анимации и сложное оформление текста сделаны без гарантий; надёжно работают размещение, подрезка, разрезка, простой текст и трансформации

capcut-mcp не сохраняет черновик, пока CapCut открыт или у черновика есть файл .locked

CapCut MCP Server от Atx-Guy написан за один день 13.01.2026 и с тех пор не обновлялся, пакета в npm нет; без запущенного VectCutAPI он не работает

Если не работает

capcut_add_text не работает

Задайте в CAPCUT_TEMPLATE_DRAFT имя своего черновика с текстовым слоем: значение по умолчанию 0723 — черновик автора, у вас его нет.

capcut_save отказывается сохранять

Закройте CapCut: сервер не пишет, пока приложение запущено или у черновика есть файл .locked. Флаг force: true ставьте, только если уверены, что это безопасно.

capcut-mcp не находит черновики

Если черновики лежат вне стандартной папки, например на другом диске, укажите путь в CAPCUT_DRAFTS_DIR.

CapCut MCP Server не отвечает

Проверьте, что VectCutAPI запущен на порту 9001 и CAPCUT_API_URL указывает на него.

CapCut MCP Server не находит медиафайлы

Дайте прямые доступные ссылки на файлы без перенаправлений и проверьте, что формат поддерживается.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
capcut-mcp	James Aldrin Boncales	20	локально	не нужен	17	7 августа 2026
CapCut MCP Server	Atx-Guy	94	локально	не нужен	11	13 января 2026

Частые вопросы

Какой из двух серверов выбрать?

Чтобы агент правил ваши черновики, подойдёт capcut-mcp: он читает таймлайн, режет и двигает фрагменты и сохраняет с резервной копией. CapCut MCP Server собирает новый ролик через VectCutAPI и умеет субтитры из SRT, стикеры и ключевые кадры, но требует отдельный сервер на Python.

Агент может испортить мой проект?

capcut-mcp перед записью кладёт рядом резервную копию .mcpbak, пишет файл атомарно и сразу проверяет черновик через capcut_validate. Новые черновики он делает копией рабочего, без сборки с нуля. Важные проекты всё равно лучше скопировать до пакетной правки.

Почему изменения не видны в CapCut?

У capcut-mcp правки копятся в памяти и попадают на диск только после capcut_save. Закройте черновик в CapCut до правки, потом сохраните и откройте его заново.

Есть готовый сценарий под Reels?

В capcut-mcp есть навык для Claude в папке skills/capcut-reels: запись, субтитры, графика, проверка через ffprobe и ffmpeg и сборка черновика CapCut через сервер. Скопируйте папку capcut-reels в папку навыков Claude.

Как подключить CapCut MCP к Claude Code?

Для capcut-mcp выполните claude mcp add capcut --scope user -- node "<полный путь>/src/server.js" и перезапустите Claude Code: инструменты появятся как mcp__capcut__*. Для CapCut MCP Server и других клиентов откройте нужную вкладку в блоке «Как подключить».

Есть ли MCP-сервер у самого CapCut?

Среди этих проектов нет: оба сделаны сторонними авторами и прямо пишут, что не связаны с CapCut и ByteDance.

Работает ли сервер из России?

Оба сервера запускаются на вашем компьютере рядом с CapCut Desktop, ключи и аккаунты для них не нужны.

CapCut MCP: агент собирает и правит черновики CapCut

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы