고객지원

막히는 게 있으면 바로 알려 주세요. 사람이 읽고 답합니다. 평일 기준 2 영업일 안에 회신합니다.

AI 편집 시작하기

다듬 데스크톱, MCP, CLI는 같은 프로젝트를 사용합니다. 에이전트에게 요청한 작업을 편집기 화면에서 확인하고 이어서 다듬을 수 있습니다.

1. 앱과 연결 도구 설치

Node.js 20 이상인 환경의 터미널에서 실행합니다. Linux x64와 Windows x64에서는 npm 설치 중에 데스크톱 앱도 설치합니다. 설치가 끝난 뒤 앱을 여세요.

npm install -g ugot-videoeditor-mcp
ugot-videoeditor open

Windows에서는 설치 프로그램의 안내를 완료해야 합니다. Linux npm 설치에는 시스템 라이브러리와 ffmpeg가 필요합니다. macOS 자동 설치는 아직 지원하지 않습니다. macOS에서는 DMG로 설치한 호환 편집기를 실행하고 아래 HTTP 연결을 사용하세요.

2. 에이전트의 MCP 설정에 추가

표준 입출력(stdio) MCP를 지원하는 클라이언트의 설정에 다음 항목을 추가합니다. 설정 파일의 위치와 등록 방법은 클라이언트마다 다릅니다.

{
  "mcpServers": {
    "ugot-videoeditor": {
      "command": "npx",
      "args": ["-y", "ugot-videoeditor-mcp"]
    }
  }
}

첫 연결에서 큰 설치 파일을 기다리지 않도록 1단계 설치를 먼저 완료하세요. 앱과 에이전트 클라이언트는 같은 컴퓨터에서 실행해야 합니다.

3. 프로젝트를 열고 편집 요청

다듬에 영상·이미지·오디오를 가져와 프로젝트를 엽니다. 에이전트에 연결된 편집 도구가 표시되는지 확인하고 작업을 요청한 뒤, 같은 타임라인에서 결과를 검수하세요. 연결한 에이전트와 외부 생성 서비스의 계정·이용 요금은 별도입니다.

CLI에서 연결 상태와 도구 확인하기

아래 명령으로 설치와 연결 상태, 사용할 수 있는 도구 목록을 확인합니다.

ugot-videoeditor status
ugot-videoeditor tools

CLI도 실행 중인 편집기와 같은 프로젝트에 연결됩니다.

기존 HTTP MCP 주소로 연결하기

로컬 HTTP MCP를 지원하는 클라이언트는 실행 중인 앱의 주소를 직접 연결할 수 있습니다. 기본 주소는 다음과 같습니다.

http://127.0.0.1:3000/api/mcp

포트 3000이 사용 중이면 앱의 주소가 달라질 수 있습니다. 호환 앱의 다른 주소에 연결하려면 MCP 실행 환경의 UGOT_VIDEOEDITOR_URL에 서버 주소를 설정하세요. 연결에 실패하면 앱 버전과 로그를 확인해 주세요.

문의하기

버그 신고, 기능 제안, 사용법 질문을 여기서 바로 보냅니다. 접수되면 담당자 화면에 들어가고, 답변은 적어 주신 이메일로 갑니다.

신고할 때 함께 보낼 것

앱 버전(다운로드 페이지의 버전 표기, 예: 0.1.0+mcpfix2)과 운영체제
재현 순서와 기대한 결과·실제 결과
로그 파일: ~/.local/share/uk.ugot.videoeditor/logs/server.log (Linux). 개인 소재 파일명이 들어 있을 수 있으니 확인 후 보내 주세요.

자주 묻는 질문

영상이 재생되지 않아요

mp4(H.264/AAC), webm(VP9/Opus)은 그대로 재생됩니다. 다른 코덱(HEVC, ProRes 등)은 ffmpeg -i 입력 -c:v libx264 -c:a aac 출력.mp4 로 변환해 넣어 주세요.

내보내기가 실패해요

시스템에 ffmpeg 가 있어야 합니다(.deb 설치 시 함께 설치). 실패 로그가 server.log 에 남으니 그 부분을 첨부해 주세요.

MCP 로 연결이 안 돼요

ugot-videoeditor status로 설치·연결 상태를 확인하고 ugot-videoeditor open으로 앱을 여세요. MCP 설정 변경 후에는 클라이언트를 다시 연결해야 할 수 있습니다. HTTP 연결은 앱의 실행 주소를 확인하세요. AI 편집 시작하기에 전체 순서가 있습니다.

내 파일이 서버로 올라가나요?

기본 편집·미리보기·내보내기는 내 컴퓨터에서 처리합니다. 클라우드 에이전트를 연결하면 지시와 도구 응답, 확인을 위해 전달한 프레임 등이 해당 서비스에서 처리될 수 있습니다. 외부 AI 생성 서비스에는 생성을 요청한 텍스트·이미지·영상 소재가 전달됩니다. 자세한 내용은 개인정보 처리방침을 보세요.

에이전트 편집과 AI 생성도 무료인가요?

현재 배포 중인 편집기와 로컬 내보내기는 무료입니다. 연결한 에이전트와 외부 AI 생성 서비스에는 해당 서비스의 계정·인터넷 연결·요금 조건이 적용됩니다.

데이터를 다른 컴퓨터로 옮기고 싶어요

프로젝트 메뉴의 "내보내기" 로 프로젝트 파일(소재 포함)을 만들고, 새 컴퓨터에서 "가져오기" 하면 됩니다.

서비스 상태

기본 편집·미리보기·내보내기는 로컬에서 처리합니다. 로그인, 연결한 에이전트와 AI 생성 서비스는 각 서비스의 연결 상태에 영향을 받습니다. 문제가 생기면 위 문의 폼으로 사용 중인 기능과 증상을 알려 주세요.