OpenChatCut
- 추천0
- GitHub 별3.2K
- 영상라이선스AGPL-3.0
대화로 편집하는 로컬 AI 영상 편집기. 멀티트랙 타임라인 · Codex · Claude Code 연결(MCP) · Remotion 렌더. AGPL-3.0
요약
대화로 편집하는 로컬 AI 영상 편집기. 멀티트랙 타임라인 · Codex · Claude Code 연결(MCP) · Remotion 렌더. AGPL-3.0
설명
![]()
OpenChatCut
오픈소스 ChatCut 대안 · 에이전트 중심 · 로컬 우선 AI 영상 편집기
Codex, Claude Code, 그리고 내장 에이전트가 실제 영상 프로젝트를 읽고, 고치고, 내보낼 수 있어요. 결과물은 계속 직접 편집할 수 있는 프로젝트로 남아요.
웹사이트: openchatcut.com
OpenChatCut Pro · 데스크톱 판: 설치하고 바로 편집을 시작하세요
소개 · 제품 둘러보기 · 빠른 시작 · 에이전트 / MCP · 커뮤니티 · 후원사 · 변경 내역 · 스타 성장 · 기여하기

한 줄 지시에서 실제 타임라인까지: 에이전트, 미디어, 미리보기, 모션 그래픽, 전환, 효과, 멀티트랙 오디오가 하나의 프로젝트 안에서 함께 움직여요.
후원사
OfoxAI: 텍스트 · 이미지 · 영상 AI를 한 곳에서
OfoxAI는 텍스트 · 이미지 · 영상 AI를 위한 통합 API 플랫폼이고, Seedance, MiniMax(Hailuo), Wan 계열의 영상 모델을 제공해요. AI 애플리케이션, 에이전트, 창작 아이디어, 이미지 생성, 영상 소스에 쓸 모델을 한 플랫폼에서 고를 수 있어요.
APIXO AI: 이미지와 영상 제작을 한 곳에서
APIXO AI로 표지 이미지와 영상 소스를 만들어 보세요. 코딩 없이 브라우저에서 바로 작업하거나, API로 앱과 자동화 워크플로에 연결할 수 있어요.
Seedream 5.5 텍스트-이미지 API: 이미지당 $0.014부터, 기간 한정으로 공식 시작가보다 30% 할인. 할인은 자동으로 적용되고 프로모션 코드는 필요 없어요.
OpenChatCut이 도움이 되었다면 Ko-fi나 Afdian에서 계속 개발할 수 있도록 후원해 주세요.
OpenChatCut이란?
OpenChatCut은 오픈소스 ChatCut 대안이에요. 대화형 에이전트와 전문가용 타임라인 편집을 같은 작업 공간에 합친 영상 편집기예요. 독립적인 오픈소스(AGPL)이고, 상용 ChatCut 제품과는 관련이 없어요.
OpenChatCut = 로컬 영상 프로젝트 + 멀티트랙 타임라인 + AI 에이전트 + MCP + 제작용 내보내기.
더 이상 고칠 수 없는 영상을 만들어 내는 도구가 아니에요. 모든 편집은 프로젝트 안의 실제 트랙, 클립, 전환, 자막, 효과, 미디어에 기록돼요. 이어서 직접 편집하고, 실행 취소 · 다시 실행을 하고, 버전을 저장하고, 다른 에이전트에게 프로젝트를 넘길 수도 있어요.
OpenChatCut은 빈 채팅창에서 처음부터 다시 시작하거나 고칠 수 없는 생성 결과물에 매이지 않고, 전문가 수준의 제어를 지키면서 AI가 실제 편집 과정에 참여하길 원하는 크리에이터와 개발자를 위해 만들어졌어요.
-
웹사이트: https://openchatcut.com
-
오픈소스 ChatCut 대안 가이드: https://openchatcut.com/blog/open-source-chatcut-alternative
-
ChatCut vs OpenChatCut: https://openchatcut.com/blog/chatcut-vs-openchatcut
-
🤖 에이전트 중심: 내장 에이전트와 외부 MCP 에이전트가 같은 편집 도구를 공유해요.
-
🎞️ 실제 타임라인: 여러 개의 영상 · 오디오 트랙, 전환, 효과, LUT, 줌, 키프레임을 지원해요.
-
📝 대본 기반 편집: 단어 단위 받아쓰기, 텍스트로 컷 편집, 정적 처리, 화자 구분, 연결된 자막을 지원해요.
-
✨ 생성과 미디어: 이미지, 영상, 음성, 음악, 효과음 생성과 온라인 미디어 검색을 지원해요.
-
🧩 모션 그래픽과 WebGL: 편집 가능한 모션 템플릿, 사용자 정의 셰이더, 시각 효과, 전환을 지원해요.
-
👁️ 시각 기하 인식: 브라우저 안에서 사람을 분리하고 얼굴 안전 영역을 잡아요. 자막이 화자를 자동으로 피하고, 리프레임이 피사체를 따라가고, 오버레이 그래픽이 빈 공간에 놓여요.
-
📦 제작용 내보내기: MP4, 오디오, 자막, FCPXML, 전체 프로젝트 데이터를 내보내요.
-
🖥️ 로컬 우선: 프로젝트와 미디어는 기본적으로 내 컴퓨터에 남고, API 키는 서버 쪽에만 있어요.
커뮤니티
OpenChatCut 커뮤니티에 참여해 작업 방식을 이야기하고, 의견을 나누고, 개발 소식을 받아 보세요.
- Discord 참여
- 아래 QR 코드를 위챗으로 스캔하세요.

제품 둘러보기
아래 스크린샷은 정적인 시안이 아니라 실제 OpenChatCut 프로젝트와 에디터 화면이에요.

로컬 프로젝트 관리 — 여러 실제 프로젝트를 만들고, 가져오고, 복제하고, 내보내고, 이어서 편집해요.

에이전트 주도 편집 전 과정 — 음악을 만들고, 도구를 부르고, 전환 · 자막 · 멀티트랙 미디어를 타임라인에 바로 써 넣어요.

모션 그래픽과 에이전트 — 모션 템플릿을 둘러보거나, 에이전트가 편집 가능한 MG 클립을 만들고 조립하게 하세요.

WebGL 시각 효과 — 픽셀화, 듀오톤, 어안 렌즈, 만화경, 부드럽게, 빛 번짐 등을 클립에 바로 적용해요.

카메라 움직임과 줌 — 밀기, 당기기, 느린 줌, 빠른 줌, 이징 카메라 효과가 타임라인과 바로 연동돼요.

LUT와 색감 스타일 — 같은 기준 프레임에서 카메라 변형과 필름 룩을 실시간으로 비교해요.
왜 OpenChatCut인가요?
전통적인 편집기는 정밀한 제어에 강하고, 한 번에 만드는 AI 영상 생성기는 결과를 빨리 내는 데 강해요. OpenChatCut은 계속 편집할 수 있는 하나의 프로젝트로 두 방식을 이어 줘요.
| 기능 | 전통적인 타임라인 편집기 | 한 번에 만드는 AI 영상 생성 | OpenChatCut |
|---|---|---|---|
| 트랙 · 클립 단위의 정밀함 | ✅ | ❌ | ✅ |
| 자연어로 프로젝트 수정 | ❌ | ✅ | ✅ |
| 확인하고 되돌릴 수 있는 변경 | ✅ | 대체로 불가능 | ✅ |
| 연결된 대본과 화면 | 일부 | ❌ | ✅ |
| Codex / Claude Code에서 직접 제어 | ❌ | ❌ | ✅ MCP |
| 내장 · 외부 에이전트 협업 | ❌ | ❌ | ✅ 도구 공유 |
| 로컬 프로젝트와 BYOK(내 키 쓰기) | 제품마다 다름 | 대체로 클라우드 기반 | ✅ |
핵심 편집 흐름:
Describe the goal → Agent reads the project → Produces verifiable edits → Writes to the timeline
→ Preview / adjust / undo → Captions and mixing → Export
목표를 설명 → 에이전트가 프로젝트를 읽음 → 검증할 수 있는 편집을 만듦 → 타임라인에 기록 → 미리보기 · 조정 · 실행 취소 → 자막과 믹싱 → 내보내기
핵심 기능
| 영역 | 구현된 기능 |
|---|---|
| 타임라인 | 멀티트랙 편집, 이동, 트림, 분할, 리플 편집, 스냅, 키프레임, 마커, 실행 취소 · 다시 실행 |
| 시각 | WebGL 효과, LUT, 크로마키, 줌, 전환, 사용자 정의 셰이더 |
| 오디오 | 여러 오디오 트랙, 효과음, 배경음악, 내레이션 녹음, 음량, 자동 더킹, 목소리 분리 |
| 대본 | 받아쓰기 작업, 단어 단위 편집, 정적 압축, 검색, 화자, 클립 보기 |
| 자막 | 자동 자막, 이름 붙인 스타일, 번역, 타임라인 오버레이, SRT 내보내기 |
| 모션 그래픽 | 기본 템플릿, 보안 샌드박스, 사용자 정의 템플릿, 영상 렌더링 |
| AI 생성 | 이미지, 영상, 음성, 음악, 효과음 작업과 진행 상황 추적 |
| 미디어 | 업로드, 폴더, 온라인 이미지 · 영상 · 오디오 검색, Firecrawl 시각 미디어 대체 수단 |
| 내보내기 | MP4, 오디오, 자막, FCPXML, 프로젝트 가져오기 · 내보내기, 내보내기 기록, 하드웨어를 인식하는 H.264 가속, 자원을 고려한 내보내기 대기열 |
| 게시 | 완성된 렌더를 Upload-Post로 TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky에 에이전트가 게시. 먼저 미리보기와 명시적 확인을 거쳐요 |
| 에이전트 | 내장 대화형 에이전트, 스킬, 제안 기반 편집, 외부 Streamable HTTP MCP |
커뮤니티 리소스
OpenChatCut 리소스 라이브러리는 재사용할 수 있는 MG 애니메이션, 효과음, 전환, 시각 효과, 줌, LUT를 모아 둔 공유 카탈로그예요.

찾아서 설치하기
- 시각 카드에 마우스를 올리면 전체 결과를 볼 수 있고, 오디오 리소스는 내려받기 전에 재생해 볼 수 있어요.
- 리소스의 설치 URL을 OpenChatCut의 확장 센터에 복사하거나 원본 패키지를 내려받으세요.
- 에디터 안에서 웹사이트 카탈로그를 둘러보고 설치한 확장을 로컬에서 관리하세요.
리소스 기여하기
- [리소스 기여]를 열고 카테고리를 고르세요.
- 리소스와 카테고리별 미리보기 입력을 올리면 사이트가 게시용 미리보기를 렌더링해요.
- 제작자와 라이선스 정보를 추가하고 검토 · 게시를 신청하세요.
설치할 수 있는 시각 리소스는 에디터의 openchatcut-plugin@1 형식과 런타임 검증을 써요. 공식 OpenChatCut 리소스는 MIT 라이선스를 쓰고, 커뮤니티 기여자는 제출할 때 라이선스를 고르며, 게시된 카드마다 제작자와 라이선스가 표시돼요.
사용 사례
- 토킹 헤드 · 인터뷰 편집: 오디오나 영상을 받아쓰고, 실수 · 정적 · 반복을 텍스트로 지우고, 자막을 자동으로 만들어요.
- 빠른 멀티 포맷 조립: 영상, 이미지, 오디오를 가져오면 에이전트가 러프 컷, 전환, 배경음악, 속도감을 만들어 줘요.
- 숏폼 · 소셜 콘텐츠: 캔버스 비율을 바꾸고 제목, 자막, 내레이션, 음악, 시각 패키지를 만들어요.
- 모션 그래픽: 기본 템플릿을 쓰거나 에이전트에게 편집 가능한 모션 그래픽 클립을 만들게 해요.
- 개발자 자동화: MCP로 Codex, Claude Code 등 호환 클라이언트가 실제 프로젝트를 살펴보고 고치게 해요.
작업 흐름
- 프로젝트를 만들고 로컬 미디어를 가져와요.
- 타임라인에서 직접 편집하거나 원하는 결과를 말로 설명해요.
- 에이전트가 프로젝트 맥락을 읽고 편집 도구를 불러요.
- 제안을 검토하고 결과를 미리본 뒤 적용하거나, 조정하거나, 되돌려요.
- 자막, 오디오, 효과, 색감을 마무리해요.
- 영상, 오디오, 자막, FCPXML, 전체 프로젝트를 내보내요.
빠른 시작
데스크톱 설치 파일
GitHub Releases에서 최신 macOS, Windows, Linux 빌드를 내려받으세요. 현재 릴리스에는 애플 실리콘 · 인텔 Mac용 DMG 설치 파일, x64 Windows 설치 파일, x64 Linux AppImage가 들어 있어요.
아직 초기 빌드예요. macOS 패키지는 아직 서명 · 공증이 되어 있지 않아서 처음 실행할 때 운영체제에서 직접 허용해야 할 수 있어요.
소스에서 실행
Node.js 24.x와 npm이 필요해요. 지원하는 Node.js 범위는 package.json이 정하고, .nvmrc가 Node 버전 관리 도구에 맞는 메이저 버전을 알려 줘요.
Linux x64에서는 npm install이 ONNX Runtime의 선택 CUDA 공급자(NuGet에서 수백 MB)도 내려받아요. CPU만 쓰려면 대신 ONNXRUNTIME_NODE_INSTALL=skip npm install을 실행하세요.
git clone https://github.com/0xsline/OpenChatCut.git
cd OpenChatCut
npm install
cp .env.example .env.local
npm run dev
다음 주소를 여세요:
http://localhost:5199
에디터는 브라우저의 보안 컨텍스트가 필요해요. OpenChatCut을 실행하는 컴퓨터의 http://localhost 또는 http://127.0.0.1로 열거나 HTTPS로 제공하세요. 다른 기기(LAN IP나 리버스 프록시)에서 일반 HTTP로 열면 브라우저가 Web Crypto, WebCodecs, 클립보드를 막아서, 프로젝트 목록은 불러와도 에디터는 열리지 않고 이 요구사항을 안내해요.
실제로 쓰는 모델이나 미디어 서비스의 자격 증명만 .env.local에 추가하세요. 서드파티 자격 증명이 없는 기능은 키가 없다고 분명히 알려 주고, 로컬 타임라인 편집, 내장 미디어, 그 밖에 설정된 기능은 계속 동작해요.
개발용 실행은 기본적으로 Git 체크아웃 · 워크트리마다 분리돼요. npm run dev와 npm run desktop:dev는 그 체크아웃의 프로젝트, 가져온 미디어, 생성 작업, 자격 증명, 설정, 로컬 권한 상태를 ~/.openchatcut/dev-profiles/ 아래 자기 프로필에 따로 보관해요. 예전 공유 개발 저장소가 꼭 필요할 때만 npm run dev:shared를 쓰세요.
내장 에이전트 인증
- API 키: 설정 → 에이전트 모델을 열어 공급자를 고르고 API 키와 모델을 저장하세요. 키는 서버 쪽에만 남아요.
- ChatGPT 구독: 공식 Codex CLI 0.146.0 이상을 설치한 뒤 설정 → 에이전트 모델 → OpenAI · Codex를 여세요. 브라우저나 기기 코드 방식으로 로그인하고, 계정의 모델을 불러오고, 모델별 추론 강도를 고르거나(기본값 유지 가능) 채팅 모델 선택에서 Codex를 고르세요. OpenChatCut은 전용 Codex 프로필을 쓰고, 자격 증명 저장 · 토큰 갱신 · 로그아웃은 공식 CLI가 맡으며, OAuth 토큰은 브라우저에 노출되지 않아요.
- Claude 구독: OpenChatCut은 Claude OAuth 자격 증명을 모으지 않아요. 아래의 로컬 MCP 연결로 Claude Code를 쓰세요. 내장 에이전트는 API 키로 Anthropic을 쓸 수 있어요.
내장 에이전트의 모델 루프는 항상 로컬 서버에서 돌아요. 채팅, 초안, 제안은 페이지를 새로 고치거나 로컬 서비스를 다시 시작해도 남아요. 타임라인 변경은 여전히 활성 에디터의 검증된, 되돌릴 수 있는 명령을 거쳐요.
에이전트의 로컬 경로 접근(고급)
데스크톱 에이전트는 기본적으로 마운트된 미디어 드라이브를 포함해 운영체제가 허용하는 모든 로컬 폴더를 둘러볼 수 있어요. browse_local_media는 폴더와 지원되는 미디어를 나열하고, 파일 이름이나 상대 경로 · 미디어 종류로 검색하고, 가져오지 않은 채 쪽 나눈 결과를 돌려줘요. 그다음 에이전트는 선택한 경로 최대 100개에 import_assets, 하나에 import_asset, 폴더 전체에 import_folder를 쓸 수 있어요. 가져오기는 미디어 분석과 참조 등록을 재사용하고, 원본 파일을 보존하고, 한 번에 가져온 묶음 안의 중복을 포함해 같은 내용의 중복은 건너뛰어요. TXT, Markdown, DOCX, PDF 같은 문서 파일은 채팅에 첨부해야 해요. 데스크톱 앱에서는 이 도구가 기본으로 켜져 있고, 브라우저 세션에서도 동작하지만 AGENT_IMPORT_ROOTS에 적은 폴더만 되고 에디터가 OpenChatCut을 실행하는 같은 컴퓨터에서 제공될 때만 돼요.
로컬 접근을 제한하려면 .env.local에 AGENT_IMPORT_ROOTS=/Volumes/Media,D:\Projects처럼 쉼표로 구분한 값을 넣으세요. 비워 두면 데스크톱 앱은 기본적으로 제한 없이 폴더에 접근해요(브라우저 세션은 허용 목록이 필요하고, 비어 있으면 이 도구를 거부해요). 명시한 제한은 둘러보기와 가져오기 둘 다에 적용돼요. 소스 체크아웃은 시작할 때 저장소의 파일을 읽어요. 패키지된 데스크톱 빌드는 Electron 사용자 데이터 폴더에서 읽어요: macOS는 ~/Library/Application Support/OpenChatCut/, Windows는 %APPDATA%\OpenChatCut\, Linux는 $XDG_CONFIG_HOME/OpenChatCut/(보통 ~/.config/OpenChatCut/)예요. 파일을 고친 뒤에는 다시 시작하세요.
로컬 H.264 내보내기는 macOS에서는 VideoToolbox, 호환되는 Windows에서는 NVENC를 자동으로 우선 쓰고, 안 되면 소프트웨어 인코딩으로 돌아가요. 렌더 동시성과 무거운 내보내기 한도는 OPENCHATCUT_RENDER_CONCURRENCY와 OPENCHATCUT_MAX_ACTIVE_EXPORTS로 조정하고, 하드웨어 인코딩은 OPENCHATCUT_DISABLE_HARDWARE_ENCODING으로 끄고, FFmpeg 쪽 인코더 선택은 OPENCHATCUT_H264_ENCODER로 바꿀 수 있어요. 자세한 내용은 .env.example을 보세요.
애플 실리콘에서는 VideoToolbox 인코딩이 켜져 있어도 렌더 작업자를 늘리면 영상이 많은 내보내기가 오히려 느려질 수 있어요. M4 Max 벤치마크와 내 작업량으로 시험하는 방법은 macOS 렌더 튜닝을 보세요. 이 측정값이 다른 Mac이나 Windows의 기본값을 정해 주지는 않아요.
데스크톱 개발
npm run desktop:dev
데스크톱 앱은 같은 내장 서비스를 가진 Electron 셸을 써요. 웹 개발 빌드와 데스크톱 빌드는 프로젝트, 에이전트, 생성, 내보내기 로직을 공유해요.
프로젝트 상태
OpenChatCut은 활발히 개발 중이에요. 에디터, 프로젝트 형식, 에이전트 도구는 계속 바뀔 수 있어요. 미리 빌드한 macOS, Windows, Linux 설치 파일은 GitHub Releases에 올라오고, 개발과 문제 해결에는 소스에서 실행하는 방법이 가장 투명해요.
핵심 타임라인, 로컬 프로젝트, 내장 미디어, 수동 편집은 클라우드 서비스에 기대지 않아요. AI 모델, 온라인 미디어, 생성, 받아쓰기 같은 연결 기능은 해당 서비스를 설정한 뒤에만 켜져요.
Codex / Claude Code에서 OpenChatCut 쓰기
OpenChatCut 에이전트 스킬 하나를 설치하세요:
npx skills add 0xsline/OpenChatCut
그다음 에이전트에게 Set up OpenChatCut(OpenChatCut 설정해 줘)이라고 말하세요. 설치된 라우터가 로컬 MCP 연결을 등록하고 에디터의 전문 스킬 26개를 필요할 때 불러오기 때문에, 에이전트의 스킬 목록이 간결하게 유지돼요.
사용자 정의 스킬은 ~/.codex/skills / ~/.claude/skills와 같은 구조의 사용자가 볼 수 있는 폴더에 있어요:
~/.openchatcut/skills/<slug>/SKILL.md (Windows: %USERPROFILE%\.openchatcut\skills\...)
에이전트에게 manage_skill create를 시키거나(또는 기본 제공 skill-creator 워크플로를 쓰면) 그곳에 SKILL.md를 써 줘요. 직접 고치고 공유할 수 있어요. 그 폴더에 SKILL.md를 넣으면 에이전트가 쓸 수 있게 되고, 채팅의 / 명령이나 창작 모드 선택기에서 워크플로를 고르면 다음 메시지에 적용돼요.
OpenChatCut은 Streamable HTTP MCP 엔드포인트를 제공해요:
http://localhost:5199/api/external-mcp/mcp
저장소 루트의 .mcp.json에 이미 로컬 연결이 들어 있어요. 타임라인 도구를 쓰기 전에 OpenChatCut을 실행하고 대상 프로젝트를 여세요. 프로젝트 목록 · 생성 · 이동 도구는 에디터가 열려 있지 않아도 돼요.
Codex 앱/CLI와 Claude Code는 같은 세션 흐름을 써요:
begin_edit_session을 부르고 돌려받은editSessionId를 보관하세요.approvalMode는manual(기본값) 또는auto로 정해요.- 그 id를 모든 프로젝트 읽기 · 편집 도구에 넘기세요. 변경은 격리된 초안에만 적용돼요.
- 초안이 준비되면
review_edit_session을 부르세요. manual모드에서는 열려 있는 OpenChatCut 프로젝트 안에서 제안을 검토하고, 미리보고, 선택하고, 승인하거나 거부해요.auto모드에서는review_edit_session이 초안 전체를 바로 적용해요. 클라이언트는get_edit_session을 조회해applied,rejected,discarded상태를 알 수 있어요.
Codex나 Claude에서의 승인은 클라이언트가 도구를 부를 수 있는지를 정해요. OpenChatCut 프로젝트 승인은 manual 세션에만 필요하고, auto 세션은 그 검토를 명시적으로 건너뛰어요. 어느 모드든 적용된 작업은 하나의 실행 취소 단계로 한꺼번에 반영돼요.
auto 세션이 오래되어 맞지 않게 되면, 수동 승인으로 되돌아가지 않고 오류를 돌려줘요. 그 세션을 버리고 새로 시작하세요.
이런 세션에는 초안에 안전한 프로젝트 읽기 · 편집 도구만 열려요. 생성, 내보내기, 프로젝트 삭제 등 바로 부작용이 생기는 도구는 거부된 제안을 되돌릴 수 없으므로 쓸 수 없어요.
Codex
Codex 설정에 다음을 추가하세요:
[mcp_servers.openchatcut]
url = "http://localhost:5199/api/external-mcp/mcp"
Claude Code
claude mcp add --transport http openchatcut \
http://localhost:5199/api/external-mcp/mcp
그다음 에이전트에게 편집 작업을 바로 설명할 수 있어요:
Start an OpenChatCut edit session. Read the draft, add a scratch sound effect
at 8 seconds on the second audio track, and add a glitch transition between
the adjacent video clips. Submit the draft for review and wait for the user to
approve it in OpenChatCut before reporting that the edit was applied.
(예시 뜻: OpenChatCut 편집 세션을 시작해서, 초안을 읽고 두 번째 오디오 트랙 8초 지점에 스크래치 효과음을 넣고 이웃한 영상 클립 사이에 글리치 전환을 넣으세요. 초안을 검토에 제출하고, 사용자가 OpenChatCut에서 승인할 때까지 기다린 뒤에 편집이 적용되었다고 보고하세요.)
외부 에이전트는 에디터 자신과 같은 내부 편집 도구와 EditorCore 명령을 불러요. 서로 어긋날 수 있는 별도의 프로젝트 형식이 없고, 외부 초안을 준비하는 동안 실제 타임라인은 바뀌지 않아요.
Qoder
Qoder도 한 번에 연결돼요. 안내 화면의 Connect 단추가 엔드포인트와 Bearer 토큰을 Qoder 자체 설정 파일에 써 주고, 이미 있던 관련 없는 설정이나 MCP 서버는 그대로 둬요.
~/.qoder/settings.json (international build)
~/.qoder-cn/settings.json (China build — written as well when installed)
{
"mcpServers": {
"openchatcut": {
"type": "http",
"url": "http://localhost:5199/api/external-mcp/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}
그 뒤 Qoder를 다시 시작해 서버를 불러오세요.
Qwen Work (千问办公)
千问办公은 사용자 정의 MCP 서버를 설정 파일이 아니라 자체 커넥터 저장소에 보관하기 때문에, OpenChatCut이 대신 써 줄 수 없어요. 안내 화면에서 千问办公 카드의 Copy config(설정 복사)를 누른 뒤, 千问办公에서 连接器 → 自定义 MCP → 添加를 열어 JSON을 붙여 넣고 저장하세요:
{
"mcpServers": {
"openchatcut": {
"type": "streamable-http",
"url": "http://localhost:5199/api/external-mcp/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}
MCP 접근 보호하기
MCP 엔드포인트를 직접 외부에 열 때는 다음을 설정하세요:
OPENCHATCUT_MCP_TOKEN=your-token
OPENCHATCUT_EDITOR_URL=https://your-editor.example.com
클라이언트는 Authorization: Bearer <token>을 보내야 해요. 현재의 브리지는 여러 사용자가 쓰는 서비스가 아니라 한 컴퓨터의 한 사용자를 위해 설계되었어요.
구조
하나의 공유된 에이전트 도구와 EditorCore 명령 묶음이 내장 에이전트, 외부 MCP 클라이언트, 실제 타임라인, 로컬 데이터, 제작용 내보내기를 이어 줘요.
| 계층 | 기술 |
|---|---|
| 프론트엔드 | React 19, TypeScript 6, Vite 8 |
| 편집 코어 | 불변 타임라인 상태, 명령 계층, 제안 기반 적용 |
| 에이전트 | Vercel AI SDK 7 (Anthropic, OpenAI, Gemini, Kimi, Qwen, GLM, DeepSeek, MiniMax, Xiaomi MiMo, Mistral, API 키 또는 SuperGrok/X Premium+ 구독 로그인으로 쓰는 xAI Grok, OpenRouter, OrcaRouter, OFox, Requesty, Cheaper Inference, Runcrate, 호환 API), Agent Skills, MCP SDK |
| 미리보기와 시각 효과 | Remotion Player, WebGL / GLSL |
| 서버 | Vite / Electron 이중 호스트 플러그인과 서버 쪽 키 저장소 |
| 저장 | ~/.openchatcut 아래 공유 로컬 프로젝트 저장소, IndexedDB 캐시, 설정할 수 있는 로컬 미디어 폴더, 선택 사항인 Cloudflare R2 |
| 데스크톱 | Electron 43 |
| 내보내기 | Remotion, FFmpeg, FCPXML, SRT |
폴더 개요
| 폴더 | 역할 |
|---|---|
src/editor/ | UI와 LLM에 의존하지 않는 타임라인 상태와 명령 |
src/agent/ | 에이전트 구성, 도구, 스킬, 진행 상황, 설정 |
src/library/ | 모션 그래픽, 효과음, 전환, 효과, LUT 등의 라이브러리 UI |
src/transcript/ | 받아쓰기, 단어 단위 편집, 대본 UI |
src/captions/ | 자막 모델, 스타일, 조작, 미리보기 레이어 |
src/gl/ | WebGL 효과, 전환, 셰이더 런타임 |
src/generate/ | 이미지, 영상, 음성, 음악, 효과음 생성 클라이언트 |
src/persist/ | 프로젝트, 채팅, 버전, 미디어 저장 |
server/plugins/ | 생성, 받아쓰기, 미디어, 내보내기, 저장 서비스 |
desktop/ | Electron 메인 프로세스와 내장 서비스 |
remotion/ | 헤드리스 렌더링과 내보내기 파이프라인 |
데이터와 개인정보
- 프로젝트, 채팅 기록, 버전 데이터는
~/.openchatcut아래 공유 로컬 저장소에 보관돼요. IndexedDB는 브라우저 쪽 캐시와 예전 데이터 이전에 쓰여요. - 사용자 미디어는 백업하거나 옮길 수 있는 로컬 미디어 폴더에 저장돼요.
- AI 요청이 내 컴퓨터를 벗어나는지는 설정한 모델, 생성, 미디어 서비스에 따라 달라요.
- 설정하지 않은 클라우드 기능은 로컬 타임라인이나 기존 미디어 편집에 영향을 주지 않아요.
- MCP를 외부에 열 때는 Bearer 토큰을 설정하고 에디터 엔드포인트로의 네트워크 접근을 제한하세요.
보안 모델
- API 키는 서버 쪽 설정에서만 쓸 수 있어요. 공급자 자격 증명을
VITE_로 브라우저에 노출해서는 안 돼요. - LLM 출력, 플러그인 패키지, 템플릿 코드, 사용자 입력은 신뢰 경계에서 검증돼요.
- 모션 그래픽과 셰이더 코드는 제한된 샌드박스에서 실행되고, 전용 검사가 악성 템플릿을 막아요.
- 에이전트는
EditorCore명령으로만 프로젝트를 바꾸기 때문에 편집을 추적하고 되돌릴 수 있어요. - MCP는 기본적으로 로컬에만 연결되고, 공개 엔드포인트는 Bearer 토큰 인증을 지원해요.
- 로컬 미디어 폴더와 R2 자격 증명은 서버가 관리하고 프로젝트 JSON에는 쓰이지 않아요.
Fal.ai 이미지 · 영상 생성
Fal.ai는 모델 카탈로그가 분명한 선택형 이미지 · 영상 생성 공급자예요. 설정 → AI 생성 → 이미지 또는 영상 → Fal.ai에서 설정하세요. 지원하는 모드, 서버 전용 자격 증명, 생성 크레딧을 쓰지 않는 점검 방법은 Fal 설정, 지원 모델, 확장 안내를 보세요.
개발과 검증
# Type checking and production build
npm run build
# Core regression checks
npm test
# Static analysis
npm run lint
에이전트, 타임라인, 미리보기, 내보내기 경로를 바꾼 뒤에는 최소한 다음을 실행하세요:
npx tsc -b --force
npm test
npm run build
기술 기반
OpenChatCut은 다음 핵심 프로젝트와 사양 위에 만들어졌어요.
| 프로젝트 / 사양 | OpenChatCut에서의 역할 |
|---|---|
| ChatCut-Inc/agent-plugin | 에이전트 스킬의 기반. OpenChatCut이 이 플러그인의 스킬 구조와 워크플로를 자신의 로컬 에디터, 저장소, MCP, 도구 구조에 맞게 고쳐 썼어요. Agent Skills 출처 표기 안내를 보세요. |
| Remotion | React 기반 영상 미리보기, 구성, 서버 쪽 렌더링의 핵심 기반. |
| Model Context Protocol | Codex, Claude Code 등 외부 에이전트가 프로젝트와 타임라인 도구에 접근하게 하는 프로토콜 기반. |
| Vercel AI SDK | 내장 에이전트를 위한, 공급자에 얽매이지 않는 모델 스트리밍과 도구 호출. |
| tt-a1i/archify | README의 런타임 구조 그림을 정의 · 검증 · 생성하는 데 쓴 도구. |
지앤잉(JianYing) / CapCut 초안 내보내기는 capcut-cli로 구현돼요.
이 목록은 프로젝트의 주요 기술 기반을 다룬 것이고, 개별 의존성 · 글꼴 · 바이너리에 포함된 라이선스를 대신하지 않아요. JavaScript 의존성 버전은 package-lock.json, 글꼴 라이선스는 assets/fonts/LICENSES.md를 보세요.
변경 내역
주요 변경 사항은 두 언어로 쓰인 CHANGELOG.md에서 보거나, GitHub Releases에 게시된 모든 패키지를 둘러보세요.
스타 성장
라이선스
OpenChatCut은 GNU Affero General Public License v3.0 이상으로 배포돼요. 서드파티 구성 요소와 에셋은 각자의 라이선스를 따라요.
에이전트 내장 웹 조사
web_search와 기본 web_browser 페이지 읽기는 FIRECRAWL_API_KEY가 필요한 Firecrawl을 써요. 계정이나 API 키가 필요 없는 Parallel Search MCP를 대신 쓰려면 .env.local에 WEB_SEARCH_PROVIDER=parallel을 넣고 다시 시작하세요. Parallel 검색은 출처 URL, 제목, 관련 발췌를 돌려주고, 페이지 읽기는 전체 HTML이나 스크린샷이 아닌 마크다운 발췌를 돌려줘요. 질의와 요청한 URL은 선택한 공급자에게 전송돼요. 익명 접근에는 서비스 할당량이 있고, 공급자 오류는 다른 공급자로 바꾸지 않고 그대로 돌려줘요.
WEB_SEARCH_PROVIDER를 비워 두거나 firecrawl로 두면 Firecrawl을 계속 쓰고, disabled로 두면 기본 검색과 페이지 읽기가 꺼져요. 도구 호출은 provider: "firecrawl"을 고를 수 있고, "parallel"은 Parallel을 켠 뒤에만 고를 수 있어요. 검색 지역 · 시간 필터, 스크린샷, 브라우저 동작, 구조화 추출, 전체 페이지 형식, 매핑, 크롤링, 일괄 스크래핑은 항상 Firecrawl과 그 키가 필요해요.
관련된 검색과 페이지 읽기 호출은 불투명한 대화 ID를 재사용해요. 채팅을 지우면 새 ID로 시작하고, 프로젝트 ID와 채팅 글은 그 ID로 쓰이지 않아요.
기여하기
main에서 브랜치를 만드세요.- 간단하지 않은 로직에는 실행할 수 있는 검사를 추가하세요.
- 커밋하기 전에
npm test,npm run lint,npm run build를 실행하세요. - 풀 리퀘스트를 열고 화면이나 영상 동작을 바꾼 경우 스크린샷이나 수용 근거를 넣으세요.
버그 신고와 기능 요청은 GitHub Issues를 쓰세요.
저장소: 0xsline/OpenChatCut
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0